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 組合只處理一次交易
- 餘額一致性: 確保重試不會導致重複扣款或加款