Wallet (seamless)
Operations export
Optional: listing the wallet's applied operations so the RGS can reconcile them with its journal.
POST {baseURL}/operations lists every debit, credit and rollback the wallet applied in a period. The RGS
compares that list with its own journal, by transactionId, in both directions, and shows the
differences to its operators. It moves no money and changes neither side.
The call is optional. A casino without it is simply not reconciled; nothing else depends on it, and its markets stay open. The export is turned on per casino in the RGS backoffice. How differences are found and handled is in Retries, idempotency and reconciliation.
Request
Signed like every other call, and the response is signed too.
| Field | Required | Type | Meaning |
|---|---|---|---|
from | yes | RFC 3339 date-time | Start of the period, inclusive. Parse full RFC 3339: fractional seconds and offsets. |
to | yes | RFC 3339 date-time | End of the period, exclusive. |
cursor | no | string | The nextCursor of the previous page. Absent on the first page. |
limit | no | integer | Page size, at most 1000; 1000 when left out. Reconciliation sends 1000; the conformance suite sends none. |
{ "from": "2026-11-01T09:00:00Z", "to": "2026-11-01T12:00:00Z", "limit": 1000 }Response
{
"status": "ok",
"nextCursor": "9812",
"operations": [
{
"transactionId": "01a1a0d9-f100-7d2e-8f30-4a5b6c7d8e9f:debit:1",
"type": "debit",
"roundId": "01a1a0d9-f100-7d2e-8f30-4a5b6c7d8e9f",
"playerId": "p-1001",
"currency": "GBP",
"amount": 1000000,
"at": "2026-11-01T10:00:03.123Z"
},
{
"transactionId": "01a1a0d9-f100-7d2e-8f30-4a5b6c7d8e9f:credit",
"type": "credit",
"roundId": "01a1a0d9-f100-7d2e-8f30-4a5b6c7d8e9f",
"playerId": "p-1001",
"currency": "GBP",
"amount": 2500000,
"at": "2026-11-01T10:00:03.410Z"
}
]
}| Field | Meaning |
|---|---|
status | "ok". Anything else fails the run, which the RGS tries again later. |
nextCursor | The cursor of the next page. Empty or absent ends the list. |
operations | At most limit operations. |
Each operation:
| Field | Required | Meaning |
|---|---|---|
transactionId | yes | The id the RGS sent. |
type | yes | debit, credit or rollback. A jackpot credit is a credit. |
roundId | yes | The round. |
playerId | yes | The casino's own player id. |
currency | yes | ISO 4217 code. |
amount | yes | Micro-units. For a rollback, what it returned: 0 for a debit that never arrived. |
targetTransactionId | rollback only | The debit the rollback named. |
at | yes | When the wallet applied it, by the wallet's own clock. |
Rules
- List every operation the wallet applied with
from <= at < to. - Keep the order stable between pages, so that paging neither skips nor repeats an operation.
- A debit that was later rolled back stays listed, beside its rollback.
- A refused call is not an operation: do not list it.
- A repeat answered with
alreadyProcessed: trueis not a new operation. - A rollback of a debit that never arrived may be listed with
amount: 0, or not at all. - Credits of
amount: 0are operations: list them.
How the RGS reads it
- One run covers one period, an hour by default. It asks for the period widened by a margin on each side, an hour by default, so a call covers three hours: the margin absorbs clock differences and credits that took a while to settle. A period runs only once its end plus the margin has passed.
- It reads every page, following
nextCursor, until it is empty. Each page has 30 seconds; redirects are not followed. - Ids that start with
conformance-are left out: they belong to the conformance suite, which may run on a live wallet. - An operation the journal requires and you do not list is reported as missing at the casino; one you list and the journal does not know, as missing in the journal; the same id with another amount or currency, or another player or type, as a difference in amount or in details.