Skip to main content
当玩家赢得一局时会发送 win 回调。你的服务器必须将中奖金额记入玩家余额,并返回更新后的余额。该操作是幂等的——若钱包收到多个带有相同 transactionId 的请求,该交易只能登记一次。 无需在回调 URL 末尾添加“Win”;您可以获取请求正文“command”来识别哪个回调即将到来。
  • URL: 你配置的 Callback URL(ex: https://mycallback.com/cb)
  • Method: POST
  • Headers: X-Request-Signature, Content-Type, Accept

Request parameters

string
必填
此回调类型固定为 "win"
long
必填
我方系统中创建的交易唯一引用。用于保证幂等性
string
必填
你方系统中的玩家唯一标识
long
必填
游戏局次的唯一引用
number
必填
我方系统中游戏提供商的唯一标识
number
必填
我方系统中该游戏的唯一 game id
number
必填
需记入玩家余额的中奖金额
boolean
必填
表示此赢款后该局是否已结束。若为 true,本局不会再发送后续 win 回调;若为 false,之后可能还有额外的 win 回调
long
必填
0:无奖金;否则为相关奖金 id
number
必填
请求的 Unix 时间戳

Response fields

你的服务器必须以 HTTP 200 响应,且 JSON 正文包含以下字段:
number
必填
记入中奖金额后玩家的最新余额
string
必填
操作结果。成功时必须为 "OK"。所有可能取值见下方状态码表

Status codes

你的响应必须在 4 秒 内返回。若请求超时或返回错误,我们会自动再重试最多 2 次

Examples