# 充值模块
本文档为游戏方接入微端充值模块提供指引，接入成功后，玩家可在微端内直接购买游戏礼包和道具。
## 接入前准备
**（一）游戏接入方需提前配置好充值档位和商品信息：**
1. 配置官网充值档位请联系 陈祺旸
2. 配置微端充值档位请联系 李敏
Notice:测试期间可以只配1-2个，但是在充值调试和正式上线前，请务必配置齐所有商品信息。
**（二）开通充值调试白名单**
接入微端充值，需要游戏方自行调试充值功能。请调试之前预先申请白名单，具体流程请参考[充值调试](/zh/docs/GT/test/充值沙盒.md)
**（三）充值返利接入**
充值返利接入流程与普通充值相同，但相关配置表请参考《充值返利配置表》。
## 后端接入
### 支付提交
**简要描述：**
- 提交订单
**请求URL：**
- `https://pay.gtarcade.com/client/order/submit`
- qa: `http://qapay.gtarcade.com/client/order/submit`
**请求方式：**
- post
**请求头：**
- Origin: client.gtarcade.com
- Cookie: Gta用户登录cookie 例：
```
uuid=ijEgtHdQ(0Y*5Nc5nTrp(rM^3GGJX5@R; device_id=518ca4ced82cd1e15015fc6821f85905; _ga=GA1.2.20783729.1562150546; uuid_do=Gh%reV@)EOm%i37IXdYC)*SnpBOJ4Zf!; lang=en-us; refererUrl=; gdpr_version=v0.0.1; testCookie=yes; ; _csrf=553b526ae8e5729f98a9bad53ffaa4630bbaad1df5353d02ca7738f87dfae9f7a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2248Z4ApXzOBjFTdy2Nw3inR0NQTIfS5ZS%22%3B%7D; uuzu_getGdprInfo=true; PHPSESSID=ht7ms9egdgbtv4k42gju53hi13; login_email=paytest%40gtarcade.com; uuzu_UNICKNAME=paytest; uuzu_account=cGF5dGVzdEBndGFyY2FkZS5jb20%3D; show_email_tips=1; uuzu_UAUTH=Vj1dbFFvUmZQOFZfD1NXNFR3BzAAVQtOVz0CdlIjBzoCZFxhADVSPFNlVEAKR1Y0DT4EEFoBDX8HNFRDB0ECP1Y1XUpRR1J4UFxWNw9CV2tUWQcHADgLaVdiAmJSZgdpAiNcYgA7Um9TZ1RqCmRWPA05BBBaEQ0wBzRUQQdVAitWNV1MUTxSPFAjVmkPZVdzVHcHCwBhC2xXZwI5UjgHCwJsXHwAbVJMU1JURgp7Vk8NHgQwWi8NSwcqVFcHNgIfViZdMFE8UidQaVZkD3dXdFRcBzgAYgtkV2kCPlIJByACbFxhADVSPFNLVFMKVFYyDRUEE1oODXwHHlR8B1YCY1YcXXpRPFI8UCNWZA9nV2NUbAchAGMLd1c9AjNSEQcSAjBcaAAXUldTfFRjCkRWQw00BDNaEA1DBylUXwcxAhdWOl1XUVJSNFBvVmcPNlcwVD4HcgB9C2JXcwIjUiEHOwJ3XGgAbVJPU0JUXgo0VkwNMAQaWmYNSwcEVEgHagIfVjtdT1FqUltQUVZMDzRXWVRXBwUAOQtNV2oCOFI8Bw4CQVxNAGNSTFNSVEUKaFZODR0EAlogDUgHOlRuB24CHlYFXW5RMFJPUEJWXA83V01UUgdpADALJVdhAjRSPwcwAjhcKgA0UnRTdFRmCnVWaA01BDlaag1IBzpUUwc2AhxWO11MUXZSTFBEVjgPOQ%3D%3D
```
**参数：**
| 参数名 | 必选 | 类型 | 说明 |
| :---------- | :--- | :--- | :-------------------------------------------------------- |
| money | 是 | str | 商品价格 |
| account | 是 | str | 用户account，默认cookie，fb一定注意存入fb账号 |
| manner_id | 是 | str | manner_id, 充值页面选择的支付方式 |
| goods_id | 是 | str | goods_id， 商品ID |
| game_id | 是 | str | game_id，游戏ID |
| server_id | 是 | str | server_id，游戏服ID |
| role_id | 是 | str | role_id，角色ID，手游必传 |
| currency | 是 | str | 货币标识，默认是’USD’ |
| op_id | 是 | str | 运营商ID，默认是’590’ |
| manner_name | 否 | str | 充值方式名称，加快速度 |
| goods_name | 否 | str | 商品名称，加快速度 |
| game_name | 否 | str | 游戏名称，加快速度 |
| server_name | 否 | str | 游戏服名称，加快速度 |
| extra | 否 | obj | 兼容字段，流程中前置访问info接口返回extra字段，请原样传回 |
| role_name | 否 | str | 游戏角色名称，加快速度 |
| refer | 否 | int | g币打点来源 |
| 参数名 | 必选 | 类型 | 说明 |
| :---------------- | :--- | :--- | :------------------------------------ |
| —-extra兼容部分—- | | | extra可能包含下列参数，请原样传回 |
| orderId | 否 | str | sdk订单号, 兼容老版本，新版不允许使用 |
| gift_id | 否 | str | 礼包ID, 兼容老版本，新版不允许使用 |
| activity_id | 否 | str | 活动ID, 兼容老版本，新版不允许使用 |
| effectiveTime | 否 | str | 有效时间, 兼容老版本，新版不允许使用 |
| pack_name | 否 | str | 礼包名, 兼容老版本，新版不允许使用 |
| extra | 否 | str | 游戏透传参数，由游戏设定 |
请求参数示例：
```
{ "money": 1.99, "account": "b0@live.cn", "goods_id": 532, "game_id": 346, "server_id": "2625310001", "currency": "USD", "op_id": 590, "goods_name": "Silver Privileges", "goods_icon": "https://upload.gtarcade.com/user_pic/2017/06/item_1498446974_7098.png", "goods_amount": 100, "game_name": "LOA-Paradise Land", "server_name": "HKT - 579", "role_name": "Renata Cote", "manner_id": 39, "manner_name": "PayPal"}
```
**返回参数说明**
| 参数名 | 类型 | 说明 |
| :----- | :----- | :------------------------------- |
| status | string | 请求状态码 0:success, 其它为错误 |
| msg | string | 请求结果描述 |
| data | array | 返回数据. url 支付地址 |
### 支付查询
**简要描述：**
- 手游直冲查询/手页游直购礼包查询
**请求URL：**
- `https://pay.gtarcade.com/client/order/third-info`
- qa: `http://qapay.gtarcade.com/client/order/third-info`
**请求方式：**
- post
**请求头：**
- Origin: client.gtarcade.com
- Cookie: Gta用户登录cookie 例：
```
uuid=ijEgtHdQ(0Y*5Nc5nTrp(rM^3GGJX5@R; device_id=518ca4ced82cd1e15015fc6821f85905; _ga=GA1.2.20783729.1562150546; uuid_do=Gh%reV@)EOm%i37IXdYC)*SnpBOJ4Zf!; lang=en-us; refererUrl=; gdpr_version=v0.0.1; testCookie=yes; ; _csrf=553b526ae8e5729f98a9bad53ffaa4630bbaad1df5353d02ca7738f87dfae9f7a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2248Z4ApXzOBjFTdy2Nw3inR0NQTIfS5ZS%22%3B%7D; uuzu_getGdprInfo=true; PHPSESSID=ht7ms9egdgbtv4k42gju53hi13; login_email=paytest%40gtarcade.com; uuzu_UNICKNAME=paytest; uuzu_account=cGF5dGVzdEBndGFyY2FkZS5jb20%3D; show_email_tips=1; uuzu_UAUTH=Vj1dbFFvUmZQOFZfD1NXNFR3BzAAVQtOVz0CdlIjBzoCZFxhADVSPFNlVEAKR1Y0DT4EEFoBDX8HNFRDB0ECP1Y1XUpRR1J4UFxWNw9CV2tUWQcHADgLaVdiAmJSZgdpAiNcYgA7Um9TZ1RqCmRWPA05BBBaEQ0wBzRUQQdVAitWNV1MUTxSPFAjVmkPZVdzVHcHCwBhC2xXZwI5UjgHCwJsXHwAbVJMU1JURgp7Vk8NHgQwWi8NSwcqVFcHNgIfViZdMFE8UidQaVZkD3dXdFRcBzgAYgtkV2kCPlIJByACbFxhADVSPFNLVFMKVFYyDRUEE1oODXwHHlR8B1YCY1YcXXpRPFI8UCNWZA9nV2NUbAchAGMLd1c9AjNSEQcSAjBcaAAXUldTfFRjCkRWQw00BDNaEA1DBylUXwcxAhdWOl1XUVJSNFBvVmcPNlcwVD4HcgB9C2JXcwIjUiEHOwJ3XGgAbVJPU0JUXgo0VkwNMAQaWmYNSwcEVEgHagIfVjtdT1FqUltQUVZMDzRXWVRXBwUAOQtNV2oCOFI8Bw4CQVxNAGNSTFNSVEUKaFZODR0EAlogDUgHOlRuB24CHlYFXW5RMFJPUEJWXA83V01UUgdpADALJVdhAjRSPwcwAjhcKgA0UnRTdFRmCnVWaA01BDlaag1IBzpUUwc2AhxWO11MUXZSTFBEVjgPOQ%3D%3D
```
**参数：**
| 参数名 | 必选 | 类型 | 说明 |
| :----------- | :--- | :--- | :-------------------------------- |
| money | 是 | str | 商品价格 |
| account | 是 | str | 用户account，fb一定注意存入fb账号 |
| goods_id | 是 | str | goods_id， 商品ID |
| game_id | 是 | str | game_id，游戏ID |
| server_id | 是 | str | server_id，游戏服ID |
| role_id | 是 | str | role_id，角色ID，手游必传 |
| currency | 是 | str | 货币标识，默认是’USD’ |
| op_id | 是 | str | 运营商ID，默认是’590’ |
| goods_name | 否 | str | 商品名称，加快速度 |
| goods_icon | 否 | str | 商品图标，加快速度 |
| goods_amount | 否 | str | 商品数量，加快速度 |
| game_name | 否 | str | 游戏名称，加快速度 |
| server_name | 否 | str | 游戏服名称，加快速度 |
| role_name | 否 | str | 游戏角色名称，加快速度 |
| extra | 否 | str | 其他信息，不实际处理 |
| goods_info | 否 | str | 商品信息 |
| 参数名 | 必选 | 类型 | 说明 |
| :------------ | :--- | :--- | :------------------------------------ |
| —-兼容部分—- | | | |
| orderId | 否 | str | sdk订单号, 兼容老版本，新版不允许使用 |
| gift_id | 否 | str | 礼包ID, 兼容老版本，新版不允许使用 |
| activity_id | 否 | str | 活动ID, 兼容老版本，新版不允许使用 |
| effectiveTime | 否 | str | 有效时间, 兼容老版本，新版不允许使用 |
| pack_name | 否 | str | 礼包名, 兼容老版本，新版不允许使用 |
请求参数示例：
```
{ "op_id": "2728", "server_id": "1308440002", "game_id": "182", "goods_id": "diamond100", "money": "0.99", "goods_name": "Diamond100", "server_name": "huodong", "currency": "USD", "role_id": "563073476@qq.com", "account": "563073476@qq.com"}
```
**返回参数说明**
| 参数名 | 类型 | 说明 |
| :----- | :----- | :------------------------------- |
| status | string | 请求状态码 0:success, 其它为错误 |
| msg | string | 请求结果描述 |
| data | array | 返回数据. 订单详情 |
## 前端接入
微端平台为游戏方提供游戏内调起充值窗口接口，方便玩家在游戏内调起相应支付页面。
游戏方可选择两种调起充值窗口的方式：
方式一：游戏内放置充值按钮，玩家点击后打开微端充值页面，在充值页面内选择相应的礼包或道具，完成充值。
方式二：游戏内直接放置商品，玩家选择商品后，调起该商品的充值窗口，完成充值。
### 方式一：充值窗口
> 在游戏内，支持调起微端的充值窗口，让用户选择礼包并充值。
**通信方式：** 游戏向微端请求（TCP）
**加密方式：** AES
**数据格式：** JSON
**参数内容：**
| 参数名 | 必选 | 类型 | 说明 |
| :-------- | :--- | :--- | :-------------------------------------------- |
| gta_id | 是 | Str | 每次启动 gta 的唯一 ID |
| client_id | 是 | Str | 每一个游戏分配的通信 ID |
| msg_id | 是 | Str | 本地通信的消息 ID，用于分辨每次通信接口,写死3 |
| role_id | 否 | Str | 角色id |
### 方式二：礼包充值窗口
> 游戏方接入后，可在游戏内直接调起某一礼包的充值窗口。
**通信方式：** 游戏向微端请求（TCP）
**加密方式：** AES
**数据格式：** JSON
**参数内容：**
以下参数来自游戏方提供的参数配置表，由官方人员在后台做配置，请参考接入前准备一。
| 参数名 | 必选 | 类型 | 说明 |
| :---------- | :--- | :--- | :--------------------------------------------- |
| gta_id | 是 | Str | 每次启动 gta 的唯一 ID |
| client_id | 是 | Str | 每一个游戏分配的通信 ID |
| msg_id | 是 | Str | 本地通信的消息 ID，用于分辨每次通信接口,写死13 |
| game_id | 是 | Str | 游 戏 id |
| server_id | 是 | Str | 服务器 id |
| money | 是 | Str | 商品价格 |
| goods_id | 是 | Str | 商 品 ID |
| role_id | 是 | Str | 角 色 id |
| role_name | 否 | Str | 角色名称 |
| goods_name | 是 | Str | 商品名 |
| server_name | 是 | Str | 游戏服名称 |
| currency | 是 | Str | 货币标识，默认是’USD’ |
| extra | 是 | Str | 充值传递的扩展参数 |