Возможности

Целевые исходы

Целевой исход сообщает платформе: на n-м платном спине этого игрока в этой игре создай раунд с выигрышем около X ставок. Подходит для тестовых сценариев, акций и QA.

Доступны для игр с target_outcomes: true в /games/health (433 из 446 игр).
Методы — POST /gameActions.do; нужны partner, api_key и разрешённый IP. В админ-панели есть экран Target outcomes (Админ: операции).
Раунд всегда — собственный естественный исход игры, сформированный под эту запись; игровое поле и функции никогда не собираются вручную, результат заранее не раскрывается.

Методы#

`method`	Поля	Ответ
`outcome_schedule`	`player_id`, `symbol`, `multiplier`, `kind?`, `spin_number?`, `expires_at?`, `external_id?`, `comment?`	`{"status":"ok","outcome":{…}}`
`outcome_get`	`outcome_id` или `external_id`	`{"status":"ok","outcome":{…}}`
`outcome_list`	`player_id?`, `symbol?`, `status?`	`{"status":"ok","outcomes":[…]}` (не более 200, сначала новые)
`outcome_cancel`	`outcome_id` или `external_id`	`{"status":"ok","outcome":{…}}`

bash

curl -s -X POST https://notell-api.com/gameActions.do \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "outcome_schedule",
    "partner": "YOUR_PARTNER_ID",
    "api_key": "YOUR_API_KEY",
    "player_id": "player-123",
    "symbol": "gates-of-olympus",
    "multiplier": 50,
    "kind": "bonus",
    "spin_number": 3,
    "external_id": "qa-case-17",
    "comment": "QA: big bonus on spin 3"
  }'

Поле	Правила
`player_id`	1–128 печатных символов
`symbol`	id игры с `target_outcomes: true` (иначе `GAME_NOT_FOUND`, `FORCED_OUTCOMES_UNSUPPORTED`)
`multiplier`	Целевой выигрыш в ставках спина: положительное число (или числовая строка) не более чем с 2 знаками после запятой. Не выше максимального выигрыша игры (`MULTIPLIER_ABOVE_MAX_WIN`, `INVALID_MULTIPLIER`)
`kind`	`spin` (по умолчанию): выигрыш без функции. `bonus`: выигрыш, который приходит с функцией (естественный запуск либо покупка функции, если игрок её покупает). `bonus` требует игру с функцией (`GAME_HAS_NO_BONUS`, `INVALID_KIND`)
`spin_number`	Какой платный спин игрока, 1–100000, по умолчанию 1 (`INVALID_SPIN_NUMBER`)
`expires_at`	ISO 8601 с часовым поясом; по умолчанию сейчас + 7 дней; минимум сейчас + 1 час; максимум сейчас + 90 дней (`INVALID_EXPIRY`)
`external_id`	Ваш id, уникален в проекте (`DUPLICATE_EXTERNAL_ID`)
`comment`	Свободный текст до 500 символов

Объект исхода#

json

{
  "outcome_id": "5a3e…",
  "external_id": "qa-case-17",
  "player_id": "player-123",
  "symbol": "gates-of-olympus",
  "provider": "pragmatic",
  "kind": "bonus",
  "multiplier": "50",
  "spin_number": 3,
  "paid_spins_since": 0,
  "status": "pending",
  "variants": [],
  "comment": "QA: big bonus on spin 3",
  "created_at": "2026-10-15T10:00:00.000Z",
  "expires_at": "2026-10-22T10:00:00.000Z",
  "applied_at": null,
  "round_id": null
}

multiplier возвращается строкой. variants называет виды раундов, найденные платформой (например, обычный спин и купленная функция). round_id заполняется после применения записи.

Статусы#

Статус	Значение
`pending`	Платформа ещё ищет подходящий раунд. Платные спины пока не считаются
`ready`	Раунд найден. Платные спины игрока в этой игре теперь считаются до `spin_number`
`unreachable`	За бюджет поиска раунд не найден (например, x50 в обычном спине игры, которая не может столько заплатить). Выберите другой множитель или `kind`
`applied`	Раунд сыгран; заполнены `applied_at` и `round_id`
`expired`	`expires_at` наступил до применения записи
`cancelled`	Отменён оператором или админом

outcome_cancel отменяет записи в статусах pending, ready и unreachable; для остальных возвращает запись без изменений.

Как выбирается спин#

Счёт начинается, когда запись становится ready. Считаются только платные спины игрока в этой игре; раунды фриспинов не считаются.
spin_number-й посчитанный спин выигрывает множитель × ставка спина с допуском ±2 %. Множитель не зависит от размера ставки.
Если спин не подходит записи (например, ante-ставка, покупка бонуса для записи spin или подходящего раунда нет), запись переносится на следующий платный спин.
Записей может быть несколько. Записи, наступившие на одном спине, срабатывают по одной на спин, сначала более старая.
Если игра предлагает игроку выбор после списания, цель применяется к каждому варианту.

Взаимодействие с RTP и кошельком#

«Заданные» раунды помечаются и исключаются из окна адаптивного RTP игрока (Управление RTP).
Уведомления round_info такого раунда содержат "forced": true (Callbacks кошелька).
Риск-игра после заданного выигрыша разрешена в играх, где она есть.

Ошибки#

UNAUTHORIZED, IP_NOT_ALLOWED, INVALID_REQUEST, GAME_NOT_FOUND, FORCED_OUTCOMES_UNSUPPORTED, GAME_HAS_NO_BONUS, INVALID_MULTIPLIER, MULTIPLIER_ABOVE_MAX_WIN, INVALID_SPIN_NUMBER, INVALID_KIND, INVALID_EXPIRY, DUPLICATE_EXTERNAL_ID, OUTCOME_NOT_FOUND — см. справочник ошибок.