RetryBet - 下注重试
当道具与平台卡下注操作因网路问题或系统异常导致超时或失敗时，VP 平台会调用此 API 进行下注重试，确保交易的一致性。
请求参数
解密前 Request
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
信息
加密说明请参考 平台端 API 实作说明
解密前 Request
{
"action": "retryBet",
"uid": "testaccount01",
"roundId": "testroundId001",
"transferId": "testroundId001",
"brand": "VP",
"currency": "THB",
"gameCode": "VP_230001_1",
"betTime": "2025-11-17T16:01:13.155Z",
"txTime": "2025-11-17T16:01:13.155Z",
"gameInfo": "{\"featureBuy\":0,\"spinID\":[\"7634278403511200000\",\"7634278403512200000\",\"7634278403513700000\"],\"cardType\":1,\"isFeatureGame\":\"\",\"deviceType\":0}",
"actualBetAmt": 0,
"validBetAmt": 0,
"winAmt": 1.3,
"jackpotWin": 0,
"jackpotContribute": 0,
"betType": 2,
"betSourceId": 1
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 是 | 固定为 "retryBet" |
| uid | string | 是 | 会员账号 |
| roundId | string | 是 | 游戏局号，用于識别特定游戏回合 |
| transferId | string | 是 | 交易唯一識别码 |
| brand | string | 是 | 品牌代码 |
| currency | string | 是 | 币别代码 |
| gameCode | string | 是 | 游戏代码，由平台提供 |
| betTime | string | 是 | 下注时间 |
| txTime | string | 是 | 交易时间 |
| gameInfo | string | 是 | 游戏相关资讯的 JSON 字串 |
| actualBetAmt | number | 是 | 实际下注金额 |
| validBetAmt | number | 是 | 有效投注金额（用于流水计算） |
| winAmt | number | 是 | 贏得金额，可为 0 或正数 |
| jackpotWin | number | 是 | 彩池贏得金额，通常为 0 |
| jackpotContribute | number | 是 | 彩池貢獻金额，通常为 0 |
| betType | number | 是 | 投注类型代码 |
| betSourceId | number | 是 | 交易来源代码 |
回应格式
成功回应
{
"status": "0000",
"errText": "",
"balance": 16.00,
"responseTime": "2025-11-11T01:23:38.271Z"
}
| 欄位 | 类型 | 说明 |
|---|---|---|
| status | string | 状态码，見下方状态码说明 |
| errText | string | 错误讯息，成功时为空字串 |
| balance | number | 操作后的会员余额 |
| responseTime | string | 回应时间 |
响应状态与交易结果
| 状态码 | 判断 | 是否觸发重试 | 注单状态 |
|---|---|---|---|
| 0000 | 成功 | 否 | 成立 |
| 2001 | 成功 | 否 | 成立 |
| 9999 | 失敗 | 是 | 待重试 |
| 超时 | 失敗 | 是 | 待重试 |
注意事项
- 觸发时机: 道具与平台卡之交易回应超时或错误时，会透过该 API 呼叫重试
- 交易来源: 交易来源代码可参考附录
- 重试策略: 未收到成功则会持续重试
- 重试頻率: 每半小时重试一次，每次重试 5 次，每次重试之间都会使用退比指数值政策重试，(1s, 3s, 5s, 7s, 9s)
- 重试时長: 最多 7 天，若 7 天皆无收到成功回应则停止重试
- 冪等性: 必须确保相同的 roundId + transferId 组合只处理一次交易
- 余额一致性: 确保重试不会导致重复扣款或加款