Notell API Docs
English

Начало работы

Обзор

Платформа — игровой сервер слотов для операторов казино. Аккаунты игроков и деньги остаются у вас; платформа проводит игры и обращается к вашему кошельку, чтобы списать и начислить средства за каждый раунд (бесшовный кошелёк).

Что вы получаете#

ВозможностьГде описана
Запуск любой опубликованной игры для игрока и готовая ссылкаЗапуск игры
Бесшовный кошелёк: баланс, списание (bet), начисление (win), уведомления о раундахКолбэки кошелька
Встраивание игры в iframe на вашем сайтеВстраивание
Публичный каталог с языками и возможностями каждой игрыКаталог и возможности, Список игр
Все 157 фиатных валют ISO 4217Валюты
47 языков запуска в каталоге, выбор при каждом запускеЯзыки
Фриспины оператора с итоговым колбэком по каждой выдачеФриспины
Запланированные целевые исходы для выбранного платного спинаЦелевые исходы
Лимиты ставок проекта, игры и игрока; расширенные ставки выше родного максимума игрыЛимиты ставок
Персональный RTP 60–100 % для игрокаУправление RTP
Демо-режим без обращений к вашему кошелькуДемо-режим
Админ-панель для ваших сотрудниковАдмин-панель

Каталог#

Сейчас в каталоге 1010 игр трёх семейств провайдеров. Идентификатор провайдера используется в админ-панели и в некоторых полях API.

ПровайдерId провайдераИгрФриспиныЦелевые исходы
Endorphinaendorphina235235225
Pragmatic Playpragmatic659659634
Nolimit Citynolimitcity116115115

Игры определяются стабильным строковым идентификатором (например, gates-of-olympus); все идентификаторы, языки и возможности — в списке игр. Числа выше взяты из среза каталога от 2026-11-10.

Режим TEST_ONLY#

Платформа — тестовая и демонстрационная среда:

  • игровые единицы нельзя вывести: ни один вызов API не двигает реальные деньги;
  • POST /playGame.do принимает gametype: "demo" (режим с кошельком, игра идёт на ваш кошелёк) и gametype: "fun" (демо-режим, бесплатная игра); любое другое значение отклоняется с REAL_MODE_DISABLED;
  • GET /capabilities и GET /health возвращают "mode": "TEST_ONLY" (в /games/health и /games/catalog поля mode нет).

Ваш кошелёк при этом может быть настоящим сервисом с вашими балансами; платформа обращается к нему по контракту кошелька.

Как работает интеграция#

Operator server                      Platform                         Player browser
      |   POST /playGame.do  ----------->|                                  |
      |   <-- {link, session_id} --------|                                  |
      |   give the link to the player ------------------------------------>|
      |                                  |<---------- plays the game -------|
      |<-- POST <callback>/EUR session_info (at launch)                     |
      |<-- POST <callback>/EUR bet (before each paid round)                 |
      |<-- POST <callback>/EUR round_info start                             |
      |<-- POST <callback>/EUR win (when the round pays)                    |
      |<-- POST <callback>/EUR round_info finish                            |
  1. Ваш сервер вызывает метод запуска с идентификатором игрока, валютой и идентификатором игры.
  2. Платформа запрашивает у вашего кошелька баланс (session_info), создаёт сессию и возвращает ссылку.
  3. Игрок открывает ссылку и играет. За каждый платный раунд платформа обращается к вашему кошельку: сначала bet, затем win, если раунд выиграл, а также уведомления round_info.
  4. Дополнительные серверные вызовы: фриспины, целевые исходы, отмена раунда и отчёты через /gameActions.do, персональный RTP и лимиты ставок через /playerRtp.do.

Кому что читать#

Документация для операторов и интеграторов.Платформа TEST_ONLY: невыводимые единицы, реальные платежи не используются.