Skip to content

发货接口

接口说明

平台在充值支付完成后,会回调厂商提供的回调地址,通知订单支付结果,厂商需校验签名并做幂等处理。

请求方式

  • Method:GET
  • Path:厂商自定义回调地址(例如:https://cp.example.com/callback/recharge

参数说明

参数名类型必填说明
uidint64平台用户唯一 ID(收银台中传递的 uid
appidstring平台游戏唯一 ID(收银台中传递的 appid
sidstring游戏区服 ID(收银台中传递的 sid
amountint支付金额(分),即实际支付成功金额
oidstring平台订单 ID,平台支付系统唯一订单号
ridstring角色 ID(收银台中传递的 rid
pidstring商品 ID(收银台中传递的 pid
extstring扩展属性(收银台中传递的 ext
signstring签名,参与签名(uid, appid, sid, amount, oid, rid, pid, ext),详见签名规则

回调示例
https://cp.example.com/callback/recharge?uid=20000000&appid=ki10000&sid=s1&amount=100&oid=683574324261208064&rid=1000&pid=1000&ext=&sign=656ee8acd6af994039e1483f1cffcd19158d002d8a55e37fd0486d65b5cf22a7

接入说明

厂商完成接入后,在自接入后台填写支付回调地址。
若地址可被公网访问,可直接点击“测试”进行连通性验证。
登录接入图

返回值

厂商需返回:

json
{ "code": 0, "message": "success" }

平台通过 HTTP 状态码与响应体 code 判断回调是否成功,失败会触发重试。

code类型说明
0int发货成功
1001int发货失败(包含签名失败),平台会按重试策略继续通知
1002int重复通知(同一订单多次回调),请勿重复发货

重试策略

当回调失败(超时、网络异常、或返回非成功状态)时,平台将按策略进行重试,最多重试 8 次。
重试间隔如下(相对于上一次失败):

  • 第 1 次:5 秒
  • 第 2 次:30 秒
  • 第 3 次:5 分钟
  • 第 4 次:30 分钟
  • 第 5 次:1 小时
  • 第 6 次:2 小时
  • 第 7 次:4 小时
  • 第 8 次:8 小时

说明:达到第 8 次后不再继续重试。建议厂商接口按 oid 做幂等处理,避免重复发货。

签名规则

注意

本签名所用密钥为游戏密钥,在CP自接入后台可查看

厂商AppSerret