Быстрая интеграция API казино: шаги по порядку

На что на самом деле уходит время интеграции

Спросите разработчика, сколько времени займёт подключение агрегатора игр, и услышите «пару дней». Спросите оператора, сколько прошло от первого письма до первой реальной ставки, и ответ часто будет — недели. Разница — это всё, что происходит до того, как разработчик сможет прикоснуться к API: ознакомительные созвоны, коммерческое предложение, черновики договора туда-обратно, плата за интеграцию, которая должна пройти, потом ключи от песочницы, потом отдельный запрос на боевые ключи.

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

Перед началом: что нужно с вашей стороны

• Кошелёк игрока. Наш API работает по модели seamless wallet: балансы хранятся на вашей платформе. Если кошелёк уже есть, большая часть пути пройдена. Если нет — сначала постройте или купите его: этот этап не сократит за вас ни один агрегатор.
• Публичный HTTPS-эндпоинт, который может принимать наши коллбэки кошелька и быстро на них отвечать.
• Список валют ваших игроков и стран, в которых вы будете работать: и то и другое влияет на то, какие игры смогут запуститься.

Шаг 1: получите ключи

Запросите доступ на странице получения API-ключа. После одобрения вы найдёте в бэк-офисе оператора свой логин, пароль и секретную соль. Укажите URL, на который мы будем отправлять коллбэки кошелька. Больше для старта ничего настраивать не нужно.

Шаг 2: проверьте свои валюты

Прежде всего вызовите метод валют. Он покажет, какие валюты игроков включены для вашего аккаунта. Пропуск этого шага — самая частая причина неудачного запуска без видимых причин: игрок создан в валюте, которую игра не принимает.

Шаг 3: загрузите каталог

Запросите список игр. У каждого тайтла есть стабильный идентификатор, превью, студия и нормализованный тип игры. Стройте разделы лобби по этому полю типа (слоты, live, crash, настольные, спорт), а не по меткам студий, которые у каждой студии оформлены по-своему. Сохраните идентификаторы: вы будете передавать их обратно для запуска игр.

Шаг 4: создайте тестового игрока

Зарегистрируйте одного игрока с именем пользователя и валютой. Валюта закрепляется за этим игроком навсегда, поэтому выбирайте её осознанно.

Шаг 5: напишите обработчик коллбэков

Это единственная часть, требующая настоящей аккуратности. Мы будем вызывать ваш эндпоинт с тремя действиями:

1. balance при открытии сессии,
2. debit на каждую ставку,
3. credit на каждый выигрыш.

Отвечайте на каждый вызов HTTP 200 и телом JSON с новым балансом; суммы — целые числа в минимальных единицах (2.50 превращается в 250). О проблемах, например о недостатке средств, сообщайте кодом ошибки в теле, а не HTTP-ошибкой. Проверяйте подпись каждого запроса и дедуплицируйте по id транзакции, чтобы повторный вызов никогда не двигал деньги дважды.

Два правила снимают большую часть обращений в поддержку. Первое: никогда не отклоняйте коллбэк из-за того, что не узнали его поле типа, — обрабатывайте его по действию. Второе: принимайте credit без соответствующего debit. Именно так выплачиваются внутриигровые фриспины, бонусные раунды и джекпоты, и обработчик, который их отклоняет, оставляет игроков без выплаты. Откаты приходят с флагом и обрабатываются как обычный debit или credit.

Шаг 6: запустите игру

Запросите URL запуска для одного слота, передав игрока, идентификатор игры, тип устройства и страну игрока. Откройте URL в iframe, сделайте спин на тестовый кредит и посмотрите, как на ваш эндпоинт приходят debit и credit. Затем проверьте историю раундов игрока и убедитесь, что ставка и выигрыш совпадают с записями в вашем леджере.

Реалистичные сроки

Для команды, у которой уже есть кошелёк, шаги со 2-го по 6-й укладываются в один рабочий день; первый реальный игровой раунд в первый же день — реалистичная цель. Превратить это в боевое лобби с полным каталогом, live-казино, спортом, мобильными запусками, языками и демо-режимом — обычно около недели работы. Командам без кошелька нужно прибавить время, которое уйдёт на его создание.

Добавление live-казино или sportsbook не запускает проект заново. И то и другое есть в том же списке игр, открывается тем же вызовом запуска и рассчитывается через те же коллбэки, так что это только работа над фронтендом. На странице API ставок на спорт разобраны немногие особенности спорта, например ставки, которые рассчитываются спустя долгое время после размещения.

Запуск в продакшн

Когда тестирование закончено, внесите предоплаченный кредит (минимум 100 USD за пополнение) и откройте доступ реальным игрокам. Комиссия списывается из этого кредита по мере расчёта раундов на реальные деньги. Несколько брендов? Каждый дополнительный сайт получает свои ключи и callback URL в том же аккаунте, без новой интеграции.

Полный список методов и полей — в обзоре API агрегатора игр для казино. О стоимости — в разделе цены и в разборе бесплатный API казино. Чтобы сравнить скорость онбординга с другими вендорами на равных условиях, загляните в раздел сравнений.