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

Система управления букмекерской платформой — это рабочее место оператора, а не витрина для игроков. В ней восемь модулей: пользователи и роли, линия, купоны и статусы расчёта, финансы, лимиты и риски, интеграции, журнал операций и отчёты. Если хотя бы одного нет, оператор начинает делать его руками: в таблицах, в чатах с поддержкой, в правках базы данных. Именно это и ломается первым на загруженном вечере.
Половину данных для этих модулей бэк-офис не производит, а получает. Линия, рынки, статусы ставок, причины расчёта и история купонов приходят из 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 поставляет данные и статусы, оператор управляет людьми и деньгами.
Ошибки при проектировании бэк-офиса
- Сначала сайт, бэк-офис «потом». Потом — это первая спорная ставка, которую некому разобрать. Экран купонов и журнал нужны к первому реальному игроку.
- Выплата из
potential_win. До расчёта поле показывает возможный выигрыш; платить можно только изreal_win. - Один баланс на всё. Баланс партнёра в Coupon API и балансы игроков — разные сущности с разными владельцами.
- Ручные правки без журнала. Корректировка баланса без автора и причины превращает любой спор в слово против слова.
- Повторная выплата по повторному callback. Пакет может прийти дважды; уникальный индекс по
batchIdобязателен. - Одна роль на всех сотрудников. Поддержка не должна уметь менять лимиты, а риск-менеджер — выплачивать.
- Лимиты, которых нет в интерфейсе игрока. Если ставка отклоняется вашим лимитом, игрок должен видеть причину, а не «ошибка».
Как это собрано в платформе SportAPI под ключ
В букмекерской системе под ключ панель управления проектируется вместе с интерфейсом игроков и собирает ежедневные сценарии оператора в одном центре: пользователи и роли, купоны и статусы расчёта, настройки проекта, подключённые интеграции, журнал операций и отчётные разделы. Точный состав разделов определяется техническим заданием: для оператора с одной страной и двумя языками он один, для сети с несколькими брендами — другой.
Линия и расчёт ставок внутри платформы — те же Sport Line API и Coupon API, что и у разработчиков, которые собирают платформу сами. Поэтому список модулей выше одинаково подходит обоим: заказчику платформы — как чек-лист для обсуждения объёма, своей команде — как техническое задание. Если какой-то модуль вы решите строить сами, описание статусов и выплат в документации Coupon API — его основа.
Частые вопросы
Нужен ли бэк-офис, если я беру только спортбук-виджет?
Для виджета достаточно вашей текущей админки: виджет передаёт сайту события входа, купона и баланса, а аккаунты и деньги остаются у вас. Полноценный модуль купонов и отчётов понадобится, когда появятся собственные ставки через Coupon API.
Можно ли менять коэффициенты в бэк-офисе?
Нет. Коэффициенты приходят из линии, и ставка принимается только по коэффициенту линии: изменённое значение API не примет. Оператор управляет тем, что показывать, и лимитами, а не ценой.
Как разбирать спорные ставки?
По данным купона: статус ставки, settlement_reason_code, счёт на момент ставки и расчёта. Если корректировка всё же нужна, она делается проводкой в вашей системе с автором и причиной в журнале; сам итог расчёта в API не редактируется.
Какие отчёты требует регулятор?
Зависит от юрисдикции, и это вопрос к юристу оператора. Общее для всех: журнал операций с авторами, выгрузки по ставкам и выплатам за период и возможность показать историю конкретного игрока. Заложите экспорт в CSV с первого дня.
Сколько стоит система управления?
В платформе под ключ она входит в смету проекта, которая готовится после обсуждения модулей и интеграций. Если платформу собирает ваша команда, бэк-офис — её работа, а данные для него уже входят в Coupon API от $300 в месяц и линию от $30 в месяц за вид спорта.
С чего начать
Возьмите таблицу из восьми модулей и отметьте, что у вас уже есть, что даст API, а что придётся строить или заказывать. Обычно пробелы оказываются в журнале, ролях и отчётах — там, где нет готовых данных, зато есть люди. Если вы выбираете платформу под ключ, этот список и есть повестка первого разговора: напишите менеджеру SportAPI в Telegram, какие модули нужны вашей команде, и попросите показать, как они собраны.