Как принимать платежи в подписных сервисах через Chargebee и ЮKassa

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

Почему вообще нужно связывать Chargebee и ЮKassa

Chargebee сам по себе не принимает платежи от российских карт напрямую. Это международная платформа, которая работает через зарубежные процессоры вроде Stripe или Braintree. Для российских клиентов это не подходит — карты «Мир» через них не пройдут, а Visa и Mastercard, выпущенные российскими банками, с 2022 года за рубежом не работают.

Поэтому нужен мост — российский платёжный агрегатор, который принимает местные карты и при этом умеет разговаривать с Chargebee. ЮKassa как раз предоставляет такую интеграцию через API.

Как устроена интеграция

Схема в целом простая, но детали имеют значение:

1. Клиент оформляет подписку — это происходит в Chargebee: выбирает тариф, вводит данные, подтверждает.
2. Chargebee отправляет запрос на оплату — через подключённый шлюз ЮKassa платёж уходит в российскую платёжную систему.
3. Клиент оплачивает — картой «Мир», российской Visa/Mastercard, через СБП или другим доступным способом.
4. ЮKassa подтверждает оплату — отправляет уведомление обратно в Chargebee, подписка активируется.
5. Повторные списания — Chargebee сам инициирует рекуррентные платежи по расписанию, каждый раз обращаясь к ЮKassa.

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

Что нужно для подключения

Прежде чем начинать настройку, убедитесь, что у вас есть:

• Chargebee-аккаунт — тариф не ниже Essentials (на бесплатном плане интеграции с платёжными шлюзами недоступны).
• ЮKassa-мерчант — зарегистрированный, с подключённым эквайрингом. Нужен именно магазин онлайн-платежей, а не просто кошелёк.
• Договор с банком — ЮKassa заключает с вами агентский договор, деньги поступают на ваш расчётный счёт с удержанием комиссии.
• HTTPS и страница оплаты — Chargebee может генерировать платёжные страницы, но если используете кастомные, убедитесь, что всё по SSL.

Пошаговая настройка интеграции

Шаг 1. Создайте магазин в ЮKassa

Зарегистрируйтесь в ЮKassa, создайте магазин, заполните данные компании. На этом этапе вам понадятся идентификатор магазина (shopId) и секретный ключ — они понадобятся для подключения к Chargebee.

Шаг 2. Добавьте ЮKassa как шлюз в Chargebee

В Chargebee зайдите в Settings → Configure Chargebee → Payment Gateways. Найдите ЮKassa в списке доступных шлюзов и добавьте его. Введите shopId и секретный ключ, которые получили на первом шаге.

Шаг 3. Настройте способы оплаты

В ЮKassa вы можете выбрать, какие методы оплаты будут доступны клиентам:

• Карты «Мир», Visa, Mastercard (российские)
• СБП (Система быстрых платежей)
• Электронные кошельки (ЮMoney)
• Покупка в кредит

В Chargebee настраивается, какие из этих методов будут предлагаться на платёжной странице. Рекомендую включать карты и СБП — это самые популярные варианты у российских пользователей.

Шаг 4. Настройте вебхуки

Это критически важный момент. ЮKassa отправляет уведомления о статусе платежа на ваш Chargebee. Убедитесь для вебхуков указан правильно и Chargebee корректно обрабатывает входящие уведомления. Если вебхук не дойдёт — платёж пройдёт, но подписка не активируется.

Шаг 5. Протестируйте полный цикл

Проведите тестовый платёж, проверьте:

• Создание подписки в Chargebee
• Прохождение оплаты через ЮKassa
• Активацию подписки после успешного платежа
• Автоматическое продление при следующем периоде
• Корректную обработку неудачного платежа и уведомление клиента

Сравнение вариантов приёма платежей для подписок

Если вы выбираете, как именно организовать приём платежей в подписном сервисе для российских клиентов, вот основные варианты:

Параметр	Chargebee + ЮKassa	Chargebee + Stripe	Робокасса / другие агрегаторы	Самописное решение
Работа с российскими картами	Да	Нет	Да	Зависит от реализации
Поддержка карт «Мир»	Да	Нет	Зависит от агрегатора	Нужно подключать отдельно
Рекуррентные платежи	Да, нативно	Да, но не для РФ	Через токены, но сложнее с подпиской	Нужно реализовывать самому
Управление подписками	Полная функциональность Chargebee	Полная, если шлюз работает	Нет, только приём платежей	Всё с нуля
Сложность настройки	Средняя	Низкая (но не для РФ)	Средняя	Высокая
Комиссия	Chargebee + комиссия ЮKassa	Chargebee + Stripe	Только агрегатора	Зависит от банка

Что выбрать в зависимости от вашей ситуации

У вас SaaS-продукт с подпиской, клиенты в России, нужна гибкая настройка тарифов и промокодов. Берите Chargebee + ЮKassa. Это самый зрелый вариант с минимальным количеством костылей. Chargebee даёт вам управление жизненным циклом подписки (пробные периоды, апгрейды, даунгрейды, промокоды), а ЮKassa обеспечивает приём платежей.

У вас простой сервис с фиксированной ежемесячной оплатой, клиентов немного. Возможно, Chargebee — это оверквалифайд. Посмотрите в сторону более простых решений: например, прямую интеграцию с ЮKassa через ваш сайт и самописное управление подписками. Но если планируете расти — лучше сразу внедрить Chargebee, чтобы не переделывать.

У вас есть клиенты и в России, и за рубежом. Можно подключить два шлюза одновременно: ЮKassa для российских клиентов и Stripe/Braintree для иностранных. Chargebee поддерживает мультишлюзовую конфигурацию — клиент видит тот способ оплаты, который соответствует его региону.

Частые ошибки и как их избежать

Ошибка 1: Не проверили вебхуки и потеряли платежи

Самая неприятная ситуация — клиент заплатил, деньги пришли в ЮKassa, но Chargebee об этом не узнал. Подписка не активировалась, клиент пишет в поддержку. Решение: после настройки обязательно проверьте вебхуки. Сделайте тестовый платёж и убедитесь, что Chargebee получает и обрабатывает уведомление. Проверьте логи в Chargebee (Settings → Logs) — там в пришёл ли вебхук.

Ошибка 2: Забудили про 3-D Secure

ЮKassa требует прохождения 3-D Secure для российских карт. Если вы отключили это в настройках или не учли — часть платежей будет отклонена. Убедитесь, что 3-D Secure включён и корректно настроен на стороне ЮKassa.

Ошибка 3: Не обработали сценарий неудачного рекуррентного платежа

Когда заканчивается пробный период или приходит время продления, Chargebee пытается списать деньги. Если на карте недостаточно средств — подписка должна перейти в статус «просрочено» или «не оплачено». Если вы не настроили такие статусы и автоматические письма клиенту, вы теряете клиентов, которые просто забыли пополнить карту. В Chargebee есть настройки для работы с неудачными платежами (Dunning Management) — обязательно их включите и настройте последовательность напоминаний.

Ошибка 4: Слепо скопировали документацию без адаптации

Официальная документация Chargebee по интеграции с ЮKassa даёт базовую настройку, но не покрывает все сценарии. Например, там может не быть информации о том, как корректно обрабатывать возвраты или как настроить переход между тарифами с сохранением истории платежей. Всегда проверяйте на реальных транзакциях.

Ошибка 5: Не учли требования 152-ФЗ

При приёме платежей от физических лиц в России вы обязаны соблюдать закон о персональных данных и о национальной платёжной системе. Чек должен формироваться (если выете как юрлицо или ИП с кассой), данные клиентов должны храниться в РФ. Убедитесь, что ваша инфраструктура соответствует требованиям.

Практические рекомендации

• Включите Dunning Management. Настройте 3–4 попытки списания с интервалом в несколько дней и отправку писем клиенту. Это реально снижает отток из-за забытых карт.
• Давайте клиенту самому менять карту. В Chargebee есть Customer Portal — клиент может сам обновить платёжные данные, не обращаясь в поддержку. Подключите его.
• Настройте уведомления для себя. Если рекуррентный платёж не прошёл — вы должны об этом узнать первым, а не через жалобу клиента. Настройте алерты в Chargebee или хотя бы регулярно проверяйте отчёт по неудачным платежам.
• Ведите журнал изменений. Если меняете тарифы или условия — фиксируйте, когда и для каких клиентов. При спорах по платежам это бесценно.
• Проверяйте выгрузку для бухгалтерии. ЮKassa формирует отчёты, Chargebee — свои. Сверяйте их регулярно, чтобы не было расхождений по суммам и датам.

Стоимость: из чего складываются расходы

Вам придётся платить двум сторонам:

• Chargebee — подписка на платформу. Тарифы зависят от выбранного плана и объёма выручки. На старте можно уложиться в базовый тариф, но по мере роста стоимость будет увеличиваться.
• ЮKassa — комиссия с каждой транзакции. Размер зависит от способа оплаты и вашего тарифа в ЮKassa. Карты «Мир» обычно дешевле по комиссии, чем Visa/Mastercard. Точные цифры смотрите в актуальном тарифе на сайте ЮKassa.

Итоговая стоимость — это сумма двух составляющих. Для небольших проектов это может быть приемлемо, но если у вас тысячи клиентов с ежемесячной подпиской в 500–1000 рублей, комиссия ЮKassa набегает ощутимо. Стоит периодически пересматривать условия и торговаться.

Итог

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

Если вы только начинаете — начните с тестового платежа и пройдите весь цикл вручную. Если уже работаете — проверьте вебхуки, включите Dunning и настройте Customer Portal. Эти три вещи решают 80% проблем с подписными платежами.

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