Rollback - Cancel Bet

Cancel or rollback executed transactions, typically used for game cancellations or system exceptions.

Request Parameters

Request Before Decryption

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

info

For encryption details, refer to Operator API Implementation Guide

Request After Decryption

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

Parameter	Type	Required	Description
action	string	Yes	Fixed value "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, a unique value assigned by VP
brand	string	Yes	Brand code, fixed value VP
gameCode	string	Yes	Game Code

Response Format

info

The response is in plaintext JSON and does not need to be encrypted.

Success Response

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

Field	Type	Description
status	string	Status code, see the status code description below
errText	string	Error message, empty string when successful
balance	number	Player's Balance after the rollback
responseTime	string	Response time

Response Status and Transaction Result

Status	Cancellation Result	Whether It Triggers a Retry	Whether the Cancellation Is Valid	Bet Slip Status
0000	Success	No	Valid	Cancelled
9999	Failed	Yes	Invalid	Voided
1006	Failed	Yes	Invalid	Voided
2000	Failed	Yes	Invalid	Voided
2001	Success	No	Valid	Cancelled
2002	Failed	Yes	Invalid	Voided
2003	Success	No	Invalid	Valid
Timeout	Failed	Yes	Invalid	Voided

Important Notes

1. Cancellation Trigger Timing: This API is called to cancel the transaction when the Bet response times out
2. Processing Requirements: Upon receiving this API request, the Operator must cancel the specified Bet and return the updated Balance, or respond confirming that the Bet is valid
3. Retry Mechanism: Retries will continue for up to four hours if no explicit error is received

• For the first hour, retries occur at 1-minute intervals
• For the following three hours, retries occur at 10-minute intervals

4. Status Description:

• Cancelled: The transaction was successfully cancelled and is not included in settlement
• Voided: The transaction status is unclear; it defaults to an unsuccessful transaction and is not included in settlement

5. Parameter Adjustment: transferId will be removed and replaced by betId