跳至主要内容

Rollback - 交易回滾

取消或回滾已執行的交易，通常用於遊戲取消或系統異常情況。

請求參數

解密前 Request

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..." 
}

資訊

加密說明請參考平台端 API 實作說明

解密後 Request

{
  "action": "rollback",
  "uid": "test123",
  "roundId": "AAA123",
  "transferId": "AAA123",
  "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 取代

請求參數
- 解密前 Request
- 解密後 Request
回應格式
- 成功回應
- 響應狀態與交易結果
注意事項