Document API mAPP x Woay
===

mAPP_API_URL:

{
    staging: "https://api.stg.mapp.vn/v2"
    production: "https://api.mapp.vn/v2"
}

**1. API trả về thông tin của user ( admin user & mobile user )**

GET /api/game-woay/info-user
> header: woay-token=<token của admin mAPP/ token user cuả mAPP>

`Response`

{
    "status": 200,
    "name": "String", // Tên người dùng
    "role": "String", // user : người dùng mobile / admin : admin web
    "email": "String", // email: Email người dùng
    "phone": "" // phone: sdt người dùng, format 0xxxxxxxxx
}

---

**2. Api tạo coupon cho người chơi ( mobile user )**

POST /api/game-woay/create-user-coupon
> header: woay-token=<token user cuả mAPP>

`Request`

{
    "name": "String", // Required , tên của coupon
    "description": "String || null", // Optional, chi tiết coupon
    "type": "String", // Required, value hoặc percent ứng với giảm theo giá tiền hoặc theo phần trăm,
    "code": "String", // Required, coupon code,
    "value": "20", // Required, giá trị giảm của coupon,
    "from_date": "Datetime || null", // Optional, Thời hạn bắt đầu
    "to_date": "Datetime || null", // Optional, Thời hạn kết thúc
    "min_price_deal": "Number || null", // Optional, Giá trị đơn hàng tối thiểu
    "max_discount": "Number || null"  // Optional, Số tiền giảm tối đa
}

`Response`

*Check status trước khi kiểm tra response, nếu status khác 200 là api sai kết quả*

{
    "status": 200,
    "coupon": "Object" // Thông tin về coupon khách hàng nhận được
}

**3. Api tạo point cho người chơi ( mobile user )**

POST /api/game-woay/create-user-point
> header: woay-token=<token user cuả mAPP>

`Request`

{
    "point": "Number" // Required, số điểm thưởng,
    "expiry_date": "Number" // Optional, ngày hết hạn sử dụng điểm - Nếu như không nhập sẽ lấy theo config của mAPP,
    "game": "vòng quay may mắn" // Optional, tên trò chơi, mặc định là mAPP
}

`Response`

*Check status trước khi kiểm tra response, nếu status khác 200 là api sai kết quả*

{
    "status": 200,
    "point": "Object" // Thông tin điểm thưởng của khách hàng
}

### Luồng tạo đơn hàng game woay và thanh toán hoá đơn ###

1. Api Tạo Đơn Hàng

POST /api/game-woay/create-invoice
> header: woay-token=<token admin của mAPP>

`Request`

{
    "amount": "Number" // Require, số tiền (VND),
    "name": "String" // Require, tên đơn hàng
    "type": "String" // Optional, phương thức thanh toán (Atm, Visa) - mặc định là Atm
}

`Response`

*Check status trước khi kiểm tra response, nếu status khác 200 là api sai kết quả*

{
    "status": 200,
    "invoice": "Object" // Thông tin hoá đơn khách hàng
    "onepayURL": "String" // Đường link dẫn đến trang thanh toán của Onepay
}

Sau khi thanh toán thành công sẽ tự động finalize và trả về kết quả thanh toán và sẽ call qua webhook của Woay

2. Api Kích hoạt đường dẫn game

POST /api/game-woay/upsert-game
> header: woay-token=<token admin của mAPP>

`Request`

{
    "enable": "Boolean" // Require, Kích hoạt hoặc huỷ kích hoạt,
    "name": "String" // Require, tên game
    "url": "String" // Require, đường dẫn tới game
}

> Game Url: 'https://stg.woay.online/w/a9cce251-063c-4b97-9bb4-1f9b79569f5f'

`Response`

*Check status trước khi kiểm tra response, nếu status khác 200 là api sai kết quả*

{
    "status": 200,
    "game": "Object" // Thông tin game đã kích hoạt 
}