Rollback – Transaction Rollback

Rolls back a transaction that occurred in a round.

POST /v1/rollback

Headers: X-HMAC-Signature, Authorization, X-Request-ID

Request

Request Parameters

Field	Required/Optional	Data Type	Description
playerId	Required	string	Unique identifier for the player.
provider	Required	string	Identifier for the game provider.
game	Required	string	Identifier for the game being launched.
transactionId	Required	string	Unique identifier for the transaction to rollback.
roundId	Required	string	Unique identifier for the round to rollback.

Request Example

JSON

{
  "playerId": "44-12345-67890",
  "provider": "gameprovider",
  "game": "fantasyquest",
  "transactionId": "guid/uuid/string",
  "roundId": "guid/uuid/string"
}

Response

Response Parameters

Field	Required/Optional	Data Type	Description
balance	Required	decimal	Current balance of the player, in player’s currency.
freeGameInfo	Optional	array	List of free games available to the player for this game.

Response Example

JSON

{
  "balance": 1500.50,
  "freeGameInfo": [
    {
      "instanceId": 1,
      "offerId": 99,
      "offerName": "Sample Free Spins",
      "instanceInfo": {
        "canBeRejected": false,
        "nearestCostPerBet": 5,
        "numberOfRoundsRemaining": 3,
        "numberOfRoundsAwarded": 10,
        "instanceStartDateUtc": "2025-05-23T11:54:37Z",
        "instanceEndDateUtc": "2025-05-25T13:34:37Z"
      }
    }
  ]
}