Skip to content

支付 ​

接口说明 ​

玩家在游戏内点充值时,由游戏服用 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验签失败
1003time 超出 ±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)