Skip to main content
当玩家投注未能完成时(因网络问题、超时或系统错误),会发送 cancel(取消)回调。你的服务器必须将完整投注金额退还至玩家余额,以确保账户准确。该操作为幂等操作——若钱包收到多个带有相同 transactionId 的请求,退款只能登记一次。 无需在回调 URL 末尾添加“Cancel”;您可以获取请求正文“command”来识别哪个回调即将到来。
  • URL: 你配置的 Callback URL(ex: https://mycallback.com/cb)
  • Method: POST
  • Headers: X-Request-Signature, Content-Type, Accept

Request parameters

string
必填
此回调类型始终为 "cancel"
long
必填
本系统中创建的本次取消交易的唯一引用,用于实现幂等。
string
必填
你系统中玩家的唯一标识。
long
必填
游戏局的唯一引用。
number
必填
本系统中游戏提供商的唯一标识。
number
必填
本系统中游戏的唯一游戏 ID。
number
必填
请求的 Unix 时间戳。

Response fields

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

Status codes

你的响应必须在 4 秒内返回。若请求超时或返回错误,我们会自动最多再重试 2 次。
请使用 referenceId 在数据库中定位原始投注。若该投注从未被记录(例如你的系统从未收到过),可安全返回 OK 及玩家当前余额——此时无需退款

Examples