Прием онлайн‑оплаты в 1C‑Битрикс: модули, касса и webhooks
Зачем подключать оплату в 1C‑Битрикс
Оплата в 1C‑Битрикс — ключевой элемент роста выручки интернет‑магазина и сервисов на платформе Битрикс. Правильно выбранная платежная система для Битрикс и корректно настроенный модуль оплаты Битрикс дают:
- больше способов оплаты (карты, SBP, Apple Pay/Google Pay, рассрочки);
- выше конверсию за счет короткого и безопасного чекаута;
- автоматизацию фискализации чеков по 54‑ФЗ;
- прозрачные статусы заказов, возвраты и отчеты.
Если вам нужен общий алгоритм, посмотрите наше руководство «Как подключить платежную систему» — пошаговая схема.
Варианты интеграции: модуль или API
![Схема интеграции 1C‑Битрикс ↔ платежный провайдер: модуль, webhooks, онлайн‑касса]
Есть два основных пути внедрения:
- Готовый модуль из маркетплейса Битрикс
- Быстрый старт, минимальная разработка.
- Настройки в админке, готовые платежные страницы.
- Поддержка webhooks, чеков и возвратов зависит от провайдера.
- Прямая API‑интеграция
- Гибкость UI/UX, кастомная логика статусов и подписок.
- Полный контроль над webhooks, рекуррентами и фискализацией.
- Требует опыта разработки и сопровождения. Подробнее о сервер‑к‑серверу и webhooks — в статье API‑интеграция.
Обычно мы рекомендуем начинать с модуля, а при росте требований переходить на гибридный сценарий: модуль + собственные обработчики webhooks.
Как выбрать платежную систему для Битрикс
При выборе учитывайте комиссии, набор методов оплаты, SLA, наличие модуля, работу с ФЛ/ИП/ООО и требования KYC. Сравнить провайдеров поможет наш гайд Выбор платежного провайдера и калькулятор комиссий Тарифы и эквайринг.
Ниже — краткая выжимка по популярным провайдерам для Битрикс:
| Поставщик |
Модуль в Битрикс |
Карты + Apple/Google Pay |
SBP |
3DS 2.0 |
Рекуррентные |
Чеки 54‑ФЗ |
Webhooks |
Особенности |
| YooKassa |
Да (официальный) |
Да |
Да |
Да |
Да |
Да |
Да |
yookassa для Битрикс: быстрый старт, подписки, гибкая кастомизация |
| Сбер (Сбербанк) |
Да |
Да |
Да |
Да |
Опционально |
Да |
Да |
сбер эквайринг Битрикс модуль: строгие KYC, надежный бренд |
| CloudPayments |
Да |
Да |
Да |
Да |
Да |
Да |
Да |
cloudpayments Битрикс: удобный виджет, антифрод, рассрочки |
Примечание: доступность Apple Pay/Google Pay зависит от браузера, HTTPS и домена. Подробнее — в статье Банковские карты, Apple Pay и Google Pay.
Если у вас мультивалютные витрины или экспорт, проверьте валютный контроль и налоги: Мультивалюта, налоги, ВК.
Подключение оплаты Битрикс: пошагово
Вот базовый маршрут, который мы используем на проектах по подключению оплаты Битрикс:
- Зарегистрируйтесь у провайдера, пройдите KYC
- Установите модуль оплаты Битрикс
- Установка через маркетплейс, затем раздел Настройки → Интернет‑магазин → Платежные системы.
- Создайте платежную систему и привяжите к сайту/магазину.
- Настройте ключи и среды
- Введите ключи тестовой среды и боевые отдельно.
- Укажите URL для webhooks (успех, отказ, возврат). О тестах ниже.
- Настройте методы оплаты и 3DS
- Включите карты, SBP, Apple Pay/Google Pay, при необходимости — рассрочки.
- Обязательно активируйте 3DS 2.0. Подробнее — Безопасность и 3DS.
- Связь с онлайн‑кассой
- Включите фискализацию чеков: номенклатура, ставки НДС, способы расчета. Гайд — Онлайн‑касса, 54‑ФЗ.
- Протестируйте на песочнице
- Включите боевой режим, мониторинг и логи
- Настройте уведомления о сбоях, ретраи webhooks и аудит изменений.
Онлайн‑касса Битрикс и 54‑ФЗ
Онлайн касса Битрикс — это связка модуля провайдера и кассового сервиса (ОФД/ФФД). Критично настроить:
- передаваемые атрибуты номенклатуры (наименование, количество, цена, НДС, признак предмета/расчета);
- корректную отправку чеков прихода, возврата прихода;
- связь чека и платежа (payment_id, order_id);
- печать чеков при рекуррентных списаниях.
Если вы работаете через агрегатора, уточните, кто фискализирует: провайдер или ваша касса. Подробно и с примерами — в материале Фискализация по 54‑ФЗ.
Webhooks Битрикс: статусы, возвраты, рекурренты
Webhooks Битрикс — основа надежного обмена статусами между провайдером и CMS. Обработчики уведомлений должны:
- проверять подпись/секрет, чтобы исключить подмену;
- делать идемпотентные операции (не менять статус дважды);
- логировать сырые события и ответ сервера;
- ретраить при 5xx/таймаутах.
Типичные маппинги событий:
| Событие провайдера |
Действие в Битрикс |
| Payment.succeeded |
Пометить оплату, перевести заказ в статус «Оплачен» |
| Payment.canceled/failed |
Снять оплату/оставить «Ожидание», опционально уведомить клиента |
| Refund.succeeded |
Создать возврат, отправить чек возврата |
| Subscription.charge.succeeded |
Создать оплату по рекурренту, фискализировать |
Для подписок используйте рекуррентные платежи: настройка, токены, оферта — в гайде Рекуррентные платежи и подписки. Технические детали webhook‑взаимодействия — в статье API и webhooks; как протестировать — здесь: Песочница и webhook‑тесты.
SBP, 3DS2 и другие методы оплаты
- SBP Битрикс. Быстрые переводы по QR/линку, низкая комиссия, высокая конверсия в мобайле. Подключение — SBP и QR‑оплата.
- 3DS2 Битрикс. Современная аутентификация с «frictionless» потоком, снижает риск фрода и чарджбеков. Подробнее — PCI DSS, 3DS, антифрод.
- Apple Pay/Google Pay. Ускоряют оплату и повышают CR в мобильном чекауте — см. карты и кошельки.
Если у вас есть мобильное приложение, изучите мобильные SDK для iOS/Android — они дополняют веб‑чекаут на Битрикс.
UX чекаута и конверсия
Оптимизация чекаута важнее «магических» скидок комиссии:
- один экран оплаты, минимум полей и редиректов;
- автозаполнение 이메일/телефона из профиля пользователя;
- отображение логотипов платежных методов и безопасности;
- сохранение карты для повторных оплат (при согласии), сокращение шагов;
- четкие статусы и уведомления.
Больше практик — в материале Checkout UX и конверсия.
Тестирование, песочница и запуск
Проверьте ключевые кейсы до запуска в прод:
- успешная оплата (карта, SBP), отмена, отказ 3DS;
- возврат частичный/полный, корректный чек возврата;
- сбои сети и ретраи webhooks, идемпотентность;
- расхождения сумм, валюта, НДС, курьеры/предзаказы.
Подробный сценарный план — в разделе Тестирование, sandbox и webhooks. Для споров и возвратов денег держите под рукой гайд Возвраты, чарджбеки, претензии.
Частые ошибки и чек‑лист
- Дублирующиеся оплаты из‑за отсутствия идемпотентности webhook‑обработчика.
- Не передан email/телефон покупателя — касса не отправляет чек.
- Несовпадение суммы заказа и платежа (скидки/доставка не учтены).
- Неверные ставки НДС или признак предмета расчета.
- Не включен 3DS 2.0 — больше отказов и фрода.
- SBP включен в кабинете, но не отображается в чекауте — проверьте методы в модуле.
- Ошибка SSL/сертификата — кошельки не работают.
Краткий чек‑лист перед релизом:
- модуль обновлен; ключи тест/прод разделены;
- webhooks подписаны, логи и ретраи настроены;
- касса отправляет чеки прихода/возврата;
- UX чекаута проверен на мобайле;
- SLA и статусы мониторятся.
FAQ
- Можно ли смешивать модуль и кастомный код? Да: используйте модуль для чекаута и свой обработчик webhooks для нестандартной логики.
- Какой провайдер лучше? Смотрите задачи: если важны подписки — yookassa для Битрикс или cloudpayments Битрикс; если нужен бренд‑траст — сбер эквайринг Битрикс модуль.
- Нужны ли сертификаты PCI DSS на стороне магазина? При редирект‑чекауте — нет; при приемке карт‑данных на своей стороне — да. Подробно — Безопасность PCI DSS и 3DS.
- Как снизить комиссию? Продвигайте SBP, договаривайтесь по обороту, считайте экономику — калькулятор тарифов.
Итоги и следующий шаг
Оплата в 1c-битрикс внедряется быстро при использовании готового модуля оплаты Битрикс. Выберите подходящего провайдера, настройте онлайн кассу Битрикс, подключите webhooks Битрикс и обеспечьте 3DS2 Битрикс + SBP для высокой конверсии и безопасности. Готовы к старту? Следуйте нашему гайду Как подключить платежную систему и, при необходимости, свяжитесь с нами — поможем с подбором и подключением, от настройки модуля до тестов и запуска.
