FAQ

Integration#

Is this a real-money platform?#

No. It is a TEST_ONLY platform: the units are non-withdrawable and POST /playGame.do accepts gametype: "demo" (your wallet) and gametype: "fun" (demo mode) only. Your wallet can still be a real service that tracks your own balances.

Which currencies are supported?#

All 157 active ISO 4217 fiat currencies, each with two decimals. See Currencies.

Where do I put the callback URL?#

Admin panel, your project, Integration. It must be https://, port 443, without a trailing slash. The platform appends the currency: https://casino.example/wallet/EUR. See Admin and Wallet callbacks.

Why does the launch fail with `BALANCE_UNAVAILABLE`?#

The session_info request to your wallet did not succeed within 2 seconds. Use Test connection and look at API Logs: usual causes are a non-2xx status, a balance sent as a string, or a currency that differs from the one in the URL.

Do you send a signature with callbacks?#

The project api_key is in the body of every callback and every callback is signed with HMAC-SHA256 (X-Notell-Signature). Compare the key, verify the signature and use HTTPS. See Authentication and Callback signature.

What if my wallet times out or fails?#

The platform treats the operation as unknown and retries it with the same transaction id and body, so your wallet must be idempotent. Two answers end a bet at once: INSUFFICIENT_FUNDS, and an HTTP 4xx status other than 408 and 429, which cancels the round and queues a refund. See Round cancel and refunds and Retries and failures.

Is there a refund or rollback call?#

Yes. A bet that stays unconfirmed for the cancel policy (default 10 minutes) cancels the round and the platform sends a refund callback with the original transaction id; you can also cancel an unfinished round with round_cancel. See Round cancel and refunds.

Why `IP_NOT_ALLOWED` on `/gameActions.do`?#

Your server address is not on the project's IP list. Add it in the admin panel (Admin) or ask the platform owner. See Authentication.

Can I embed the game in my site?#

Yes, in an iframe. The origin of your site must be in the project's frame origins list, otherwise the browser blocks the frame. See Embedding. The launch method has no return-URL or lobby parameter; keep navigation in the page around the game.

How long is a session link valid?#

The session expires 2 hours after creation. If the player has an unfinished round, launching again continues it.

How do I find a game id?#

In Games list or in GET /games/health (game_id).

How do I offer a free-play demo?#

Launch with gametype: "fun". It uses an isolated demo wallet and never calls your wallet. See Demo mode.

Features#

Free spins did not appear in the game.#

Check that the game has free_spins: true, the grant is active and not expired, and the player plays in the same currency as the grant and with the same player_id. While a grant is active the player can play only the free spins in that game. See Free spins.

Does the wallet get a bet for free spins? When is the win credited?#

Every free-spin round sends a bet with amount: 0 and meta.is_freespins: true. The wins are held and credited once, as one win with meta.freespins.final_credit: true, before the freespins_finished summary. See Free spins.

My target outcome stays `pending`.#

The platform is still searching for a suitable round; paid spins are not counted until it is ready. If it becomes unreachable, choose a smaller multiplier or another kind. See Target outcomes.

Why is a bet refused with `PROJECT_BET_LIMIT`?#

The bet is outside the project, per-game or player limit for that currency. See Bet limits.

How do I make higher bets available?#

Raise the maximum in Bet management; if it is above the game's native maximum, extended bets appear. See Extended bets.

What RTP values are allowed?#

60 % to 100 %, for the project (provider RTP, default 90 %) and per player. A player has one RTP across the catalog; a manual level has an effect only while Personal RTP is on. See RTP management.

Do RTP changes affect a round in progress?#

No. They apply from the next round.

Which languages can I use?#

The languages listed for the game in GET /games/health; the whole catalog covers 47. See Languages.

Admin panel#

Who can rotate the API key?#

The platform owner and a client with manage-credentials for its own projects. The old key stops working immediately. See Admin.

A colleague and I edited the same settings.#

Settings carry a revision; the second save gets a conflict (PROJECT_SETTINGS_CONFLICT). Reload and repeat the change.

Where is the audit trail?#

See Admin.