Boomstream - профессиональная видеоплатформа для бизнеса: размещайте видео на сайте, проводите прямые трансляции, защищайте контент DRM и водяными знаками, продавайте доступ и интегрируйте к себе через API. Инфраструктура в России, тестовый период 30 дней.

Интеграция Юкассы для приёма оплат

интеграции
монетизация

Подключение платёжного шлюза ЮKassa к Boomstream: приём платежей

Коротко о главном:
Для подключения ЮKassa к Boomstream настройте URL уведомлений https://boomstream.com/pay/yookassa/result в личном кабинете ЮKassa, скопируйте shopId и секретный ключ из раздела API, укажите систему налогообложения и ставку НДС, затем передайте данные в поддержку Boomstream. После активации шлюза зрители смогут оплачивать доступы картами, через СБП, SberPay и другие способы, а деньги будут поступать на ваш расчётный счёт.

Зачем подключать ЮKassa к Boomstream

ЮKassa (бывшая Яндекс.Касса) — один из крупнейших платёжных агрегаторов в России. Подключение собственного шлюза даёт несколько преимуществ перед агентским договором с Boomstream:

  • Приём платежей от физических и юридических лиц;
  • Множество способов оплаты: банковские карты, СБП, SberPay, T-Pay, электронные кошельки;
  • Автоматическая выдача онлайн-чеков по 54-ФЗ через сервис ЮKassa;
  • Деньги поступают напрямую на ваш расчётный счёт;
  • Удобная аналитика и выгрузка отчётов в личном кабинете ЮKassa;
  • Возможность международных платежей в отдельных тарифах.

Шаг 1. Настройка URL уведомлений в ЮKassa

Перейдите в личный кабинет ЮKassa в раздел HTTP-уведомления и укажите в поле «URL для уведомлений» следующий адрес:

Text 
https://boomstream.com/pay/yookassa/result

Настройка URL уведомлений в личном кабинете ЮKassa

Этот адрес необходим, чтобы ЮKassa автоматически отправляла в Boomstream информацию о статусе платежей: успешно оплачено, отклонено, возвращено. Без этой настройки плеер не узнает об оплате и не выдаст зрителю доступ.

Рекомендуемые настройки уведомлений:

  • Включите уведомления о всех статусах платежей;
  • Используйте HTTPS;
  • Убедитесь, что в настройках магазина разрешены уведомления на внешние URL.

Шаг 2. Получение ключей API

Перейдите в раздел Ключи API личного кабинета ЮKassa и скопируйте два параметра:

Параметр Где найти Пример значения
shopId Идентификатор магазина в верхней части страницы 763XXX
Секретный ключ Создаётся в разделе «Секретный ключ» live_JjJrL2tqtrwcc51ZybozXoT8C92WPpBZ_1Iba6m8o

Получение shopId и секретного ключа в разделе API ЮKassa

Важные моменты при работе с ключами:

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

Шаг 3. Настройка данных для онлайн-чеков

Для корректной выдачи онлайн-чеков по 54-ФЗ через ЮKassa необходимо указать вашу систему налогообложения и ставку НДС.

Система налогообложения

Укажите код, соответствующий вашему режиму:

Код Система налогообложения
osn Общая система налогообложения (ОСН)
usn_income Упрощённая (УСН, доходы)
usn_income_outcome Упрощённая (УСН, доходы минус расходы)
envd Единый налог на вменённый доход (ЕНВД)
esn Единый сельскохозяйственный налог (ЕСХН)
patent Патентная система налогообложения

Ставка НДС

Выберите ставку, которую вы применяете:

Код Ставка НДС
none Без НДС
vat0 НДС по ставке 0%
vat10 НДС по ставке 10%
vat20 НДС чека по ставке 20%
vat110 НДС чека по расчётной ставке 10/110
vat120 НДС чека по расчётной ставке 20/120

Если вы пробиваете онлайн-чеки самостоятельно через свою онлайн-кассу или сторонний сервис (например, Атол Онлайн, Бизнес.Ру), обязательно сообщите об этом в поддержку Boomstream — в этом случае чек через ЮKassa формироваться не будет.

Шаг 4. Обращение в поддержку Boomstream

После сбора всех данных передайте их в техническую поддержку Boomstream для финальной активации шлюза:

  • shopId — идентификатор магазина;
  • Секретный ключ — для API-запросов;
  • Система налогообложения — код из таблицы;
  • Ставка НДС — код из таблицы;
  • Информация о чеках — пробиваете через ЮKassa или самостоятельно.

Каналы связи с поддержкой:

Тема письма: «Подключение платёжного шлюза ЮKassa» — это ускорит обработку заявки.

Шаг 5. Тестирование платежей

После активации шлюза со стороны Boomstream проведите тестовый платёж:

  1. Откройте страницу с платным доступом;
  2. Нажмите «Оплатить»;
  3. Выберите ЮKassa как способ оплаты;
  4. Используйте тестовую карту, реквизиты есть в документации ЮKassa;
  5. Убедитесь, что после оплаты доступ выдаётся автоматически.

Если тест прошёл успешно, переключите шлюз с тестового ключа (test_) на боевой (live_) и начните принимать реальные платежи.

Какие способы оплаты доступны после подключения

После активации шлюза ЮKassa вашим зрителям станут доступны следующие способы оплаты:

Способ Описание
Банковские карты Visa, Mastercard, МИР российских банков
СБП Система быстрых платежей с низкой комиссией
SberPay Оплата через приложение СберБанк Онлайн
T-Pay Оплата через приложение Т-Банка
YooMoney Электронный кошелёк
Наличные Оплата через терминалы и салоны связи
Internet Banking Альфа-Клик, СберБанк Онлайн и другие
Безналичный расчёт Для юридических лиц

Набор доступных способов зависит от вашего договора с ЮKassa и может быть расширен по запросу.

Частые вопросы (FAQ)

Сколько времени занимает подключение ЮKassa к Boomstream?
Сама настройка в личном кабинете ЮKassa занимает 15–20 минут. После передачи данных в поддержку Boomstream активация происходит в течение 1 рабочего дня с учётом проведения тестовой транзакции.

Нужен ли отдельный договор с ЮKassa?
Да. Для подключения вы должны иметь действующий договор с ЮKassa и активированный магазин в личном кабинете.

Что делать, если чек не формируется после оплаты?
Проверьте: 1) Корректность указанных кодов системы налогообложения и НДС; 2) Наличие подключённой опции «Онлайн-чеки» в личном кабинете ЮKassa; 3) Активность онлайн-кассы, если вы используете собственную. При проблемах обратитесь в поддержку ЮKassa и Boomstream.

Можно ли подключить несколько магазинов ЮKassa одновременно?
Да. Вы можете настроить разные магазины ЮKassa для разных проектов в Boomstream. Для каждого потребуется отдельный shopId и секретный ключ.

Что произойдёт при возврате средств покупателю?
Возврат оформляется через личный кабинет ЮKassa или через API. При возврате деньги вернутся на карту покупателя в течение 3–5 рабочих дней, а чек на возврат сформируется автоматически.

Нужно ли менять код плеера на сайте после активации шлюза?
Нет. После активации шлюза со стороны Boomstream все существующие плееры автоматически начнут принимать оплату через ЮKassa. Дополнительных действий на сайте не требуется.

Можно ли использовать ЮKassa и агентский договор одновременно?
Нет, в рамках одного проекта активен либо агентский договор Boomstream, либо собственный платёжный шлюз. Переключение между ними возможно через поддержку.

Как получить закрывающие документы для бухгалтерии?
Все закрывающие документы (акты, счета-фактуры) формируются автоматически в личном кабинете ЮKassa и доступны для скачивания в разделе «Документы». Boomstream предоставляет только технические услуги хостинга.

Что делать, если платёж завис в статусе «Ожидает»?
Проверьте в личном кабинете ЮKassa детали платежа и статус. Если платёж отклонён банком, предложите покупателю выбрать другой способ оплаты. При технических проблемах обратитесь в поддержку ЮKassa с указанием ID платежа.

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