Rollback - Transaction Rollback

Cancel or roll back an executed transaction. This is typically used in scenarios such as game cancellation or system exceptions.

Request Parameters

Request Body Before Decryption

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

info

For the decryption algorithm, please refer to the Operator API Implementation Description

Request Body After Decryption

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

參數	Type	Required	Description
action	string	Yes	fix to "rollback"
uid	string	Yes	Player Account
roundId	string	Yes	Game round id
transferId	string	Yes	Unique Transaction Identifier
brand	string	Yes	Game Brand
gameCode	string	Yes	Game Code

Response Format

info

The response is returned as plaintext JSON and does not require encryption.

Success response

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

Field	Type	Description
status	string	Transaction status
errText	string	Error message; empty string on success
balance	number	Current available balance
responseTime	string	Response time

Transaction status and Transaction Results

Status	Rollback Status	Trigger Retry	Transaction Valid	TransactionStatus
0000	Success	No	Yes	Rollback
9999	Failed	Yes	No	Rejected
1006	Failed	Yes	No	Rejected
2000	Failed	Yes	No	Rejected
2001	Success	No	Yes	Rollback
2002	Failed	Yes	No	Rejected
2003	Success	No	No	Settled
Time Out	Failed	Yes	No	Rejected

Important Notes

1. Cancel Trigger: When a bet response times out, this API will be called to cancel the transaction.
2. Processing Requirement: Upon receiving this API request, the system must cancel the specified bet and return the updated balance, or respond that the bet has been successfully confirmed.
3. Retry Mechanism: If no explicit error is received, retries will continue for up to four hours.
   • During the first hour, retries occur at 1-minute intervals.
   • During the following three hours, retries occur at 10-minute intervals.
4. Status Description:
   • Rollback: The transaction is successfully canceled and will not be included in settlement.
   • Rejected: The transaction status is unclear and is treated as an unsuccessful transaction by default; it will not be included in settlement.