Rollback - Transaction Rollback

Cancel or roll back executed transactions, typically used for game cancellations or system anomalies.

Request Parameters

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

info

For Encryption Description, please refer to [Operator API Implementation Description](./overview.md#1-Security Requirements)

{
  "action": "rollback",
  "uid": "test123",
  "roundId": "AAA123",
  "transferId": "AAA123",
  "brand": "VP",
  "gameCode": "VP_230036_1"
}

Parameter	Type	Required	Description
action	string	Yes	Fixed as "rollback"
uid	string	Yes	Player Account
roundId	string	Yes	Game round number of the original transaction
transferId	string	Yes	Identifier of the original transaction (planned for removal)
betId	string	Yes	Bet ID, unique to VP
brand	string	Yes	Brand code, fixed as VP
gameCode	string	Yes	Game Code

info

Response is plaintext JSON, no encryption required.

{
  "status": "0000",
  "errText": "",
  "balance": 12345.67,
  "responseTime": "2024-12-11T01:23:38.271Z"
}

Field	Type	Description
status	string	Status Code, see Status Code Description below
errText	string	Error message, empty string on Success
balance	number	Player Balance after rollback
responseTime	string	Response time

Status	Cancellation Status Determination	Trigger Retry?	Cancellation Successful?	Bet Status
0000	Success	No	Successful	Cancelled
9999	Failed	Yes	Failed	Voided
1006	Failed	Yes	Failed	Voided
2000	Failed	Yes	Failed	Voided
2001	Success	No	Successful	Cancelled
2002	Failed	Yes	Failed	Voided
2003	Success	No	Failed	Established
Timeout	Failed	Yes	Failed	Voided

Trigger Timing for Transaction Cancellation: When a Bet response times out, this API will be called to cancel the transaction
Processing Requirements: Upon receiving this API request, the specified Bet must be cancelled and the updated Balance returned, or a response indicating the Bet is confirmed as established
Retry Mechanism: If no explicit error is received, retries will continue for four hours

Cancelled: Transaction cancellation Successful, not included in settlement
Voided: Transaction Status unclear, defaults to unsuccessful transaction, not included in settlement