跳到主要内容

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
回应格式
- 成功回应
- 响应状态与交易结果
注意事项