# 服务端回调

服务端回调是海外小游戏平台将订单结果通知给开发者的接口,是由开发者提供的Http接口。

在如下情形下,小游戏平台会触发回调:

  1. 订单支付成功
  2. 订单已退款(通常为用户联系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 加密算法,得到签名。详见签名文档