Шаг 1: создайте тестовый ключ
Ключи вы создаёте сами в бэкофисе, в Settings → Integration. У аккаунта может быть до двух тестовых ключей и до пяти боевых, а значение ключа показывается один раз, поэтому сохраните его при создании. Тестовый ключ начинается с wgc_test_ и может открывать демо-игры; боевой ключ открывает только игры на деньги. Каталог читается боевым ключом, потому что каталог тестового ключа показывает только тестовую игру.
Шаг 2: сыграйте в тестовую игру
Тестовый ключ открывает одну игру, WGC Test Slot: страницу с тремя размерами ставки и кнопкой Spin. Каждый спин делает два настоящих вызова на ваш Callback URL — ставку, а затем результат, — помеченных "test": true и заголовком X-WGC-Test: 1, чтобы ваш обработчик отличал их от реальной игры. Деньги не двигаются, комиссия не берётся, проводок нет. Тестовые строки видны на вкладке Test отчётов. Действуют ограничения: два спина в секунду на сессию и 2 000 спинов в сутки на аккаунт.
Шаг 3: проверьте подписи и ответы
Каждый вызов кошелька подписан HMAC-SHA256. Ваш обработчик должен проверять подпись по необработанному телу до разбора JSON, сравнивать за постоянное время и отклонять вызов, у которого метка времени старше пяти минут. Отвечать нужно за три секунды статусом от 200 до 299, а отказ — это { "ok": false, "error": "insufficient_funds" } со статусом 200. Проверьте неверную подпись, отсутствующую подпись и медленный ответ и запишите, что делает ваш обработчик в каждом случае. Эти записи помогают сравнивать при последующем сбое и показывать команде, что именно доказано.
Шаг 4: проверьте путь отказа
Интеграция кошелька определяется тем, как она ломается. На тестовой странице есть опция «потерять ответ». Операция становится неизвестной, и примерно через минуту на ваш Callback URL приходит rollback с причиной unknown_outcome. Используйте её, чтобы убедиться, что ваш обработчик отменяет ставку один раз, что повторный откат безвреден и что на откат ставки, которую вы никогда не проводили, вы отвечаете текущим балансом. WGC повторяет откат, который не приняли, до 30 суток, поэтому ваши записи об операциях должны храниться не меньше этого срока.
Шаг 5: запустите проверку интеграции
В бэкофисе Integration check запускает настоящую игру вашего аккаунта через ваш собственный кошелёк. Он показывает живой журнал запуска и каждого вызова getBalance, writeBet и rollback — с запросом и ответом — и вкладку для подписей. Используйте его с тестовым игроком. Если вызов не прошёл, журнал показывает, что отправил WGC и что вернул ваш кошелёк.
Шаг 6: запустите тест интеграции
Тест интеграции выполняет 14 проверок вашего кошелька и выдаёт вердикт по каждой: пройдено, работает, но рекомендуется исправить, или нужно исправить, — с подсказкой, что менять. Проверки охватывают чтение баланса, неверные и отсутствующие подписи, ставку, уменьшающую баланс, повторную транзакцию, которая не должна списываться дважды, выигрыш, ставку выше баланса, неизвестный тип, две равные ставки в один момент, откаты и время каждого ответа. Вызовы несут тестовый признак, а тест возвращает операции, которые принял ваш кошелёк, поэтому используйте его с тестовым игроком или тестовым кошельком. После прогона проверьте, что баланс игрока вернулся к исходному значению; если нет, окно предложит проверить его вручную.
Шаг 7: используйте открытые примеры
Обработчики Callback на Node.js, PHP и Python, скрипт самопроверки wallet-check.mjs и чек-лист запуска открыты и не требуют входа. Самопроверка отправляет на ваш адрес подписанные запросы так, как это делает WGC, включая повтор ставки и две одинаковые ставки одновременно, и печатает результат по пунктам. Она сдвигает баланс тестового игрока на небольшие суммы и возвращает его обратно, поэтому запускайте её только на тестовой среде, с тестовым игроком или тестовым кошельком. Не используйте её на аккаунтах реальных игроков.
Шаг 8: откройте демо-сессии настоящих игр
Выберите в каталоге игры с признаком демо и откройте их тестовым ключом в режиме демо:
POST /v1/sessions X-API-Key: wgc_test_… Idempotency-Key: open-0001
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}
→ 200 { "ok": true, "requestId": "req_…", "data": { "url": "https://play.worldgamingconnect.com/play/Zk3p9xQ2vL8mTn4r", "sessionId": "cmgq3r8v40001l8xyz5k2abcd", "expiresAt": "2026-10-12T10:45:00.000Z" } }Демо не двигает деньги и не отклоняется из-за нехватки баланса. Игра, не поддерживающая демо, отвечает invalid_request. В запуске используется и Idempotency-Key: тот же ключ и то же тело возвращают тот же ответ 24 часа, поэтому проверьте повторное открытие отдельным случаем.
Шаг 9: небольшой настоящий запуск
Откройте игру на деньги боевым ключом, с тестовым игроком и небольшой ставкой. Настоящему запуску нужны деньги на вашем коммерческом аккаунте: баланс плюс кредитный лимит должен быть больше нуля. В отчётах вкладка Rounds в основном виде должна показать ставку как принятую. Если вы не видите Rounds или Games, попросите менеджера включить их.
Чек-лист запуска
В открытом чек-листе 14 пунктов. Коротко:
- API-ключ хранится только на вашем сервере.
- Каталог синхронизируется полностью, затем по изменениям, а полная синхронизация — не реже раза в сутки.
- Игра открывается с вашего сервера, а ссылка — в браузере игрока.
- Callback URL публичный, и каждый ответ приходит за три секунды.
- Подпись и возраст метки времени проверяются по необработанному телу.
getBalanceиwriteBetотвечают так, как требует контракт, а отказ — это тело сok: false.writeBetзаписывается один раз наtransactionId, а неизвестный тип отклоняется.rollbackреализован и идемпотентен либо отвечает 404 или 405.- Неизвестные поля игнорируются.
- Самопроверка проходит на вашем тестовом адресе.
- Тест интеграции не показывает ни одной неудачной проверки.
- Работают демо-запуск, а затем небольшой настоящий запуск.
- Бот алертов подключён.
- Двухфакторная защита включена у каждого суперпользователя.
Помощь во время проверки
Ask WGC, ассистент в бэкофисе, отвечает по документации с источниками. При включённом праве на интеграцию его режим интеграции читает ограниченный снимок вашей собственной интеграции за последние семь суток, без секретов и тел запросов, и объясняет, почему ваши вызовы не проходят. Ассистент ничего не выполняет вместо вас; он только отвечает. Живая поддержка тоже в бэкофисе: когда пишете ей, укажите номер запроса, номер транзакции, номер раунда и время в UTC. См. демо и тестовый режим, шаги интеграции, контракт seamless-кошелька, бэкофис и обзор Casino API.