Go-live checklist
Everything that must be true on your side before real-money traffic, with one checklist per integration stream.
On this page
These are your responsibilities under the agreement. We verify the technical items in the sandbox certification run. Complete Both streams, then the list for your stream.
Both streams
Security
- API (application programming interface) secrets are stored in a secrets manager and never logged; access is limited to named staff.
- Only your servers call the API (application programming interface).
sessionTokenand secrets never reach a browser. ThelaunchUrlgoes from your server to the browser only. - Your egress IPs are registered for the IP allowlist.
- You can rotate keys without downtime, and you have a contact who reports a suspected key compromise to us immediately.
- Your servers use NTP (Network Time Protocol); timestamps are UTC (Coordinated Universal Time).
Bets and money
Every bet has a new, unique
betId, never reused.Retries resend the identical request (including
trigger) with the samebetIduntil a definite answer, then cancel after the retry horizon.You credit the
winfield (which includes any carried-over bonus) oncommitted.You refund on
voided,cancelledand on every 4xx error.Amounts are handled as decimal strings, never floating point.
betCreatedAtis the real creation time.Every bet sends the
levelthe player chose and anamountequal to that level's current price (from/levels), never derived from the triggering bet.On
1201priceMismatchyou refund, read the returnedlevelandprice(or/levels), and only then send a new bet with a newbetId.On
1506maintenance(HTTP503, but definite) you refund the bet, don't retry thatbetId, and send new plays with newbetIds only aftermaintenanceUntil.On
1507settlementSuspended(HTTP403, definite) you refund the bet, don't retry thatbetId, and stop sending new plays for that Operator's Network Pools until your account manager says the suspension is lifted (staff lift it by hand, on the next configuration publication). Retries of accepted bets still return their result.You hide the Extra Game while
maintenance.activeis true (fromGET /v1/partner/gamesor/levels) and untilmaintenanceUntil, and you handle1506on session create and relaunch.
Sessions and widget
- Your CSP (Content Security Policy) allows our one host (
frame-srcandscript-src). - You relaunch with
POST /v1/partner/sessions/{sessionId}/launchon page reload or navigation, instead of creating a new session. - You send the Operator's own player id as
playerId(required for Operator Partners, recommended for Providers). - The rules screen (from
GET /v1/partner/games/{gameId}/rules) is reachable from your page.
Compliance
- Blocks and self-exclusions are forwarded with
POST /v1/partner/players/{playerId}/block. - You keep the combined bet (the Extra Bet plus the triggering bet) within the Operator's jurisdiction cap: we do not check it.
- You never start a play from autoplay (slot autoplay, casino auto-bet or crash auto-bet) where the Operator's jurisdiction bans it. We cannot observe autoplay and enforce nothing on it.
- You never send a play that breaks the player's own age-based bet limit (we receive no age data and cannot check it).
- Only opaque player ids are sent; no personal data.
Operations
- Daily reconciliation runs, and breaks are reported to us within the agreed time.
- You act on reconciliation requests after any incident.
- Support staff know how to look up a bet (
GET /v1/partner/rounds/{betId}) and quoterequestIdandroundId. - You have subscribed to our status and change notices.
Game integration (Provider)
- Each Extra Bet is debited before
POST /v1/partner/bets, and refunded on a rejection. - Each play carries a
trigger(optional, but recommended for reconciliation) with the base spin's bet, game and spin reference. - You call
reveal(roundId)when the base reels stop (Level 1). Level 2 has norevealcall. If you don't call it, the result shows after the Operator's short timeout (default 2 s). - You don't call us for free spins or bonus rounds, or any spin where no Extra Bet was charged.
- The player can switch the Extra Game on and choose the bet level in your game, and you send that level and its price as
levelandamount. - You read
enabledfrom thereadyevent and from everyoptInChanged { enabled, reason }, and you send no play while it isfalse. You hide the widget only withrx.hide(), and you treat1508sideGameOffas "off": refund, don't retry. - You send
operatorIdon every call.
Casino integration (Operator)
- Your trigger rule is written down and decides which casino bets trigger a play (including whether free spins and bonus rounds count).
- You debit the Extra Bet only after you have decided to send the play, and refund it on any rejection.
- You keep
nextPlayAtper player and skip the play, before debiting, on1505roundTooSoon. - Your backend confirms the player's opt-in and level and sends the level in each play. The widget never sends a bet.
- You read
enabledfrom thereadyevent and from everyoptInChanged { enabled, reason }, and you stop offering and sending the side game while it isfalse(the player's switch or a hidden widget). You resume when it istrue. - You hide the widget only with
rx.hide()(and show it withrx.show(), or mount it withhidden: true). Hiding the iframe in any other way can't be enforced and plays unseen. - You treat
1508sideGameOffas "the side game is off": you refund the bet amount, don't retry, and don't count it as a failure. - You check the origin of the SDK events (
optInChanged,levelChosen) before acting on them. If ReelXtra turned on widget level control for your Operator,levelChosenis only a hint your backend confirms; if not, your own level picker feeds your backend. - You run one SDK instance per Extra Game shown in the overlay.
- Responsible-gaming tools are shown next to the overlay.
- The combined bet (the Extra Bet plus the triggering bet) stays within the jurisdiction's cap (UK): we do not check it.
triggeris optional context. - Your pilot runs on an Operator in the Open Domain or a jurisdiction we have confirmed as cleared.