Начало работы

Основные понятия

Проект (partner)#

Проект — ваша интеграция на платформе. Он определяется id partner и имеет:

• API-ключ (api_key): передаётся в теле ваших запросов и возвращается в каждом callback кошелька;
• адрес callback — endpoint вашего кошелька;
• список разрешённых IP ваших серверов;
• настройки: валюта и язык по умолчанию, включённые провайдеры и функции, лимиты ставок, RTP.

Владелец платформы создаёт проект и выдаёт вам id partner и API-ключ. Затем ваш персонал работает с проектом в админ-панели.

Игрок#

Игрок — тот, кого вы идентифицируете через player_id: строка длиной 1–128 символов по вашему выбору. Платформа рассматривает player_id как непрозрачный ключ в запуске, callbacks кошелька, фриспинах, целевых исходах и RTP.

Для фриспинов и управления RTP id игрока должен состоять из печатных ASCII-символов без пробелов (до 128 символов).

Валюта и минорные единицы#

Поддерживаются четыре валюты, у каждой два знака после запятой:

Суммы имеют три формы в зависимости от места:

Суммы имеют не более двух знаков после запятой и не более 13 цифр до запятой.

Сессия#

Запуск игры создаёт сессию, привязанную к игроку, игре, валюте и языку. В ответе приходят meta.session_id и link с токеном сессии — отдавайте ссылку только этому игроку. Сессия истекает через 2 часа после создания; повторный запуск при незавершённом раунде «оживляет» её, чтобы раунд можно было доиграть.

Раунд#

Раунд — один платный игровой цикл (спин и всё, что он запускает: бесплатные игры, бонусные раунды, риск-игра). Платформа проводит каждый раунд по шагам:

1. платформа просит ваш кошелёк списать ставку (bet);
2. после подтверждения списания отправляется round_info со status: "start";
3. исход разыгрывается в игре;
4. если раунд выиграл, платформа просит кошелёк начислить выигрыш (win);
5. после подтверждения начисления отправляется round_info со status: "finish".

Если кошелёк отклонил списание ответом INSUFFICIENT_FUNDS, раунд отклоняется и ничего не разыгрывается. Начатый раунд не пропадает: перезагрузка или повторный запуск продолжают его. Раунды фриспинов идут по тому же потоку со ставкой 0 — см. Фриспины.

Провайдеры, игры и режимы#

Игры относятся к одному из трёх семейств провайдеров (endorphina, pragmatic, nolimitcity). Игра адресуется своим id (symbol в запросе запуска, game_id в каталоге). У каждой игры есть базовый режим (spin), могут быть и другие — покупка бонуса, ante-ставка, риск-игра; необязательные режимы включаются и отключаются по провайдерам в настройках проекта.

Что ещё привязано к игроку#