Notell API Docs
English

Возможности

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

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

Три уровня#

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

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

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

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

Эффективный максимум#

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

  1. максимума таблицы проекта (игра → провайдер → по умолчанию),
  2. лимита игры из настроек RTP,
  3. личного максимума игрока.

Минимум каждого уровня тоже проверяется, а bet фриспинов проверяется по лимитам проекта при создании выдачи.

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

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

  • Расширенные уровни предлагаются в начальной конфигурации игры при её загрузке. Поэтому изменение лимитов доходит до игрока, когда игру открывают или перезагружают.
  • Предлагается не более 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 ничего не говорит о UAH. Задайте таблицу для каждой используемой валюты или опирайтесь на таблицу по умолчанию.

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

При выдаче фриспинов в админ-панели список ставок содержит нативные ставки игры и — если максимум проекта по валюте выше нативного максимума — расширенные ставки до него.

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

Личный лимит действует вместе с лимитами проекта (побеждает наименьший максимум). Задаётся:

  • в админ-панели (RTP & players, выберите игрока, Player bet limit — тот же лимит записывается для каждого провайдера), или
  • через POST /playerRtp.do:
bash
curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{
    "partner": "YOUR_PARTNER_ID",
    "api_key": "YOUR_API_KEY",
    "action": "bet-limit",
    "player_id": "player-123",
    "provider": "pragmatic",
    "currency": "EUR",
    "min_minor": "10",
    "max_minor": "5000"
  }'

Передайте null в min_minor и max_minor, чтобы снять лимит. Минорные единицы — строки: "5000" = 50.00. Подробнее о методе: Управление RTP.

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

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