# 页游充值

web页游接入GTarcade平台时，需接入充值模块。<br>

如游戏方希望接入直购功能，即在游戏内支付商品时直接跳转GTarcade充值页面，接入方需提供查询参数，具体可参考直购礼包模块。

<br>



## 充值调试

如果您需要调试充值，请申请白名单，具体流程参考[充值调试](/zh/docs/GT/test/充值沙盒.md)

<br>



### 支付提交

**简要描述：**

- 提交订单

**请求URL：**

- `https://pay.gtarcade.com/client/order/submit`
- qa: `http://qapay.gtarcade.com/client/order/submit`

**请求方式：**

- post

**请求头：**

- Origin: client.gtarcade.com
- Cookie: Gta用户登录cookie 例：

```code
  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  | 游戏透传参数，由游戏设定              |

请求参数示例：

```code
{    "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 例：

```code
  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  | 礼包名, 兼容老版本，新版不允许使用    |

请求参数示例：

```code
{    "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  | 返回数据. 订单详情               |



### 直购礼包

> 微端提供的直购礼包功能，用现金或者G币直接购买游戏内配置好的道具礼包

**通信方式：** 游戏向微端请求（TCP）

**加密方式：** AES 

**数据格式：** JSON 

**参数内容：**

**直购功能需要调起GTarcade平台充值页面，调起时游戏接入方需提供以下参数**

| 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  | 商品信息                          |



**方式 1**：由官方人员在微端后台做配置，需游戏方提前提供参数配置表，请参考<a href="https://youzu.feishu.cn/sheets/shtcnkZW5OzdN2yqzq0y8sHMnjb" target="_blank">《游戏接入-基积分商城素材》</a>。

| 参数名      | 必选 | 类型 | 说明                                           |
| ----------- | ---- | ---- | ---------------------------------------------- |
| gta_id      | 是   | Str  | 每次启动 gta 的唯一 ID                         |
| client_id   | 是   | Str  | 每一个游戏分配的通信 ID                        |
| msg_id      | 是   | Str  | 本地通信的消息 ID，用于分辨每次通信接口,写死13 |
| money       | 是   | Str  | 商品价格                                       |
| goods_id    | 是   | Str  | 商 品 ID                                       |
| role_id     | 是   | Str  | 角 色 id                                       |
| role_name   | 否   | Str  | 角色名称                                       |
| goods_name  | 是   | Str  | 商品名                                         |
| server_name | 是   | Str  | 游戏服名称                                     |
| currency    | 是   | Str  | 货币标识，默认是’USD’                          |
| extra       | 是   | Str  | 充值传递的扩展参数                             |

**方式 2**：游戏自己做直购礼包管理平台，研发维护

| 参数名        | 必选 | 类型 | 说明                                           |
| ------------- | ---- | ---- | ---------------------------------------------- |
| gta_id        | 是   | Str  | 每次启动 gta 的唯一 ID                         |
| client_id     | 是   | Str  | 每一个游戏分配的通信 ID                        |
| msg_id        | 是   | Str  | 本地通信的消息 ID，用于分辨每次通信接口,写死13 |
| money         | 是   | Str  | 商品价格                                       |
| goods_id      | 是   | Str  | 商 品 ID，固定为 1                             |
| role_id       | 是   | Str  | 角 色 id                                       |
| role_name     | 否   | Str  | 角色名称                                       |
| goods_name    | 是   | Str  | 商品名                                         |
| server_name   | 是   | Str  | 游戏服名称                                     |
| currency      | 是   | Str  | 货币标识，默认是’USD’                          |
| effectiveTime | 是   | Str  | 有效时间，不校验                               |
| account       | 是   | Str  | 账号                                           |
| timestamp     | 是   | Str  | 时间戳                                         |
| game_id       | 是   | Str  | 游 戏 id                                       |
| server_id     | 是   | Str  | 服务器 id                                      |
| gift_id       | 是   | Str  | 礼 包 id                                       |
| activity_id   | 是   | Str  | 活动 id                                        |
| extra         | 是   | Str  | 充值传递的扩展参数                             |