Cancel

This request is triggered when a player's bet action fails to complete successfully—due to reasons such as network issues, timeouts, or system errors. In such cases, the request serves to refund the full bet amount back to the player's balance to ensure fairness and maintain account accuracy.

This is an idempotent operation. If the wallet receives more than one request with the same transactionId the transaction must be registered only once in the wallet.

URL	{operatorCallbackURL}
Method	POST
Headers	X-Request-Signature Content-Type Accept
Request Body	{ command: "cancel", transactionId: "215202", playerId: "1101", roundId: "65215842315484512", providerId: 2, providerName: "EGT Digital", gameCode: "FSHBLSlot", gameName: "40 Burning Hot Bell Link", currency: "EUR", amount: 10, timestamp: 1586335186372 }
Response Body	{ balance: 1591.52, statusCode: "OK" }

Request

Parameter	Values	Mandatory	Description
command	string	Y	Indicates the request type.
transactionId	string	Y	Unique reference of the transaction created in our API.
referenceId	string	Y	The transaction id of the bet transaction which should be canceled.
playerId	string	Y	Unique identifier of the player from the operator's system.
roundId	string	Y	Unique reference of the game round.
providerId	number	Y	Unique identifier of the provider in our API.
providerName	string	Y	The name of the provider.
gameCode	string	Y	Unique identifier of the game in our API
gameName	string	Y	The name of the game.
currency	string	Y	Player currency, according to ISO-4217 (EUR, USD ...)
amount	number	Y	Refund amount.
timestamp	number	Y	Timestamp of the request.

Response

Parameter	Values	Mandatory	Description
balance	number	Y	Player balance.
statusCode	string	Y	Status code of the execution.

Possible Status Codes

Status codes	Reason
OK	Request successful
ERR_NOT_AUTHENTICATED	Player is not authenticated
ERR_TRANSACTION_DOES_NOT_EXIST	The referenced transaction is not initiated in operator's system.
ERR_TRANSACTION_ROLLED_BACK	The referenced transaction is already reversed.
ERR_INTEGRITY_CHECK_FAILED	Message integrity check failed.
ERR_UNKNOWN	Internal server error

In case statusCode is different than "OK", the request will be treated as unsuccessful.

A response must be provided within 4 seconds. If the callback request times out or returns a specific error, our API will automatically retry the request up to 2 more times.

Example

Request

{
   command: "cancel",
   transactionId: "SP215202",
   referenceId: "SP215201"
   playerId: "1101",
   roundId: "65215842315484512",
   providerId: 2,
   providerName: "EGT Digital",
   gameCode: "FSHBLSlot",
   gameName: "40 Burning Hot Bell Link",
   currency: "EUR",
   amount: 10,
   timestamp: 1586335186372
}

OK Response

{
    "balance": 19839891,
    "statusCode": "OK"
}

Error Response

{
    "statusCode": "ERR_TRANSFER_DOES_NOT_EXIST",
    "balance": 19839890
}