跳至主要内容

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	是	原始交易的識別碼
brand	string	是	品牌代碼
gameCode	string	是	遊戲代碼

回應格式

資訊

回應為明文 JSON，不需加密。

成功回應

{
  status: '0000',
  errText: '',
  balance: 1000.50,
  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 分鐘

狀態說明:

取消: 交易取消成功，不列入交收
註銷: 交易狀態未明確，預設為不成功交易，不列入交收

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