Skip to content
Wallet integration / rollback
Wallet integration

rollback

POST

{wallet_url}

Undo the movement named in reference_transaction_id: return a bet, take back a win. Rollbacks may arrive after the session closed.

SignedSandboxProductionaction: rollbackWe call youMOVES MONEYIDEMPOTENTRETRYABLE
Request · we send
{
  "action": "rollback",
  "transaction_id": "pragmatic:5501934:rollback",
  "reference_transaction_id": "pragmatic:5501934",
  "session_id": "2222aaaa-…",
  "round_id": "7200311",
  "player_id": "p-1",
  "game_id": "vs20fruitsw",
  "currency": "EUR",
  "amount": "1.50"
}
Response 200 · you answer
{ "balance": "100.00", "transaction_id": "op-4473" }
CaseAnswerResulting balance
The bet was debited200 with the new balancebalance + bet
Same rollback again200 with the first answerunchanged
A win you credited200 with the new balance: take the win backbalance − win
You never saw the movement200 with the current balance; remember the id as cancelledunchanged
That movement arrives after its rollback4xx: refuse itunchanged

Two kinds reach you. A provider cancelling a movement your wallet settled: reference_transaction_id names the bet or, now and then, the win being cancelled; undo whichever it is. A provider rollback of a bet that never settled with you (refused, failed or never sent) does not reach you as a rollback: we settle it ourselves and ask your wallet for the balance with a getbalance.

Our own rollback after your wallet stayed silent on a bet or a win. It carries "<transaction_id>:rollback" as its id and the silent movement as reference_transaction_id, so it may name a movement that never reached you. Its amount is the silent movement's, written in the currency's precision ("1.50"), and a movement of a free-spin series keeps its free_spins_id. For a silent win, it undoes the credit: take the amount back if you credited it.