Спортбук через iFrame: как встроить раздел ставок в существующий сайт и что проверить до запуска
Что такое Sportsbook iFrame, как встроенный раздел ставок связан с вашими аккаунтами, сессиями и балансами, где принимаются и рассчитываются ставки и какие 12 пунктов проверить до включения.

Sportsbook iFrame — это готовый раздел ставок с событиями, рынками, коэффициентами и купоном, который загружается внутри страницы вашего сайта. Интерфейс вы не разрабатываете. Вы добавляете контейнер и скрипт-загрузчик, сообщаете встроенному спортбуку, кто игрок, обрабатываете несколько событий и связываете приём ставок со своим кошельком. Сайт, аккаунты и деньги остаются вашими.
Поэтому это самый быстрый способ добавить ставки на спорт в продукт, у которого уже есть пользователи: онлайн-казино, спортивный портал, сайт прогнозов, новый проект, проверяющий спрос. По той же причине его легко запустить плохо: встроенная часть работает с первого дня, а всё вокруг неё — сессии, балансы, согласие, мобильная вёрстка — делать вам. В статье — как собрана интеграция и 12 вещей, которые нужно проверить до запуска. Примеры относятся к спортбук-виджету SportAPI; его можно сначала попробовать в живой демонстрации.
Что на практике называют Sportsbook iFrame
Три названия описывают одно и то же. Спортбук-виджет — это продукт. Bet Embed — формат поставки. Sportsbook iFrame — привычный для отрасли термин: «спортбук, который кто-то другой рисует внутри моей страницы».
На практике это редко голый <iframe src="…">. Современный встроенный спортбук загружается скриптом-загрузчиком в контейнер на вашей странице, потому что обычный фрейм не умеет того, что нужно разделу ставок: подстраиваться по высоте, просить сайт авторизовать игрока, сообщать, что купон изменился, узнавать, что изменился баланс. Загрузчик всё это настраивает; рисует ли он внутри фрейм — деталь реализации.
Что вы получаете внутри контейнера:
- предстоящие события с расписанием, участниками, рынками и текущими коэффициентами;
- раздел live со счётом, периодом, статусом матча и обновляемыми коэффициентами;
- основные и дополнительные рынки с параметрами;
- купон для ординаров и экспрессов;
- адаптивную вёрстку для компьютера и телефона;
- интерфейс и данные на языках, включённых для проекта.
Как собрано встраивание
С вашей стороны странице нужны две вещи — контейнер и загрузчик:
<!-- шапка, вход и баланс остаются вашими -->
<main>
<h1>Ставки на спорт</h1>
<div id="sportsbook" style="min-height: 720px"></div>
<!-- сюда вставляется фрагмент загрузчика с параметрами вашего проекта -->
</main>
При инициализации сайт передаёт виджету небольшой набор значений:
| Параметр | Зачем нужен | Откуда берётся |
|---|---|---|
| Идентификатор проекта | Сообщает виджету, какой проект и настройки загрузить | Выдаёт менеджер |
| Разрешённый домен | Виджет работает только на доменах, зарегистрированных для проекта | Называете вы: основной, www, мобильный, тестовый |
| Язык | Язык интерфейса и данных | Локаль вашей страницы |
| Режим спортбука | Какой раздел открыть | Контекст вашей страницы |
| Токен сессии клиента | Определяет вошедшего игрока, когда нужна сессия | Ваш backend |
Точный фрагмент загрузчика и имена параметров приходят с кодом встраивания проекта от менеджера; техническая инструкция по виджету ещё готовится, поэтому воспринимайте таблицу как список решений, а не как справочник API. Ни одно из решений не сложное, но каждое нужно принять до запуска: какие домены, какие языки, можно ли смотреть линию без входа.
Четыре события, которые должен обработать ваш сайт
Виджет рисует спортбук, а источником истины остаётся ваш сайт. Общаются они через события:
| Событие от виджета | Что делает ваш сайт |
|---|---|
| Требуется вход | Открывает вашу форму входа или регистрации и затем передаёт токен сессии |
| Купон изменился | При необходимости обновляет интерфейс (счётчик в шапке, аналитика) |
| Обновление баланса | Обновляет баланс в шапке |
| Сессия истекла | Выдаёт свежий токен или отправляет игрока на вход |
Большинство ошибок интеграции живёт в этой таблице. Виджет, который просит войти, пока сайт ничего не делает, для игрока выглядит сломанным, хотя сам виджет в порядке. По каждому событию решите, что увидит игрок, и проверьте каждое руками.
Авторизация: как передать игрока в виджет
Виджет никогда не видит пароль и не должен видеть вашу основную сессионную cookie. Backend выдаёт короткоживущий токен для вошедшего игрока, а страница передаёт его виджету при инициализации. Схема выглядит так:
// GET /api/sportsbook-session: короткоживущий токен для вошедшего игрока
app.get('/api/sportsbook-session', requireUser, (req, res) => {
const token = jwt.sign(
{ sub: String(req.user.id), currency: req.user.currency },
process.env.SPORTSBOOK_SESSION_SECRET, // остаётся на сервере
{ expiresIn: '10m' },
);
res.json({ token });
});
Формат токена и точный порядок работы с сессией согласуются при технической интеграции, поэтому код показывает форму решения: токен выдаёт ваш сервер, он привязан к одному игроку, живёт минуты и обновляется, когда виджет сообщает об истёкшей сессии. Анонимный посетитель токена не получает и может смотреть линию; виджет попросит войти, когда он попробует поставить.
Ставки и деньги: что делает виджет, а что ваш сервер
Виджет даёт купон. Приём ставки и её расчёт идут через Coupon API — сервис приёма и расчёта ставок, а кошелёк ваш:
- Игрок подтверждает купон в виджете.
- Ваш сервер проверяет баланс и лимиты и резервирует сумму.
- Ставка создаётся через Coupon API, который в этот момент перепроверяет коэффициент и доступность каждого исхода. Запрос описан в разделе размещение купона.
- Если коэффициент изменился, ставка отклоняется или принимается по новой цене — в зависимости от выбранного режима.
- После матча купон рассчитывается автоматически, и ваш сервер получает подписанный callback.
- Сервер выплачивает по итогу и сообщает виджету, что баланс изменился.
Балансы игроков, депозиты, выводы и выплаты не покидают вашу платформу. В этом главное отличие встроенного спортбука от отправки пользователей на чужой сайт ставок: клиент, деньги и данные остаются у вас.
Что проверить до запуска
- Домены. Все домены, на которых будет работать виджет, зарегистрированы для проекта: основной,
www, мобильный поддомен, тестовый. - Размер контейнера. У контейнера задана минимальная высота, и на телефоне у страницы не появляется вторая полоса прокрутки.
- Языки. Язык виджета следует за языком страницы, и спортивные данные на этом языке есть в вашем проекте.
- Вход. Анонимный посетитель при попытке поставить видит вашу форму входа и возвращается к тому же купону.
- Истечение сессии. Оставьте вкладку открытой дольше срока жизни токена и сделайте ставку. Игрока не должно молча выбросить.
- Баланс. Баланс в шапке меняется после приёма ставки и ещё раз после расчёта.
- Изменение коэффициентов. Поставьте в live, пока коэффициенты движутся, и убедитесь, что игрок видит новую цену или понятный отказ.
- Content Security Policy. Если сайт отправляет заголовок CSP, хост виджета разрешён для скриптов, фреймов и соединений.
- Согласие и возраст. Спортбук загружается после подтверждения возраста и выбора cookies, а не до.
- Скорость. Загрузчик не блокирует страницу: он подключается после основного содержимого, а контейнер резервирует высоту, чтобы вёрстка не прыгала.
- Собственный контент. У страницы есть свой заголовок и текст. То, что внутри виджета, для поисковиков не является текстом вашей страницы.
- Сбой. Если загрузчик не скачался, игрок видит сообщение и кнопку повтора, а не пустой прямоугольник.
Двум пунктам нужна строка настройки. Для CSP добавьте хост из кода встраивания в нужные директивы:
Content-Security-Policy: script-src 'self' https://WIDGET_HOST; frame-src https://WIDGET_HOST; connect-src 'self' https://WIDGET_HOST
Для скорости загружайте спортбук, когда контейнер приближается к видимой области:
const box = document.getElementById('sportsbook');
new IntersectionObserver((entries, observer) => {
if (!entries[0].isIntersecting) return;
observer.disconnect();
// сюда вставляется фрагмент загрузчика из кода встраивания
}, { rootMargin: '300px' }).observe(box);
Виджет, API или платформа под ключ
Встроенный спортбук — один из трёх способов получить продукт для ставок, и он правильный в конкретной ситуации:
| У вас есть | Вам нужно | Берите |
|---|---|---|
| Сайт с пользователями и своими аккаунтами | Раздел ставок в этом месяце | Спортбук-виджет |
| Команда разработки и идея продукта | Свой интерфейс и сценарии | Линию и Coupon API |
| Рынок и бизнес-модель, разработчиков нет | Готовый продукт с бэк-офисом | Платформу под ключ |
Компромисс виджета — интерфейс: это интерфейс виджета на ваших языках внутри вашей страницы, а не собственный дизайн. Многие проекты начинают со встраивания, чтобы проверить спрос, и позже переходят на свой фронтенд; данные и обработка ставок под ним остаются теми же. Полное сравнение — в статье «Платформа под ключ или сборка на API».
Ошибки, которые всплывают после запуска
- Встраивание как «вставил и забыл». Четыре события и есть интеграция. Без них виджет — витрина, а не спортбук.
- Долгоживущие токены. Токен на несколько дней — это сессия, которую можно украсть. Минуты, с обновлением.
- Перенос кошелька «для удобства». Держите балансы в своей системе с первой ставки. Именно это позволит позже сменить интерфейс, не трогая деньги.
- Выплата по купону. Выплата берётся из итога расчёта, а не из возможного выигрыша, показанного в купоне.
- Нет запасного сценария. Блокировщики рекламы и строгие корпоративные сети режут сторонние скрипты. Покажите сообщение.
- Пустая страница вокруг виджета. Странице, на которой только встраивание, нечего отдать поисковикам и нечего показать, пока виджет грузится.
Как это устроено в SportAPI
Виджет SportAPI использует те же данные, что и API спортивной линии, и подключает ставки через Coupon API, поэтому линия, проверка коэффициентов и расчёт ведут себя так же, как у команд, которые делают свой фронтенд. Для старта от менеджера нужны три вещи: идентификатор проекта, ваши домены, разрешённые для проекта, и код встраивания. Инструкция по установке готовится, поэтому инициализацию, авторизацию и события под вашу систему показывает менеджер.
Что сделать до этого разговора: открыть живую демонстрацию на телефоне и на компьютере, решить, можно ли смотреть линию без входа, и составить список доменов и языков. Цена виджета согласуется под проект; у сервисов под ним минимальные тарифы открыты — от $30 в месяц за вид спорта за линию и от $300 в месяц за приём и расчёт ставок.
Частые вопросы
Sportsbook iFrame — это настоящий iframe?
Иногда, внутри. Устанавливаете вы контейнер и JavaScript-загрузчик, потому что раздел ставок должен обмениваться событиями с сайтом, а голый фрейм этого не умеет. «iFrame» — отраслевое название всей категории встроенных спортбуков.
Игроки действительно могут ставить через него?
Да, когда подключён приём ставок. Виджет даёт купон и события; ставки создаются и рассчитываются через Coupon API, а операции с кошельком идут в вашей платформе.
Работает ли он с нашей авторизацией?
Да. Ваш backend выдаёт токен сессии для вошедшего игрока, а виджет сообщает сайту, когда нужен вход. Точный порядок работы с сессией согласуется при технической интеграции.
Замедлит ли встроенный спортбук сайт?
Нет, если загружать его после основного содержимого и резервировать высоту контейнера. Подключайте его лениво, когда контейнер приближается к видимой области, как в примере выше.
Вредно ли это для SEO?
Для страницы это нейтрально, если у неё есть собственный контент. Поисковики индексируют ваши заголовки и текст; матчи и коэффициенты внутри встраивания текстом страницы не считаются. Не стройте сайт из страниц, на которых нет ничего, кроме виджета.
Можно ли изменить внешний вид?
Интерфейс — виджета, на языках вашего проекта, адаптивный для компьютера и телефона. Если важен именно собственный дизайн, собирайте на API или заказывайте платформу; встроенный формат — про скорость.
Прежде чем просить код встраивания
Откройте демонстрацию на двух устройствах, запишите домены и языки, определите правило входа и набросайте, что делает сайт по каждому из четырёх событий. С таким списком первый разговор будет о вашем проекте, а не об основах. Отправьте его менеджеру SportAPI в Telegram и попросите показать виджет на вашей платформе.