API live-казино для операторов

Игры с live-дилерами — один из трёх разделов каталога WGC, рядом со слотами и спортом. Для вашей платформы они открываются и оплачиваются тем же API, что и игры любого другого типа, поэтому команда, которая уже подключила слоты (см. API слотов), уже сделала большую часть того, что нужно для live-казино. Весь интерфейс кратко описан в обзоре Casino API. Балансы игроков остаются в вашем казино. Эта страница по порядку объясняет, что входит в интеграцию live-казино.

Игры с live-дилерами в каталоге

Каталог провайдеров перечисляет 184 студии и содержит отдельный раздел live-дилеров. В API live-игры имеют тип live_dealers. Запрос игр можно отфильтровать по этому типу и по вашей валюте, и он возвращает игры, выданные вашему аккаунту: по 200 на страницу, у каждой — постоянный publicId, universalId, адрес картинки и признаки возможностей.

Игры студии выдаёт вашему аккаунту ваш менеджер WGC. Студия, перечисленная в справочнике, не становится автоматически открытой для каждого клиента. Ваша платформа видит и может открыть только те игры, которые ей выданы.

Как открыть live-стол

Ваш сервер просит WGC открыть игру игроку, передавая идентификатор игрока, валюту, режим и номер игры. Можно добавить платформу (десктоп или мобильная), страну игрока, язык и ваш собственный идентификатор сессии; эти поля необязательны, а обязательны только идентификатор игрока, валюта, режим и номер игры. WGC отвечает ссылкой запуска для браузера игрока.

Неоткрытая ссылка работает пять минут. После открытия она работает, пока игрок активен, а после закрытия сессии отвечает понятной страницей вместо ошибки. Ссылку можно разместить во фрейме; используйте во фрейме allow="fullscreen; autoplay". Адрес возврата возвращает игрока в ваше лобби, но не каждая игра его принимает, поэтому предусмотрите на своей странице собственный выход из фрейма.

Ограничения, которые стоит ожидать

Каждая игра перечисляет свои запрещённые страны, а запуск из известной запрещённой страны отклоняется. Если страну определить нельзя, игра открывается, поэтому сохраняйте собственную географическую проверку. Игра, недоступная в какой-то валюте, помечена в каталоге, и запуск в этой валюте отклоняется, а остальные валюты продолжают работать. Эти ограничения видны по каждой игре в каталоге, так что лобби можно подготовить заранее.

Вызовы кошелька во время live-раундов

Live-игры используют модель seamless-кошелька: WGC обращается к вашему Callback URL, чтобы прочитать баланс и записать ставки и выигрыши. Ставка и выигрыш могут прийти одним вызовом. Когда студия сообщает их раздельно, WGC сводит их в один раунд с идентификатором раунда.

Ваш ответ ожидается в течение трёх секунд. Если он не получен вовремя, ставка отклоняется студии, операция получает статус «неизвестно», а затем WGC просит вас отменить её откатом (rollback). Ставка, которая ждала внутри WGC дольше полутора секунд, вам не отправляется вообще, так что с игрока ничего не списывается. Повторные вызовы записываются один раз на идентификатор транзакции; иными словами, повторный приход того же вызова не создаёт вторую запись на счёте игрока.

Как найти раунд

После раунда ваша платформа может запросить операцию, раунд или сессию по своим собственным номерам; чужой номер выглядит как несуществующий. Раунд сообщает ставку, выигрыш и разницу. Запросы покрывают последние 65 суток; более старые события уходят в архив, который WGC просматривает по запросу. Действия раунда описаны простыми словами WGC, а список открытый: незнакомый код читайте как информацию и не принимайте по нему решений о деньгах.

Проверьте до запуска в работу

Открытие игры в демо-режиме с тестовым ключом не двигает деньги. WGC Test Slot делает настоящие вызовы на ваш Callback URL, поэтому подписи, ответы и откат можно проверить до настоящей игры. Так вы увидите весь путь от начала до конца ещё до первого реального игрока. Весь путь описан на странице интеграции и в разделе демо и тестовый режим.

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

Какой тип API у игр с live-дилерами?

live_dealers. Запрос игр можно отфильтровать по нему.

Нужна ли для live-игр другая интеграция кошелька?

Нет. Они используют тот же Callback, что и слоты.

Можно ли поместить live-игру во фрейм?

Да. Ссылку запуска можно разместить во фрейме; для игр, не принимающих адрес возврата, предусмотрите собственный выход на странице.

Что будет, если мой кошелёк ответит поздно?

Ставка отклоняется студии и отменяется откатом (rollback).

Планируете live-контент? Обсудить подключение.

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

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

Связаться