Notell API Docs
Русский

More

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" only. Your wallet can still be a real service that tracks your own balances.

Which currencies are supported?#

UAH, USD, EUR and RUB, each with two decimals. See Core concepts.

Where do I put the callback URL?#

Admin panel → Projects → your project → Integration. It must be https://, port 443, without a trailing slash. The platform appends the currency: https://casino.example/wallet/UAH. See 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?#

No signature; the project api_key is in the body of every callback. Compare it with your key and use HTTPS. See Authentication.

What if my wallet times out?#

The platform treats the operation as unknown and retries it with the same transaction id and body. Your wallet must therefore be idempotent. Only INSUFFICIENT_FUNDS on a bet rejects the round. See Retries and failures.

Is there a refund or rollback call?#

No. A debit is confirmed only when you answer ok; otherwise it is retried. See Wallet callbacks.

Why IP_NOT_ALLOWED on /gameActions.do?#

Your server address is not on the project's allowlist. Ask the platform owner to add it (admin → IP Whitelist) — Authentication.

Can I embed the game or pass a return URL?#

Open the link from the launch response in the player's browser. The launch method has no return-URL or lobby parameter; keep navigation in the page around the game.

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).

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 bet was accepted. While a grant is active the player can play only the free spins in that game.

Does the wallet get a bet for free spins?#

Yes, with amount: 0 and meta.is_freespins: true. Accept it. 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 kind: "spin"/"bonus" accordingly. 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) and per player. A player has one RTP across the catalog. 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 43. See Languages.

Admin panel#

Who can rotate the API key?#

Only the owner. The old key stops working immediately. See Admin: projects.

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 Change history and audit.

Documentation for operators and integrators.TEST_ONLY platform: non-withdrawable units, no real payments.