Notell API Docs
English

Возможности

Лимиты ставок и расширенные ставки

Каждый платный раунд проверяется по лимитам ставок до списания. Ставка вне лимитов отклоняется с PROJECT_BET_LIMIT, ничего не списывается. Лимиты задаются по валюте и действуют на спин: полная ставка раунда, включая цену покупки бонуса. Все суммы — значения с двумя знаками после запятой в любой из 157 поддерживаемых валют (Валюты).

Три уровня#

УровеньГде задаётсяОбласть
Таблица проектаАдмин-панель, проект, Bet management (Админ-панель)Весь проект; можно сузить по провайдеру и по игре.
Лимит по игреАдмин-панель, RTP & players, Bet limits per gameОдна игра проекта, по валюте.
Лимит игрокаАдмин-панель, страница игрока, или bet-limit в POST /playerRtp.doОдин игрок, по валюте.

Все применимые уровни действуют одновременно. Для заданных игрока, игры и валюты действующий диапазон — это наибольший минимум и наименьший максимум среди уровней, где есть запись.

Таблица проекта: какая запись применяется#

Побеждает самая точная таблица: игра, затем провайдер, затем общая. Если в таблице нет записи для валюты раунда, берётся следующая, менее точная. Если валюты нет ни в одной таблице, лимита проекта нет: принимается любая ставка, которую предлагает игра.

В каждой записи есть минимум и максимум; оба обязательны, минимум — не менее одной минорной единицы, максимум — не меньше минимума. В админ-панели суммы вводятся в основных единицах с двумя знаками (например, 0.10 и 100.00); хранятся они в минорных единицах.

Расширенные ставки#

У каждой игры есть собственная таблица ставок. Максимум ниже неё просто сужает таблицу. Максимум выше родного максимума игры открывает расширенные ставки: дополнительные уровни выше родных, до действующего максимума.

  • Расширенные уровни передаются в начальной конфигурации игры при её загрузке. Изменение лимитов доходит до игрока при открытии или перезагрузке игры.
  • Предлагается не более 12 дополнительных уровней; если подходит больше, они равномерно прореживаются, а список всегда доходит до наибольшего уровня, который укладывается в лимит.
  • Лимит по-прежнему проверяется до списания по реальной ставке, поэтому уровень выше действующего максимума отклоняется.
  • Родные ставки и всё, что игра делает для них, не меняются. Выигрыши масштабируются линейно со ставкой.

Лестница по провайдерам#

ПровайдерЧто расширяетсяЛестница
Pragmatic PlayМонета на линию выше наибольшей родной монеты игры.Номиналы 1, 1.5, 2, 2.5, 3, 4, 5, 6, 7.5 × 10<sup>k</sup>; ставка = монета × линии и не должна превышать действующий максимум. Потолок монеты: 1 000 000 000.00.
Nolimit CityУровень ставки выше наибольшего родного уровня игры.k × наибольший родной уровень, где k = n × 10^j, n из 1, 2, 3, 4, 5, 6, 8, 15, 25, 75, j ≥ 0, k ≥ 2 (то есть 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, …).
EndorphinaДеноминация выше наибольшей родной деноминации игры.k × наибольшая родная деноминация, с той же лестницей k; наименьшая ставка расширенной деноминации должна укладываться в лимит.

Для Nolimit City и Endorphina ставка расширенного уровня ограничена 100 000 000 000.00 в валюте.

Примеры расчёта#

Pragmatic Play. Наибольшая родная монета 10.00, 10 линий (наибольшая родная ставка 100.00). Действующий максимум 1 000.00 на спин, значит максимальная монета 100.00. Монеты лестницы выше 10.00 и до 100.00: 15, 20, 25, 30, 40, 50, 60, 75, 100 — девять расширенных монет, меньше 12, поэтому предлагаются все. Наибольшая ставка становится 1 000.00.

Nolimit City. Наибольший родной уровень 100.00; действующий максимум 1 000.00, значит k до 10: 2, 3, 4, 5, 6, 8, 10. Расширенные уровни: 200, 300, 400, 500, 600, 800, 1 000.

По валютам. Лимиты задаются по валюте: максимум 1 000.00 для EUR ничего не говорит о USD. Задайте таблицу для каждой используемой валюты либо полагайтесь на общую таблицу.

Фриспины и расширенные ставки#

При выдаче фриспинов в админ-панели список ставок содержит родные ставки игры и, если максимум проекта для валюты выше родного, расширенные ставки до него. Через API bet должна быть одной из этих ставок.

Лимиты игроков#

Личный лимит действует вместе с лимитами проекта (побеждает наименьший максимум). Задайте его в админ-панели (страница игрока; один и тот же лимит записывается для всех провайдеров) или действием bet-limit метода POST /playerRtp.do. Клиент платформы может задавать лимиты игроков только в границах, которые для него настроил владелец платформы (Админ-панель).

Диагностика#

СимптомВероятная причина
PROJECT_BET_LIMIT для ставки, которую предлагает играНа одном из трёх уровней для этой валюты более узкий диапазон. Проверьте лимит игрока и лимит по игре, а также таблицу проекта.
Расширенные ставки не появляютсяДействующий максимум не выше родного максимума игры или ни одна таблица не покрывает валюту. После изменения игру нужно открыть заново.
freespins_create падает с PROJECT_BET_LIMITbet вне лимита проекта, игры или игрока для этой валюты.

См. также#

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