Возможности

Управление RTP

RTP (return to player) — доля ставок, которую игры возвращают на дистанции. Платформа позволяет управлять им в диапазоне 60–100 %: для всего проекта и, по желанию, для каждого игрока. Эта страница объясняет, какой уровень получает раунд, и как управлять уровнями игроков через API.

Какой RTP получает раунд#

Уровень определяется до списания, в той же транзакции, что и платный раунд, и затем остаётся неизменным для этого раунда. Изменение действует со следующего раунда; начатые раунды завершаются на своём уровне.

1. По умолчанию. Проект без сохранённых настроек RTP играет на 90 % (RTP провайдера). Естественная математика игр используется, только если владелец явно сохранил «нет RTP провайдера».
2. RTP провайдера задан, персональный RTP выключен. Раунды всех игроков играются на RTP провайдера проекта. Ручные уровни игроков игнорируются.
3. Персональный RTP включён. У каждого игрока свой уровень (ниже).

Раунды фриспинов проходят ту же логику и учитываются в адаптивном окне с номинальной ставкой. Раунды целевых исходов помечаются и в окне не учитываются.

Настройки проекта#

Задаются в админ-панели на экране RTP & players (проектные настройки меняет владелец платформы; см. Админ-панель).

Персональный RTP игрока#

• Новый игрок привязывается при первом раунде к RTP провайдера, актуальному в тот момент (стартовый уровень = текущий).
• Уровень можно менять вручную (админ-панель или API, 60–100 %, до двух знаков после запятой, с причиной, которая сохраняется в журнале игрока). Ручной уровень замораживает адаптивное правило для этого игрока, пока вы не вернёте его в auto.
• В режиме auto игрок играет на текущем уровне, ограниченном RTP провайдера на данный момент. Если RTP провайдера снижен ниже уровня игрока, игрок играет на RTP провайдера.
• Ручной уровень RTP провайдера не ограничивает.
• Журнал каждого игрока фиксирует, кто менял уровень, когда и почему (привязка, шаги правила, ручные изменения).

Адаптивное правило#

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

За окно делается не более одного шага. Уровень никогда не опускается ниже 60 %. Игроков с ручным уровнем правило не трогает.

На коротких выборках наблюдаемый RTP может отличаться от целевого; это нормально.

POST /playerRtp.do#

Управление уровнем игрока и его личными лимитами ставок. Каждому действию нужны partner, api_key и разрешённый IP. Запрос не использует Idempotency-Key и не ограничивается по частоте. Общие поля:

Каждое действие отвечает {"status": "ok", "player": {…}}; объект игрока описан в разделе get.

Ошибки, общие для всех действий: INVALID_ACTION (400) для неизвестного action, INVALID_PLAYER (400) для player_id с недопустимыми символами, RTP_PROVIDER_UNSUPPORTED (400) для другого provider.

get#

Возвращает состояние игрока по одному провайдеру.

Запрос#

curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{"partner":"demo-casino","api_key":"YOUR_API_KEY","action":"get","player_id":"player-1024","provider":"pragmatic"}'

{
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "action": "get",
  "player_id": "player-1024",
  "provider": "pragmatic"
}

Других полей, кроме общих, нет.

Ответ#

{
  "status": "ok",
  "player": {
    "partner": "demo-casino",
    "player": "player-1024",
    "nickname": null,
    "bound": true,
    "provider": "pragmatic",
    "startBps": 9000,
    "currentBps": 8800,
    "mode": "auto",
    "roundsSinceAdjust": 120,
    "providerBps": 9000,
    "effective": {"bps": 8800, "source": "player"},
    "betLimits": [{"currency": "EUR", "minMinor": "10", "maxMinor": "5000"}],
    "journal": [
      {
        "provider": "pragmatic",
        "actor": "bind",
        "reason": "bound before the first round by a level change",
        "fromBps": null,
        "toBps": 9000,
        "fromMode": null,
        "toMode": "auto",
        "windowRounds": null,
        "windowRtpPpm": null,
        "at": "2027-02-15T10:00:00.000Z"
      }
    ],
    "providers": [
      {"provider": "pragmatic", "startBps": 9000, "currentBps": 8800, "mode": "auto", "roundsSinceAdjust": 120, "effective": {"bps": 8800, "source": "player"}, "updatedAt": "2027-02-15T10:00:00.000Z"}
    ]
  }
}

Ошибки#

set#

Задаёт ручной уровень (режим manual). При первом использовании игрок привязывается к провайдеру.

Запрос#

curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{"partner":"demo-casino","api_key":"YOUR_API_KEY","action":"set","player_id":"player-1024","provider":"pragmatic","rtp":94.5,"reason":"VIP agreement"}'

{
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "action": "set",
  "player_id": "player-1024",
  "provider": "pragmatic",
  "rtp": 94.5,
  "reason": "VIP agreement"
}

Ответ#

{"status": "ok", "player": {…}} с mode: "manual", currentBps: 9450 и effective.source: "manual". Объект описан в разделе get.

{
  "status": "ok",
  "player": {
    "partner": "demo-casino",
    "player": "player-1024",
    "nickname": null,
    "bound": true,
    "provider": "pragmatic",
    "startBps": 9000,
    "currentBps": 9450,
    "mode": "manual",
    "roundsSinceAdjust": 0,
    "providerBps": 9000,
    "effective": {"bps": 9450, "source": "manual"},
    "betLimits": [],
    "journal": [],
    "providers": []
  }
}

(journal и providers здесь сокращены; в реальном ответе они заполнены.)

Ошибки#

auto#

Возвращает игрока в автоматический режим: адаптивное правило продолжает работу с текущего уровня. При первом использовании игрок привязывается к провайдеру.

Запрос#

curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{"partner":"demo-casino","api_key":"YOUR_API_KEY","action":"auto","player_id":"player-1024","provider":"pragmatic","reason":"VIP period over"}'

{
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "action": "auto",
  "player_id": "player-1024",
  "provider": "pragmatic",
  "reason": "VIP period over"
}

Ответ#

{"status": "ok", "player": {…}} с mode: "auto". Объект описан в разделе get.

Ошибки#

bet-limit#

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

Запрос#

curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{"partner":"demo-casino","api_key":"YOUR_API_KEY","action":"bet-limit","player_id":"player-1024","provider":"pragmatic","currency":"EUR","min_minor":"10","max_minor":"5000"}'

{
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "action": "bet-limit",
  "player_id": "player-1024",
  "provider": "pragmatic",
  "currency": "EUR",
  "min_minor": "10",
  "max_minor": "5000"
}

Оба предела обязательны: передайте оба строками либо оба как null, чтобы снять лимит.

Ответ#

{"status": "ok", "player": {…}}; betLimits показывает новый лимит. Объект описан в разделе get.

Ошибки#

См. также#

• Лимиты ставок: как личные лимиты сочетаются с лимитами проекта.
• Целевые исходы и Фриспины: как учитываются их раунды.
• Админ-панель: где редактируются настройки RTP проекта и уровни игроков.