SportAPI
Букмекерские платформы

Система управления букмекерской платформой: что должно быть в бэк-офисе

Восемь модулей бэк-офиса букмекерской платформы: пользователи и роли, линия, купоны и расчёт, финансы, лимиты, интеграции, журнал операций и отчёты. Что даёт API, а что остаётся у вас.

Монитор с панелью бэк-офиса букмекерской платформы: график оборота, live-матчи с коэффициентами, список пользователей и плитки модулей

Система управления букмекерской платформой — это рабочее место оператора, а не витрина для игроков. В ней восемь модулей: пользователи и роли, линия, купоны и статусы расчёта, финансы, лимиты и риски, интеграции, журнал операций и отчёты. Если хотя бы одного нет, оператор начинает делать его руками: в таблицах, в чатах с поддержкой, в правках базы данных. Именно это и ломается первым на загруженном вечере.

Половину данных для этих модулей бэк-офис не производит, а получает. Линия, рынки, статусы ставок, причины расчёта и история купонов приходят из API; на вашей стороне остаются люди, деньги и правила. Ниже — что должно быть в каждом модуле, откуда он берёт данные и какие ошибки проектирования дороже всего обходятся. В букмекерской системе под ключ от SportAPI эти модули собираются вместе с интерфейсом для игроков; если вы строите платформу на API сами, список ниже — ваше техническое задание.

Зачем бэк-офис, если ставки считает API

Автоматический расчёт закрывает один вопрос: выиграла ставка или нет. Он не отвечает на остальные. Кому разрешено ставить и сколько. Какие виды спорта показывать в этой стране. Что делать, когда игрок оспаривает итог. Кто из сотрудников имеет право изменить баланс и видно ли это потом. Как выглядел день в цифрах.

Все эти решения живут в бэк-офисе. Он не повторяет работу API, а оборачивает её правилами оператора: API говорит «купон 000000000272 выиграл 18,50», бэк-офис знает, кто этот игрок, не превысил ли он лимит, выплачен ли уже этот купон и кто проверял спорный случай. Поэтому у готовой платформы система управления проектируется вместе с интерфейсом игрока, а не прикручивается после запуска.

Восемь модулей и откуда они берут данные

МодульЧто делаетОткуда данные
Пользователи и ролиАккаунты игроков, сотрудники, права доступаВаша система
ЛинияКакие виды спорта, турниры и языки показывать; избранные матчиSport Line API
Купоны и статусы расчётаСписок ставок, их статусы, причины расчёта, перерасчётыCoupon API
ФинансыБалансы игроков, депозиты, выплаты, баланс партнёраВаша система + Coupon API
Лимиты и рискиМаксимальная ставка и выплата, политика изменения коэффициентовВаша система + настройки Coupon API
ИнтеграцииКлючи, callback, платёжные сервисы, состояние подключенийВаша система + метод account
Журнал операцийКто, что и когда изменилВаша система
ОтчётыОборот, выплаты, маржа, отказы, скорость расчётаВаша система на данных API

Дальше по каждому модулю: без чего он не работает.

Пользователи и роли

Два списка людей, которые нельзя смешивать: игроки и сотрудники.

Для игроков бэк-офис хранит профиль, статус верификации, историю ставок и платежей, ограничения (самоисключение, лимиты по запросу игрока) и признаки риска. Для сотрудников — роли с разными правами: поддержка видит купоны и историю, но не правит балансы; финансовый отдел подтверждает выплаты; риск-менеджер меняет лимиты; администратор управляет интеграциями и ключами. Каждое действие сотрудника пишется в журнал.

Минимум, который стоит заложить сразу: разделение ролей, двухфакторный вход для сотрудников и запрет на изменение баланса из того же экрана, где он просматривается. Ставки доступны совершеннолетним, а правила верификации задаёт регулятор страны, в которой работает оператор, поэтому поля профиля проектируются под конкретную юрисдикцию.

Линия: что показывать игрокам

Коэффициенты и рынки оператор не редактирует — они приходят из линии, и купон принимается по коэффициенту, который видел игрок. Поле управления здесь другое: что показывать и где.

  • Виды спорта и турниры. Линия отдаёт только то, что сейчас есть в подписке и в расписании: метод menu возвращает текущую иерархию «вид спорта → страна → турнир». Бэк-офис хранит исключения: какие турниры скрыть для этого рынка, какие вывести на главную.
  • Избранные матчи. Методы topmatches и topchampionships отдают готовые подборки топ-матчей и популярных чемпионатов для prematch и live; оператору остаётся выбрать, показывать ли их и где.
  • Языки. Названия команд, турниров и рынков приходят на языке запроса; список языков проекта — настройка, а не перевод вручную.
  • Заблокированные исходы. Поле oc_block закрывает исход в линии автоматически; бэк-офису достаточно следить, чтобы интерфейс не показывал кнопку.

Своей наценки в этой схеме нет: маржа уже внутри коэффициентов линии, а купон всегда принимается по коэффициенту линии — значение, изменённое на стороне оператора, API либо отклонит, либо заменит актуальным. Это ограничение, но оно же снимает с оператора целый отдел трейдинга.

Купоны и статусы расчёта

Самый нагруженный экран бэк-офиса. Поддержка открывает его десятки раз в день, поэтому в нём должно быть всё, что приходит с купоном: код, игрок, время, сумма, тип (ординар или экспресс), события с коэффициентами, статус купона и статус каждой ставки, причина расчёта, дата расчёта, сумма выплаты.

Статусы купона в Coupon API:

КодЗначениеИтоговый
0Активен или рассчитан частичноНет
2ВыигранДа
4ПроигранДа
8Полный возвратДа
15Возвращён на перерасчёт, ждите новый итогНет

У каждой ставки внутри купона свой статус: выигрыш, проигрыш, возврат, половина выигрыша, половина проигрыша, ожидание перерасчёта. Рядом со статусом — settlement_reason_code, устойчивый код причины: матч перенесён, отменён, возврат по правилам рынка. Это то, что поддержка показывает игроку вместо «так решила система».

Два правила, которые должны быть зашиты в экран. Выплата берётся только из real_win, никогда из potential_win. А статус 15 означает, что уже выплаченный купон будет пересчитан: бэк-офис показывает это отдельным состоянием, списывает ставку заново и ждёт новый итог. Как расчёт устроен изнутри и какие рынки он покрывает, описано в статье об автоматическом расчёте ставок.

Для истории и сверки API отдаёт купон по коду, список активных, рассчитанные за последние минуты и выборку по кодам (до 100 за запрос) или по периоду создания (до 24 часов). Этого достаточно, чтобы экран купонов не зависел от того, дошёл ли callback.

Финансы: деньги всегда в вашей системе

Балансы игроков, депозиты, выводы и выплаты не проходят через SportAPI ни в одном сценарии. Coupon API принимает ставку и возвращает статус, а деньги двигает ваша система. Из этого следует устройство финансового модуля:

  • баланс игрока меняется только по проводкам вашей системы: резерв при ставке, списание при приёме, выплата по real_win, возврат при отмене;
  • каждая проводка ссылается на coupon_code и, при расчёте, на batchId пакета callback — так повторная доставка пакета не создаёт вторую выплату;
  • отдельно от балансов игроков бэк-офис показывает баланс партнёра в Coupon API (GET /api/partner/balance): при его исчерпании новые купоны получают ошибку 507, и это должно быть видно до того, как игроки начнут жаловаться;
  • суммы хранятся в decimal, коды купонов — строкой, потому что 12-значный код может начинаться с нулей.

Платёжные провайдеры, комиссии и верификация подключаются под страну и оцениваются отдельно даже в платформе под ключ — это часть, которую оператор выбирает сам.

Лимиты и риски

Часть лимитов задаёт API, часть — вы. Экспресс содержит не больше 15 событий и не может включать две ставки на один матч, включая его таймы и угловые: такой купон получает 506. Политика изменения коэффициентов тоже настройка купона: reject — отклонить ставку при изменении и показать новую цену, accept с mode_type — принимать только рост, только снижение или любое изменение.

Остальное — правила оператора в бэк-офисе: максимальная ставка и максимальная выплата на купон, лимиты на игрока и на рынок, отдельные лимиты для live, стоп-лист событий. Полезный экран — «отказы за сегодня» по кодам ошибок 501–507: по ним видно, где игроки упираются в изменившиеся коэффициенты, а где — в ваши лимиты.

Интеграции

Этот модуль — для администратора, а не для поддержки. В нём лежат ключ линии, учётные данные партнёра Coupon API, адрес и секрет callback, настройки платёжных сервисов и состояние каждого подключения. Секреты хранятся на сервере и в интерфейсе не показываются целиком.

Состояние линии проверяется методом account: он возвращает условия ключа, виды спорта и языки подписки, ограничения по IP и сайтам, адрес, с которого идут запросы, и число запросов за последние 7 дней. Если на экране интеграций видны срок действия ключа и счётчик запросов, половина инцидентов «линия пропала» решается до звонка в поддержку.

Для callback нужны два индикатора: когда пришёл последний пакет и сколько пакетов повторилось. Повторы нормальны — API пересылает пакет при таймауте и ошибках сервера, — но обрабатываться они должны один раз по batchId.

Журнал операций

Журнал отвечает на вопрос «кто это сделал». В него попадают изменения балансов, лимитов, ролей и настроек, ручные корректировки, выплаты и отмены, входы сотрудников, изменения интеграций. У каждой записи — автор, время, объект, старое и новое значение.

Журнал нужен не только для споров с игроками. Это основа для любого внешнего аудита и единственный способ восстановить картину после инцидента, когда callback пришёл дважды, а сотрудник «поправил баланс вручную».

Отчёты

Минимальный набор, без которого оператор не управляет, а гадает:

ОтчётЧто показываетНа чём считается
Оборот и выплатыСуммы ставок и выплат по днямВаши проводки + real_win
МаржаСтавки минус выплаты по видам спорта, турнирам, рынкамСтатусы купонов и events_data
ОтказыДоля отклонённых купонов по кодам 501–507Ответы coupons/place
Скорость расчётаВремя между окончанием события и calculate_dateДанные купона
ПерерасчётыКупоны со статусом 15 и их итогСтатусы купонов
CallbackДоставленные, повторные и потерянные пакетыbatchId и ваш журнал
ИгрокиАктивные, новые, с лимитами, с самоисключениемВаша система

Отчёты строятся на данных, которые уже есть в купонах: вид спорта, турнир, рынок, коэффициент, счёт на момент ставки и расчёта. Ничего дополнительно запрашивать не нужно, достаточно сохранять купон целиком при приёме и при расчёте.

Что даёт API, а что остаётся в вашей системе

Приходит из SportAPIОстаётся у оператора
Линия: виды спорта, турниры, матчи, рынки, коэффициенты, блокировкиЧто из этого показывать в каждой стране
Приём ставки с проверкой коэффициентаЛимиты на игрока, рынок и купон
Статусы купона и ставок, причины расчёта, real_winВыплата и проводки по балансу игрока
Перерасчёт и callback с подписьюИдемпотентная обработка по batchId
Баланс партнёраБалансы игроков, депозиты, выводы
Условия ключа, ограничения, счётчик запросовСотрудники, роли, журнал, отчёты

Так граница проходит и в платформе под ключ: SportAPI поставляет данные и статусы, оператор управляет людьми и деньгами.

Ошибки при проектировании бэк-офиса

  1. Сначала сайт, бэк-офис «потом». Потом — это первая спорная ставка, которую некому разобрать. Экран купонов и журнал нужны к первому реальному игроку.
  2. Выплата из potential_win. До расчёта поле показывает возможный выигрыш; платить можно только из real_win.
  3. Один баланс на всё. Баланс партнёра в Coupon API и балансы игроков — разные сущности с разными владельцами.
  4. Ручные правки без журнала. Корректировка баланса без автора и причины превращает любой спор в слово против слова.
  5. Повторная выплата по повторному callback. Пакет может прийти дважды; уникальный индекс по batchId обязателен.
  6. Одна роль на всех сотрудников. Поддержка не должна уметь менять лимиты, а риск-менеджер — выплачивать.
  7. Лимиты, которых нет в интерфейсе игрока. Если ставка отклоняется вашим лимитом, игрок должен видеть причину, а не «ошибка».

Как это собрано в платформе SportAPI под ключ

В букмекерской системе под ключ панель управления проектируется вместе с интерфейсом игроков и собирает ежедневные сценарии оператора в одном центре: пользователи и роли, купоны и статусы расчёта, настройки проекта, подключённые интеграции, журнал операций и отчётные разделы. Точный состав разделов определяется техническим заданием: для оператора с одной страной и двумя языками он один, для сети с несколькими брендами — другой.

Линия и расчёт ставок внутри платформы — те же Sport Line API и Coupon API, что и у разработчиков, которые собирают платформу сами. Поэтому список модулей выше одинаково подходит обоим: заказчику платформы — как чек-лист для обсуждения объёма, своей команде — как техническое задание. Если какой-то модуль вы решите строить сами, описание статусов и выплат в документации Coupon API — его основа.

Частые вопросы

Нужен ли бэк-офис, если я беру только спортбук-виджет?

Для виджета достаточно вашей текущей админки: виджет передаёт сайту события входа, купона и баланса, а аккаунты и деньги остаются у вас. Полноценный модуль купонов и отчётов понадобится, когда появятся собственные ставки через Coupon API.

Можно ли менять коэффициенты в бэк-офисе?

Нет. Коэффициенты приходят из линии, и ставка принимается только по коэффициенту линии: изменённое значение API не примет. Оператор управляет тем, что показывать, и лимитами, а не ценой.

Как разбирать спорные ставки?

По данным купона: статус ставки, settlement_reason_code, счёт на момент ставки и расчёта. Если корректировка всё же нужна, она делается проводкой в вашей системе с автором и причиной в журнале; сам итог расчёта в API не редактируется.

Какие отчёты требует регулятор?

Зависит от юрисдикции, и это вопрос к юристу оператора. Общее для всех: журнал операций с авторами, выгрузки по ставкам и выплатам за период и возможность показать историю конкретного игрока. Заложите экспорт в CSV с первого дня.

Сколько стоит система управления?

В платформе под ключ она входит в смету проекта, которая готовится после обсуждения модулей и интеграций. Если платформу собирает ваша команда, бэк-офис — её работа, а данные для него уже входят в Coupon API от $300 в месяц и линию от $30 в месяц за вид спорта.

С чего начать

Возьмите таблицу из восьми модулей и отметьте, что у вас уже есть, что даст API, а что придётся строить или заказывать. Обычно пробелы оказываются в журнале, ролях и отчётах — там, где нет готовых данных, зато есть люди. Если вы выбираете платформу под ключ, этот список и есть повестка первого разговора: напишите менеджеру SportAPI в Telegram, какие модули нужны вашей команде, и попросите показать, как они собраны.

← Все статьи