Данные игровой сессии
Игрок, бренд, игра, валюта, страна, язык, режим, юрисдикция и срок действия доступа.
Документация / Игровой сценарий
Игровой сценарий API
Полный путь от проверки игрока и запуска игры до обработки ставок, выигрышей, игровых раундов, отмен операций и финансовой сверки.
Сессия
игрок и запуск игры
Баланс
ставки и выигрыши
Раунды
ход игровой сессии
Отмена
восстановление операций
Жизненный цикл игры
От запуска до закрытия раунда
01
Создать игровую сессию
Игрок, игра, валюта, язык, страна, режим и адрес возврата.
02
Запустить игру
Временный ключ доступа, адрес запуска и проверка доступности игры.
03
Обработать финансовые операции
Проверка баланса, ставка, выигрыш, объединенная операция и ответы платформы.
04
Закрыть и сверить раунд
Финальный результат, отмены, финансовый журнал и отчет провайдера.
Обзор
Игровой API связывает игрока, раунд и движение средств
Запуск игры и движение средств являются разными частями одного процесса. Сессия определяет игрока и условия запуска, раунд связывает действия провайдера, а API платформы подтверждает каждое списание, начисление и отмену.
Контроль баланса
Платформа проверяет доступные средства и применяет каждую ставку, выплату или отмену только один раз.
Финансовый журнал игры
Идентификаторы операции и раунда, тип операции, сумма, баланс до и после сохраняются для контроля и сверки.
Запуск игры
Типовой сценарий запуска игры
Сначала платформа проверяет игрока и доступность игры, затем создает ограниченную по времени сессию и получает адрес запуска от провайдера.
01
Проверить игрока и доступность игры
Платформа проверяет статус аккаунта, валюту, страну, ограничения, лимиты, реальный или демонстрационный режим и доступность игры.
02
Создать внутреннюю сессию
Создается идентификатор сессии с данными игрока, игры, бренда, валюты, языка, IP и срока действия.
03
Получить адрес запуска игры
Провайдер получает ключ сессии, адреса уведомлений и возврата, тип устройства, юрисдикцию и параметры интерфейса.
04
Открыть игру в браузере
Игрок открывает полученный адрес, а дальнейшие финансовые операции выполняются напрямую между серверами.
Операции с балансом
Основные операции с балансом
Названия методов у провайдеров различаются, но логика остается общей: проверка баланса, списание ставки, начисление выигрыша и отмена ранее подтвержденной операции.
Проверка баланса
Возвращает доступный баланс игрока в валюте активной сессии без изменения финансового журнала.
Списание ставки
Проверяет игрока, сессию, валюту и доступные средства, затем однократно списывает подтвержденную ставку.
Начисление выигрыша
Начисляет выигрыш по уникальным идентификаторам операции и раунда, включая нулевой результат.
Ставка и результат одним запросом
Одновременно применяет ставку и итог игры, когда такую схему поддерживает провайдер.
Отмена операции
Создает отдельную корректирующую операцию для ранее подтвержденной ставки или выплаты, не удаляя исходную запись.
Бонусы и бесплатные вращения
Передает данные бонусной кампании и игрового раунда, разделяя реальные и бонусные средства.
Валюта и точность суммы
Каждая операция проверяет валюту, единицы суммы, количество знаков после запятой и правила округления.
Ответ платформы
Возвращает статус операции, ее внутренний идентификатор, текущий баланс и единый код ошибки.
Жизненный цикл раунда
Жизненный цикл игрового раунда
Один раунд может включать несколько ставок и результатов. Его состояние определяется правилами игры, а не только очередностью сетевых запросов.
Раунд создан
Платформа впервые получает идентификатор раунда и создает внутреннюю запись.
Раунд активен
Раунд может содержать дополнительные ставки, игровые действия и промежуточные выигрыши.
Ставка принята
Списание подтверждено платформой и связано с уникальным идентификатором операции провайдера.
Результат получен
Получен выигрыш или нулевой результат, но раунд может оставаться открытым по правилам игры.
Раунд закрыт
Провайдер подтвердил завершение раунда, а все ожидаемые финансовые операции обработаны.
Операции отменены
Одна или несколько операций скорректированы с сохранением полной исходной истории.
Один раунд может включать несколько операций
Идентификатор раунда не должен быть единственным ключом защиты от повторов. У каждой ставки, выплаты и отмены должен быть собственный уникальный идентификатор.
Надежность и сверка
Защита от повторов и финансовая сверка
Игровой API должен безопасно обрабатывать повторные запросы, задержки ответа, изменение порядка операций и восстановление провайдера после сбоя.
Безопасная повторная обработка
Идентификатор операции провайдера уникален для каждого типа финансового действия.
Повторный запрос возвращает исходный результат и актуальный баланс без повторного движения средств.
Повтор с другой суммой, валютой или игроком отклоняется как конфликт данных.
Отмена ссылается на конкретную исходную операцию и также получает собственный уникальный идентификатор.
Журнал раундов и сверка
Хранить идентификаторы сессии, раунда, операции провайдера и операции платформы.
Фиксировать тип операции, сумму, валюту, баланс до и после, а также время обработки.
Не изменять проведенные записи, а создавать отдельную корректирующую операцию.
Сверять отчеты провайдера, игровые раунды, движение баланса, GGR и найденные расхождения.
Тестирование
Что проверить в тестовой среде
Проверки должны охватывать запуск игры, ограничения игрока, недостаточный баланс, повторные операции, задержки ответа, отмены и сверку закрытого раунда.
Запуск и игровая сессия
Реальный и демонстрационный режимы, неверная валюта, запрещенная страна, истекший доступ и недоступная игра.
Баланс и отказ ставки
Недостаточно средств, заблокированный игрок, несовпадение валюты и превышение лимита.
Задержка и неизвестный результат
Провайдер не получил ответ после фактического списания и повторно отправляет операцию с тем же идентификатором.
Повторные ставки и выигрыши
Одинаковый идентификатор приходит до или после завершения обработки, в том числе с конфликтующими параметрами.
Отмена операций
Отмена ставки, отмена выигрыша, повторная отмена и ссылка на неизвестную исходную операцию.
Сверка раунда
Суммы ставок, выигрышей и отмен, итоговый статус, движение баланса и отчет провайдера должны совпадать.
Чек-лист перед запуском
Запуск выполняется после проверки игровых сессий, операций с балансом, защиты от повторов, отмен и отчетности.
Тестовая и рабочая среды используют разные доступы, адреса API и настройки запуска.
Ключ игровой сессии ограничен по времени и связан с игроком, игрой, валютой и брендом.
Каждая операция с балансом защищена уникальным идентификатором провайдера.
Повторные ставки, выигрыши и отмены не изменяют баланс второй раз.
Проведенные записи не удаляются и исправляются отдельными корректирующими операциями.
Настроены журналы событий, уведомления, отчеты провайдера и процесс сверки раундов.
Нужно настроить игровой сценарий API?
Передайте документацию провайдера, список операций с балансом, модель игровых раундов, валюты и требования к отчетности. APIACE поможет выстроить запуск игры, ставки, выигрыши, отмены и финансовую сверку.