# 服务端回调
服务端回调是海外小游戏平台将订单结果通知给开发者的接口,是由开发者提供的Http接口。
在如下情形下,小游戏平台会触发回调:
- 订单支付成功
- 订单已退款(通常为用户联系Google进行了退款)
注意:游戏开发者需要提供支付回调的 Http 接口,并在开发者平台完成填写。
# 回调接口定义
POST https://demo.gameserver.com/ksgame/pay/order/notify
注意:以上api path为接口参考,具体接口由开发者提供
Content-Type: application/json
Body
属性 | 类型 | 说明 | 是否参与签名 |
---|---|---|---|
open_id | string | 用户唯一标识,login时获得 | 是 |
app_id | string | 应用appId | 是 |
third_party_trade_no | string | 游戏开发者下单时填写的订单号 | 是 |
kwai_game_trade_no | string | 快手海外平台支付订单号 | 是 |
buy_quantity | int | 下单时传入的购买数量 | 是 |
extension | string | 游戏开发者下单时传递的扩展字段 | 下单时有值参与签名,否则不参与 |
order_status | int | 订单状态,1:支付成功,3:已退款 | 是 |
sign | string | HMAC-SHA256 签名 签名规则 | 否 |
Response
接口返回字符串 success
或者 failed
即可。
# 签名密钥
签名密钥默认与下单密钥为同一个,如需配置不同密钥,可联系快手海外小游戏平台的运营人员。
# 签名规则
签名逻辑与下单类似,将所有参数按照字母顺序排序,并按照 key1=value&key2=value2... 的格式拼接得到签名字符串,对密钥使用 HMAC-SHA256 加密算法,得到签名。详见签名文档。