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

FAQ

Интеграция#

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

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

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

Все 157 действующих фиатных валют ISO 4217, у каждой по два знака после запятой. См. Валюты.

Куда вставить URL колбэка?#

Админ-панель, ваш проект, Integration. Он должен быть https://, порт 443, без завершающего слэша. Платформа добавляет валюту: https://casino.example/wallet/EUR. См. Админ-панель и Колбэки кошелька.

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

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

Подписываете ли вы колбэки?#

api_key проекта передаётся в теле каждого колбэка, и каждый колбэк подписан HMAC-SHA256 (X-Notell-Signature). Сравнивайте ключ, проверяйте подпись и используйте HTTPS. См. Аутентификацию и Подпись колбэков.

Что если мой кошелёк отвечает с таймаутом или ошибкой?#

Платформа считает операцию неизвестной и повторяет её с тем же id транзакции и телом, поэтому ваш кошелёк должен быть идемпотентным. Два ответа сразу завершают bet: INSUFFICIENT_FUNDS и HTTP-статус 4xx, кроме 408 и 429, который отменяет раунд и ставит в очередь refund. См. Отмену раунда и возвраты и Повторы и сбои.

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

Да. bet, остающийся неподтверждённым в рамках политики отмены (по умолчанию 10 минут), отменяет раунд, и платформа отправляет колбэк refund с исходным id транзакции; незавершённый раунд можно также отменить через round_cancel. См. Отмену раунда и возвраты.

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

Адреса вашего сервера нет в списке IP проекта. Добавьте его в админ-панели (Админ-панель) или попросите владельца платформы. См. Аутентификацию.

Можно ли встроить игру на мой сайт?#

Да, в iframe. Источник вашего сайта должен быть в списке источников фрейма проекта, иначе браузер заблокирует фрейм. См. Встраивание. У метода запуска нет параметра return URL или лобби; навигацию держите на странице вокруг игры.

Как долго действует ссылка на сессию?#

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

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

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

Как предложить бесплатную демо-игру?#

Запустите игру с gametype: "fun". Она использует изолированный демо-кошелёк и никогда не обращается к вашему кошельку. См. Демо-режим.

Функции#

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

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

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

Каждый раунд фриспина отправляет bet с amount: 0 и meta.is_freespins: true. Выигрыши удерживаются и зачисляются один раз, одним win с meta.freespins.final_credit: true, перед итоговым freespins_finished. См. Фриспины.

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

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

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

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

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

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

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

От 60 % до 100 %, для проекта (RTP провайдера, по умолчанию 90 %) и для игрока. У игрока один RTP на весь каталог; ручной уровень действует, только пока включён Personal RTP. См. Управление RTP.

Влияют ли изменения RTP на раунд в процессе?#

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

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

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

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

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

Владелец платформы и клиент с manage-credentials в своих проектах. Старый ключ перестаёт работать сразу. См. Админ-панель.

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

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

Где аудит?#

См. Админ-панель.