Кто кого вызывает
Направлений два. Ваш сервер вызывает WGC, чтобы открыть игру и чтобы узнать, что стало с операцией. WGC вызывает ваш Callback URL за балансом игрока и за каждой ставкой и каждым выигрышем, потому что в модели seamless-кошелька деньги игрока остаются в вашем казино, а WGC не хранит баланс игрока. Вызовов кошелька три: getBalance, writeBet и rollback. Если держать направление в голове, большая часть раунда становится понятной: первый шаг начинаете вы, на шагах со второго по четвёртый WGC спрашивает вас, а последний шаг — это вы спрашиваете WGC. Если в раунде что-то пошло не так, сначала посмотрите, какого вызова в каком направлении не хватает.
Шаг 1: запуск
Ваш сервер вызывает POST /v1/sessions с идентификатором игрока, валютой, режимом и номером одной игры. В ответе приходят ссылка запуска и идентификатор сессии.
POST /v1/sessions
{"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" } }Идентификатор игрока — от 1 до 64 печатаемых ASCII-символов, он называет игрока в вашей собственной системе. Ссылку открывают в браузере игрока, а не запрашивают с вашего сервера. Ссылка, которую ни один браузер не открыл, работает 5 минут; после открытия она живёт, пока игрок продолжает играть. На этом шаге вы ничего не отвечаете: вызов делаете вы и получаете ответ сразу. Открытие игры из лобби вашего казино тоже относится к этому шагу.
Шаг 2: баланс
Когда игра стартует, она запрашивает баланс игрока, и WGC отправляет getBalance на ваш Callback URL.
{ "command": "getBalance", "playerId": "casino-side-player-42", "currency": "USD", "requestId": "req_…", "timestamp": "2026-10-12T10:15:00.500Z" }
← { "ok": true, "balance": 123.45, "currency": "USD" }Каждый вызов подписан, и подпись вы проверяете по необработанному телу до его разбора. Отказ записывается в теле, например { "ok": false, "error": "insufficient_funds" }, со статусом 200. Ответ с балансом определяет, какой баланс игра покажет игроку, поэтому значение должно быть актуальным балансом из вашей собственной системы.
Шаг 3: ставка
Игрок нажимает «вращать», и WGC отправляет writeBet со ставкой больше нуля и выигрышем ноль. В вызове — новый transactionId и roundId.
{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:01.000Z" }
← { "ok": true, "balance": 122.45 }Вы списываете деньги с игрока один раз на этот transactionId и отвечаете новым балансом. Если вы отказываете, ничего не списывается и раунд дальше не идёт. Номер транзакции с этого шага — ключ к распознаванию повторов и возможного отката, поэтому сохраните его в своих записях. kind — play или refund, а jackpot — только после того, как ваш менеджер включил джекпоты для вашего аккаунта.
Шаг 4: результат
Результат приходит ещё одним writeBet с тем же roundId: новый transactionId, ставка ноль и выигрыш, равный выплате.
{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 0.00, "win": 2.50, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "9a1d7c33-52b8-4f0e-8c64-2d7e0b5a1f93", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:02.000Z", "roundFinished": true }
← { "ok": true, "balance": 124.95 }Некоторые игры присылают ставку и результат одним вызовом. Другие присылают их раздельно, и WGC сводит их в один раунд, так что оба вызова идут под одним roundId. roundFinished: true отмечает конец раунда, а когда ключа нет, раунд считается ещё открытым. Выигрыш зачисляется один раз на идентификатор транзакции, и вы отвечаете новым балансом.
Шаг 5: нет ответа в срок
WGC ждёт ваш ответ 3 секунды, и ответ засчитывается только со статусом 2xx. Если ответа нет вовремя или его нельзя прочитать, ставка отклоняется провайдеру игры, а операция получает статус unknown: WGC не знает, провели ли вы её. От вас пока ничего не требуется. Внутри WGC действуют два более коротких срока: ставка, которая ждала дольше 1,5 секунды до вашего Callback, вам не отправляется, и у игрока ничего не списывается; принятая ставка, ответ на которую не дошёл до провайдера игры за 4,5 секунды, сразу отменяется откатом.
Шаг 6: откат
После неизвестного исхода WGC отправляет rollback на тот же адрес с тем же transactionId.
{ "command": "rollback", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "reason": "unknown_outcome", "requestId": "rb:5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b:1", "timestamp": "2026-10-12T10:16:01.000Z" }
← 200 { "balance": 123.45 }Если вы провели этот transactionId, вы отменяете его целиком: ставка возвращается, выигрыш забирается. Если никогда не проводили, ничего не меняете и всё равно отвечаете балансом. Причина — unknown_outcome, когда ваш ответ так и не дошёл до WGC; у провайдера игры, который отменяет уже рассчитанную транзакцию, своя причина. WGC повторяет откат, который не приняли: примерно через минуту после пропавшего ответа, затем через 5, 15, 60, 360 и 1 440 минут, а потом раз в сутки, пока не пройдёт 30 суток со ставки. Поэтому храните свои записи об операциях не меньше 30 суток. Казино может также ответить 404, 405 или unknown_command, показывая, что не реализует откаты, и это не ошибка. Подробности отката и безопасный приём повторов — в статье про идемпотентность и повторы в кошельке.
Шаг 7: сверка
В любой момент ваш сервер может спросить WGC, что тот записал, по номерам, которые видело ваше казино.
GET /v1/rounds/3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41
→ 200 { "ok": true, "requestId": "req_…", "data": { "roundId": "3f1c2a64-…", "status": "closed", "bet": "1.00", "win": "0.00", "ggr": "1.00", "transactions": [ { "transactionId": "5f0b1c2e-…", "status": "accepted", "balance": "122.45", … } ], "actions": ["bet","no_win"], … } }У операции статус accepted, refused, failed или unknown, а раунд показывает ещё ggr — ставку минус выигрыш. Список actions словами самой WGC говорит, что произошло, например bet, win, no_win или rollback; незнакомый код читайте как информацию и не принимайте по нему денежных решений. Запросы доходят на 65 суток назад; более старые события лежат в архиве WGC и ищутся вручную по просьбе. Номер чужого аккаунта читается так же, как номер, которого нет.
Репетиция раунда без денег
Тестовый ключ открывает тестовую игру WGC Test Slot, где каждый спин делает два настоящих вызова на ваш Callback URL — ставку, а затем результат — с пометкой "test": true. Деньги не двигаются. Опция «потерять ответ» проверяет ваш откат: операция становится unknown, и примерно через минуту приходит rollback. В бэкофисе Integration check показывает каждый вызов вживую, а тест интеграции выполняет 14 проверок вашего кошелька. См. демо и тестовый режим, шаги интеграции и обзор Casino API.