Начните с владельца баланса
В модели кошелька с колбеками, которую использует WGC, кошелёк игрока хранит платформа казино. WGC обращается к вашей платформе за балансом или за результатом игровой транзакции. WGC не хранит кошельки игроков; единственное исключение — демо-клиент, которого создаёт сотрудник WGC и который использует тестовый кошелёк.
Идентификатор игрока определяет игрока в собственной системе казино и представляет собой строку из 1–64 печатаемых ASCII-символов. Это не коммерческий аккаунт, через который вы получаете доступ к WGC. Согласуйте эту границу первой, чтобы обе команды знали, какая система главная, когда запрос не прошёл или сумма оспаривается. Без такой договорённости каждое расхождение заставляет заново сверять записи двух команд с нуля.
Проследите транзакцию по системам
Типичной интеграции нужны проверка баланса и способ записать ставку и её результат. Контракт колбеков WGC называет три команды: getBalance — прочитать баланс, writeBet — записать ставку вместе с выигрышем одним запросом и rollback — отменить ставку. Когда студия присылает ставку и результат раздельно, WGC объединяет их в один раунд с идентификатором раунда, и оба вызова идут внутри него.
Храните вместе в своих записях ссылки на игрока, валюту, игру, раунд и транзакцию. Ссылка запуска — это лишь точка входа в игру; она не подтверждает, что проверка баланса или расчёт завершены. Поэтому в обращениях в поддержку опирайтесь на номера транзакции и раунда, а не только на ссылку запуска.
Считайте повтор той же транзакцией
Сетевой таймаут может случиться после того, как операция принята, но до того, как ответ дошёл до вызывающей стороны. Слепой повтор такой операции может дважды списать деньги с игрока. Идемпотентный обработчик узнаёт тот же идентификатор транзакции и возвращает записанный результат вместо повторного применения сумм. В WGC это условие интеграции: writeBet записывается один раз на идентификатор транзакции, а повторный вызов возвращает тот же баланс.
У таймаутов тоже есть правила. WGC ждёт ваш ответ три секунды, и ответ засчитывается только со статусом 2xx. Если ответа вовремя нет, ставка отклоняется студии, операция становится неизвестной и следует откат. Откат повторяется по расписанию до 30 суток, поэтому храните свои записи об операциях не меньше этого срока.
Включите в приёмочные тесты одновременные дубли, задержанные ответы и повтор после таймаута. Повторы открытия сессии — отдельный контракт, и считать, что кошелёк работает так же, не нужно. Если разнести два контракта по разным сценариям тестов, проще найти источник ошибок.
Явно записывайте валюту и суммы
Кошелёк игрока может использовать валюту, отличную от коммерческого аккаунта оператора. Каждая операция должна указывать свою валюту и следовать согласованным правилам точности. Сумма — это число или строка с точкой, а одна операция может быть не больше миллиона USD по курсу раунда.
Коммерческий баланс с WGC ведётся в USD и не является доступным балансом игрока. Не выводите одно из другого. Не считайте также, что валюта, показанная в бэкофисе, поддерживается каждой игрой: игра, которая не открывается в какой-то валюте, помечена в каталоге. Подтвердите нужные сочетания до тестов; тогда отказ в тесте может оказаться ограничением сочетания, а не ошибкой кошелька.
Проверяйте отказы, а не только удачную игру
Подготовьте проверки для самых важных случаев:
- Недостаточно средств. Отказ записывается в теле ответа, например с ошибкой о недостатке средств и статусом 200.
- Неизвестный игрок или неподдерживаемая валюта.
- Неверная подпись. Каждый вызов подписывается HMAC-SHA256; проверяйте подпись по необработанному телу, сравнивайте за постоянное время и отклоняйте вызовы старше пяти минут.
- Задержанный ответ и повторная доставка.
Храните в своих записях ссылку на транзакцию и номер запроса для поддержки и сверяйте принятые транзакции с обеих сторон, а не только итоговые балансы.
Сухой прогон может проверить форму сообщения, но не может доказать, что реальная студия и ваш кошелёк вместе проводят расчёты правильно. Для репетиции тестовый ключ открывает тестовую игру, которая делает настоящие вызовы к вашему Callback URL без денег, а опция потери ответа проверяет ваш откат. В бэкофисе проверка интеграции показывает живой журнал каждого вызова, а тест интеграции выполняет 14 проверок вашего кошелька.
Подтвердите готовность каждого подключения
У WGC есть контракт колбеков и тестер для подготовки этой работы, а Callback-кошелёк работает. Примеры обработчиков для Node.js, PHP и Python и чек-лист запуска из 14 пунктов открыты. Готовность каждого подключения всё равно подтверждается отдельно для проекта: обсудите с командой интеграции поддерживаемый сценарий, политику отказов и критерии приёмки. Данные для доступа менеджер передаёт лично; на открытых страницах их нет.
Полный контракт — на странице seamless-кошелька, а шаги рядом — на странице интеграции, в демо и тестовом режиме и в обзоре Casino API.