Notell API Docs
English

Дополнительно

FAQ

Интеграция#

Это платформа с реальными деньгами?#

Нет. Это платформа TEST_ONLY: единицы невыводимые, а POST /playGame.do принимает только gametype: "demo". Ваш кошелёк при этом может быть настоящим сервисом с вашими балансами.

Какие валюты поддерживаются?#

UAH, USD, EUR и RUB, у каждой два знака после запятой. См. Основные понятия.

Куда вписать callback URL?#

Админ-панель → Projects → ваш проект → Integration. Адрес — https://, порт 443, без завершающего слэша. Платформа дописывает валюту: https://casino.example/wallet/UAH. См. Callbacks кошелька.

Почему запуск падает с BALANCE_UNAVAILABLE?#

Запрос session_info к вашему кошельку не выполнился за 2 секунды. Воспользуйтесь Test connection и посмотрите API Logs: обычно причина — статус не 2xx, balance в виде строки или currency, отличающаяся от указанной в URL.

Вы отправляете подпись с callbacks?#

Подписи нет; api_key проекта передаётся в теле каждого callback. Сравнивайте его со своим ключом и используйте HTTPS. См. Аутентификацию.

Что если мой кошелёк не успел ответить?#

Платформа считает операцию неизвестной и повторяет её с тем же id транзакции и телом. Поэтому кошелёк должен быть идемпотентным. Раунд отклоняется только при INSUFFICIENT_FUNDS на bet. См. Повторы и сбои.

Есть ли возврат или откат?#

Нет. Списание подтверждается только вашим ответом ok, иначе оно повторяется. См. Callbacks кошелька.

Почему IP_NOT_ALLOWED на /gameActions.do?#

Адрес вашего сервера не входит в список разрешённых проекта. Попросите владельца платформы добавить его (админ → IP Whitelist) — Аутентификация.

Можно ли встроить игру или передать адрес возврата?#

Откройте link из ответа запуска в браузере игрока. У метода запуска нет параметра адреса возврата или лобби; навигацию организуйте на странице вокруг игры.

Сколько действует ссылка сессии?#

Сессия истекает через 2 часа после создания. Если у игрока есть незавершённый раунд, повторный запуск его продолжает.

Как найти id игры?#

В списке игр или в GET /games/health (game_id).

Возможности#

Фриспины не появились в игре.#

Проверьте, что у игры free_spins: true, выдача active и не истекла, а bet принят. Пока выдача активна, игрок может играть в этой игре только фриспины.

Получает ли кошелёк ставку за фриспины?#

Да, с amount: 0 и meta.is_freespins: true. Принимайте её. См. Фриспины.

Мой целевой исход остаётся pending.#

Платформа ещё ищет подходящий раунд; платные спины не считаются, пока статус не ready. Если он стал unreachable, выберите меньший множитель или другой kind ("spin" / "bonus"). См. Целевые исходы.

Почему ставка отклоняется с PROJECT_BET_LIMIT?#

Ставка вне лимита проекта, игры или игрока для этой валюты. См. Лимиты ставок.

Как сделать доступными более высокие ставки?#

Поднимите максимум в Bet management; если он выше нативного максимума игры, появятся расширенные ставки. См. Расширенные ставки.

Какие значения RTP допустимы?#

От 60 % до 100 % — для проекта (RTP провайдера) и для игрока. У игрока один RTP на весь каталог. См. Управление RTP.

Влияют ли изменения RTP на текущий раунд?#

Нет. Они действуют со следующего раунда.

Какие языки можно использовать?#

Языки, перечисленные у игры в GET /games/health; весь каталог охватывает 43. См. Языки.

Админ-панель#

Кто может перевыпустить API-ключ?#

Только владелец. Старый ключ перестаёт работать сразу. См. Админ: проекты.

Мы с коллегой редактировали одни и те же настройки.#

У настроек есть ревизия; второе сохранение получает конфликт (PROJECT_SETTINGS_CONFLICT). Обновите страницу и повторите изменение.

Где журнал аудита?#

См. История изменений и аудит.

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