Rollback - 取消下注
取消或回滚已执行的交易，通常用于游戏取消或系统异常情况。
请求参数
解密前 Request
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
信息
加密说明请参考 平台端 API 实作说明
解密后 Request
{
"action": "rollback",
"uid": "test123",
"roundId": "trans123",
"transferId": "trans123",
"betId": "rollback123",
"brand": "VP",
"gameCode": "VP_230036_1"
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 是 | 固定为 "rollback" |
| uid | string | 是 | 玩家账号 |
| roundId | string | 是 | 原始交易的游戏局号 |
| transferId | string | 是 | 原始交易的识别码（预计移除） |
| betId | string | 是 | 投注ID，为VP唯一值 |
| brand | string | 是 | 品牌代码，固定为VP |
| gameCode | string | 是 | 游戏代码 |
回应格式
信息
回应为明文 JSON，不需加密。
成功回应
{
"status": "0000",
"errText": "",
"balance": 12345.67,
"responseTime": "2024-12-11T01:23:38.271Z"
}
| 栏位 | 类型 | 说明 |
|---|---|---|
| status | string | 状态码，见下方状态码说明 |
| errText | string | 错误讯息，成功时为空字串 |
| balance | number | 回滚后的玩家余额 |
| responseTime | string | 回应时间 |
响应状态与交易结果
| 状态 | 判断取消状态 | 是否触发重试 | 取消是否成立 | 注单状态 |
|---|---|---|---|---|
| 0000 | 成功 | 不会 | 成立 | 取消 |
| 9999 | 失败 | 会 | 不成立 | 注销 |
| 1006 | 失败 | 会 | 不成立 | 注销 |
| 2000 | 失败 | 会 | 不成立 | 注销 |
| 2001 | 成功 | 不会 | 成立 | 取消 |
| 2002 | 失败 | 会 | 不成立 | 注销 |
| 2003 | 成功 | 不会 | 不成立 | 成立 |
| 超时 | 失败 | 会 | 不成立 | 注销 |
注意事项
- 取消交易触发时机: 当下注回应超时时，会呼叫该 API 进行取消交易
- 处理要求: 收到该 API 请求时，需取消指定的下注并返回更新后的余额，或回应该下注确定成立
- 重试机制: 未收到明确错误则会持续重试四小时
- 前一小时，每次间隔 1 分钟
- 后三小时，每次间隔 10 分钟
- 状态说明:
- 取消: 交易取消成功，不列入交收
- 注销: 交易状态未明确，预设为不成功交易，不列入交收
- 参数调整 transferId 将移除并由 betId 取代