发货接口
接口说明
平台在充值支付完成后,会回调厂商提供的回调地址,通知订单支付结果,厂商需校验签名并做幂等处理。
请求方式
- Method:
GET - Path:厂商自定义回调地址(例如:
https://cp.example.com/callback/recharge)
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | int64 | 是 | 平台用户唯一 ID(收银台中传递的 uid) |
| appid | string | 是 | 平台游戏唯一 ID(收银台中传递的 appid) |
| sid | string | 是 | 游戏区服 ID(收银台中传递的 sid) |
| amount | int | 是 | 支付金额(分),即实际支付成功金额 |
| oid | string | 是 | 平台订单 ID,平台支付系统唯一订单号 |
| rid | string | 是 | 角色 ID(收银台中传递的 rid) |
| pid | string | 是 | 商品 ID(收银台中传递的 pid) |
| ext | string | 否 | 扩展属性(收银台中传递的 ext) |
| sign | string | 是 | 签名,参与签名(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 | 类型 | 说明 |
|---|---|---|
| 0 | int | 发货成功 |
| 1001 | int | 发货失败(包含签名失败),平台会按重试策略继续通知 |
| 1002 | int | 重复通知(同一订单多次回调),请勿重复发货 |
重试策略
当回调失败(超时、网络异常、或返回非成功状态)时,平台将按策略进行重试,最多重试 8 次。
重试间隔如下(相对于上一次失败):
- 第 1 次:5 秒
- 第 2 次:30 秒
- 第 3 次:5 分钟
- 第 4 次:30 分钟
- 第 5 次:1 小时
- 第 6 次:2 小时
- 第 7 次:4 小时
- 第 8 次:8 小时
说明:达到第 8 次后不再继续重试。建议厂商接口按
oid做幂等处理,避免重复发货。
签名规则
注意
本签名所用密钥为游戏密钥,在CP自接入后台可查看
