JRGS Casino API
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.

FieldRequiredTypeMeaning
fromyesRFC 3339 date-timeStart of the period, inclusive. Parse full RFC 3339: fractional seconds and offsets.
toyesRFC 3339 date-timeEnd of the period, exclusive.
cursornostringThe nextCursor of the previous page. Absent on the first page.
limitnointegerPage 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"
    }
  ]
}
FieldMeaning
status"ok". Anything else fails the run, which the RGS tries again later.
nextCursorThe cursor of the next page. Empty or absent ends the list.
operationsAt most limit operations.

Each operation:

FieldRequiredMeaning
transactionIdyesThe id the RGS sent.
typeyesdebit, credit or rollback. A jackpot credit is a credit.
roundIdyesThe round.
playerIdyesThe casino's own player id.
currencyyesISO 4217 code.
amountyesMicro-units. For a rollback, what it returned: 0 for a debit that never arrived.
targetTransactionIdrollback onlyThe debit the rollback named.
atyesWhen 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: true is 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: 0 are 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.

On this page