Валюта — это код
Где API принимает валюту, это код из 3–8 букв от A до Z, например USD или EUR. Тот же код встречается в запросе запуска, в каждом вызове кошелька и в записях ваших игроков. В каталоге валют платформы больше 50 валют, а ваш аккаунт использует выданные ему. Вы продаёте только те валюты, которые менеджер выдал вашему аккаунту. Поэтому читайте список по актуальным данным своего аккаунта, а не прописывайте его в собственном коде.
Валюты выдаются аккаунту
Валюты выдаются на аккаунт, как и игры, а подчинённый аккаунт не получает больше вышестоящего. Если открыть игру в валюте, которая не выдана, ответом будет currency_not_granted со статусом 400. Выдайте валюту аккаунту или отправьте одну из выданных. Ошибка приходит в момент запуска с понятным ответом; ваша платформа может перехватить её до того, как игрок увидит экран игры, и предложить подходящую валюту. Список выданных валют можно увидеть на странице Currencies в бэкофисе вместе с лимитами ставок по каждой.
Запрос каталога принимает необязательный параметр currency, который скрывает игры, не покрывающие эту валюту:
GET /v1/games?currency=EURБез него запрос возвращает все игры, выданные аккаунту, а валюта проверяется при открытии сессии. Валюта, которую аккаунт не продаёт, и здесь отклоняется кодом currency_not_granted, а не пустым каталогом. Так неверно написанный или несуществующий код не маскируется под пустой список и заметен сразу.
Игра может не открываться в какой-то валюте
Выданная валюта не означает, что в ней открывается каждая игра. У каждой игры в каталоге есть список unavailableCurrencies: валюты, в которых провайдер игры сейчас не открывает именно эту игру. Запуск в валюте из списка отклоняется сразу, а остальные валюты продолжают работать. Список может меняться, поэтому он приходит вместе с дельтой каталога, и ваша платформа может скрыть игру для этой валюты. Документация не обещает, что игра готова в каждой валюте, поэтому проверьте сочетания, которые планируете продавать. Сам запуск выглядит так, валюта — в теле:
POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}Валюта в кошельке
Кошелёк игрока остаётся в вашем казино, поэтому каждый вызов seamless-кошелька называет свою валюту:
{ "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" }Сумма — это число или строка с точкой. Одна операция может быть не больше 1 000 000 USD по курсу раунда; большая отклоняется до обращения к вашему обработчику. При курсе 1 524 песо за доллар это 1 524 000 000 песо. У баланса, который вы ведёте для игрока, другого потолка нет, поэтому игрок с 2 500 000 ARS играет как любой другой. Коммерческий баланс вашей компании с WGC — это другое: он ведётся в USD и не является доступным балансом игрока, поэтому не выводите одно из другого. Баланс игрока всегда остаётся записью вашего казино; до WGC доходит только то, что названо в вызовах, в указанной валюте и на указанную сумму.
От валюты игры к USD
WGC ведёт коммерческий аккаунт каждого клиента в USD. Раунд, сыгранный в другой валюте, пересчитывается в USD по курсу снимка на момент раунда, и пересчёт записывается вместе с раундом.
- Откуда берутся курсы. Сервер обновляет курсы к USD каждые 30 минут из публичного источника курсов, а последний удачный снимок остаётся действующим. Сам источник меняется раз в сутки.
- Валюту без курса продавать нельзя. Включить её в каталоге или выдать клиенту не получится, пока курса нет.
- Слишком старый курс отклоняет раунд. Раунд в валюте без свежего курса, старше 6 часов, отклоняется ещё до обращения к вашему казино, так что каждый раунд остаётся пересчитываемым в коммерческий баланс.
Коммерческий баланс хранится с шестью знаками после запятой, показывается с двумя и может быть отрицательным в пределах согласованного кредитного лимита. Ничего из этого не затрагивает деньги игрока: они остаются в вашем казино, в той валюте, которую вы выбрали. О кредитном лимите и истории каждой строки читайте в статье про коммерческий баланс.
Лимиты по валютам
Для каждой валюты задаются три значения: минимальная ставка, максимальная ставка и демо-баланс. Аккаунт с соответствующим правом может менять их в границах вышестоящего аккаунта. Лимиты, которые WGC отправляет провайдеру игры вместе с запуском, например RTP и границы ставок сессии, задаются отдельно, в Settings в разделе RTP & bets, и применяются только в играх, которые их принимают. Игра, которая их не принимает, их игнорирует, а запуск не отклоняется. Поэтому не путайте лимиты со страницы валют и лимиты сессии. Какие игры принимают значения, говорит каталог: rtpSettable и betLimitsSettable. Ваша платформа может смотреть на эти два признака и показывать функцию только в тех играх, где она работает.
Что видно в бэкофисе
Страница Currencies перечисляет валюты вашего аккаунта с переключателем включения и выключения, а касание строки открывает её лимиты. Страница FX rates показывает для каждой продаваемой вами валюты 1 USD = X и 1 CODE = Y USD, с днём, на который курс действует, и временем загрузки; клиент видит только свои валюты. При праве Reports ниже показан блок со ставками, выигрышами и прибылью по валютам, где каждый раунд пересчитан по собственному курсу, и таблица сессий с выгрузкой в CSV. См. страницу валют и бэкофис. Эти разделы помогают и после спора показать, по какому курсу посчитан каждый раунд.
Чек-лист для вашей команды
- Спросите у менеджера, какие валюты выданы вашему аккаунту, и сверьте их на странице Currencies.
- Запрашивайте каталог с
currencyили читайтеunavailableCurrenciesу каждой игры. - Храните валюту при каждом игроке и каждой транзакции в своих записях.
- Отвечайте на каждый вызов кошелька в той валюте, которую он называет.
- Откройте тестовым ключом игры, которые собираетесь продавать, в каждой валюте до реального трафика. Остальной поток — в обзоре Casino API.