Интеграция seamless-кошелька для платформ казино

В модели seamless-кошелька деньги игрока остаются на стороне казино. WGC не хранит кошельки игроков: когда игре нужен баланс или нужно записать ставку, WGC отправляет подписанный запрос вашей платформе и использует ваш ответ. Эта страница объясняет контракт практическими словами для команды, которая пишет обработчик: сначала модель, затем правила подписи и таймаутов, в конце — инструменты проверки.

Как работает модель

Игроки и балансы живут на вашей платформе. WGC отправляет POST-запросы на зарегистрированный вами Callback URL с тремя командами: getBalance — прочитать баланс, writeBet — записать ставку и её выигрыш, rollback — отменить ставку. Единственное исключение — демо-клиент, которого создаёт персонал WGC и которому доступен тестовый кошелёк WGC.

writeBet несёт ставку и выигрыш одним вызовом. Когда студия сообщает ставку и результат раздельно, WGC сводит их в один раунд с идентификатором раунда, и оба вызова идут внутри него. Вид операции — play, refund или, при включённых джекпотах, jackpot, а признак завершения раунда отмечает конец раунда.

Идемпотентность — часть контракта

Ваш обработчик должен записывать writeBet один раз на transactionId. Повторный вызов не должен списывать с игрока дважды и должен вернуть тот же баланс. Это условие интеграции, а не необязательное дополнение: сбои сети делают повторы обычным делом, и повторный приход той же операции — нормальная ситуация.

Подписи

Каждый вызов подписан HMAC-SHA256 секретом вашего аккаунта. Доступны два заголовка: подпись по телу и вторая подпись по метке времени, соединённой с телом, вместе с самой меткой времени. Новая интеграция должна проверять вторую. Проверяйте подпись по сырому телу до разбора JSON, сравнивайте за постоянное время и отклоняйте вызовы старше пяти минут. В документации есть примеры подписи с тестовым секретом, чтобы вы могли сверить собственный код проверки. См. также безопасность.

Таймауты, повторы и откат

WGC ждёт ваш ответ три секунды. Ответ засчитывается только со статусом 2xx. Отказ выражается в теле, например ошибкой недостатка средств со статусом 200, а перенаправления не выполняются. Если ответа в срок нет, ставка отклоняется студии, операция получает статус «неизвестно» и приходит откат (rollback).

Откат просит вас отменить ставку целиком: вернуть ставку и забрать выигрыш. WGC повторяет его примерно через минуту, затем через 5, 15, 60, 360 и 1 440 минут, а далее раз в сутки до 30 суток от ставки. Ваша платформа хранит записи об операциях не меньше 30 суток. Поддержка команды rollback для вас необязательна; ответ «не найдено» или «не разрешено» на эту команду тоже не считается ошибкой.

Есть и другие границы, о которых стоит знать. Ставка, которая ждала внутри WGC дольше полутора секунд, вам не отправляется, и с игрока ничего не списывается. Одна операция не может превышать один миллион USD по курсу раунда.

Адрес Callback

Используйте, по возможности, публичный адрес https://. Приватные и loopback-адреса отклоняются при сохранении, используются только порты 443 и 80, а ваш ответ не должен превышать 64 КБ. Адреса, с которых WGC делает свои вызовы, сообщаются вам заранее, и о любой смене этих адресов вас предупреждают до того, как она произойдёт.

Проверьте свой обработчик

Примеры и самопроверка публичны и не требуют входа: обработчики на Node.js, PHP и Python, скрипт проверки и чек-лист запуска из 14 пунктов. В бэкофисе тест интеграции выполняет 14 проверок вашего кошелька и подсказывает, что исправить, а проверка интеграции показывает живой журнал каждого вызова с запросом и ответом.

В тестовом режиме есть опция «потерять ответ», которая проверяет ваш откат: операция становится «неизвестной», а через минуту приходит rollback. Подробнее — в разделах демо и тестовый режим и шаги интеграции.

После раунда

Ваша платформа также может запросить операцию, раунд или сессию по своим собственным номерам. У операции статус «принята», «отклонена», «сбой» или «неизвестна». Для отчётов WGC хранит статус, время ответа и первые 1 024 символа вашего ответа. Посмотрите Casino API, обзор агрегатора игр и статью про seamless-кошелёк.

Вопросы и ответы

Хранит ли WGC балансы игроков?

Нет. Балансы остаются на вашей платформе; WGC обращается к вашему Callback URL.

Что будет, если мой сервер медленный?

Через три секунды ставка отклоняется студии, а позже отменяется откатом.

Обязательна ли команда rollback?

Нет. Ваш обработчик не обязан её поддерживать; поддержка необязательна.

Как проверить обработчик?

Используйте публичные примеры, скрипт самопроверки и тестовый режим; тест интеграции в бэкофисе тоже подскажет, что исправить.

Готовы подключить кошелёк? Обсудить подключение.

Следующее подключение
начинается здесь.

Расскажите, что вы создаёте. Начнём с этого.

Связаться