Appearance
支付
接口说明
玩家在游戏内点充值时,由游戏服用 pay_key 签好单,再让客户端打开 KeepSDK 支付。付完款不会打你的支付页,KeepSDK 会 POST 你的 发货地址。
请求方式
- Method:
GET - 地址:
https://api.keepsdk.com/pay。页游用KeepSDK.pay打开;端游把同一套字段做成 JSON 交给KeepSDK_Pay。签的是同一套键
参数说明
URL(或 JSON)里出现的键除 sign 外全部进签名。中文先按原文算签,再 urlencode。详见 签名。
| 参数 | 必填 | 说明 |
|---|---|---|
app_id | 是 | 游戏 app_id |
uid | 是 | 从登录会话取 |
amount | 是 | 金额,分,整数 ≥ 1。8 元传 800 |
product_id | 是 | 商品 ID |
server_id | 是 | 区服 |
role_id | 是 | 角色 ID |
time | 是 | 10 位 Unix 秒 |
product_name | 是 | 商品名。中文签原文 |
role_name | 是 | 角色名 |
cp_order_id | 是 | 游戏订单号。同一号幂等,发货原样带回 |
product_logo | 否 | 商品图 URL。有则进签,没有就省略,不要传空串 |
ext | 否 | 透传,发货原样回 |
sign | 是 | 签名,pay_key |
响应
页游 iframe 拉起支付页,不读这段 JSON。H5 由脚本拿回包:
| code | 本接口 |
|---|---|
0 | 下单成功,拿 pay_url 等去拉起 |
1001 | 缺参 |
1002 | 验签失败 |
1003 | time 超出 ±300 秒 |
码表见 错误码。
接入说明
页游
引入 keepsdk-web.js(进服就要有),游戏服签好后:
js
KeepSDK.pay({ /* 与上表同一套字段,含 sign */ })H5
游戏服签好后交给 keepsdk-h5.js 的 pay,脚本向网关拉起支付。
端游
不要把完整 URL 交给 KeepSDK_Pay。游戏服把字段做成 JSON(会话里已有的 app_id / uid 等可省略,dll 会补,但 sign 必须覆盖最终会出现的字段)。不要签 code。客户端接口见 客户端 SDK。
text
KeepSDK_Pay(json)