Интеграция эквайринга с 1C‑Битрикс: модули, 54‑ФЗ и синхронизация с 1С
Интернет‑магазин на «1С‑Битрикс: Управление сайтом» выигрывает, когда платежи, фискализация и обмен с 1С работают как единая система. В этом руководстве разбираем, как выбрать и настроить модуль эквайринга, учесть требования 54‑ФЗ и настроить корректную синхронизацию с 1С.
Table of contents
Что такое эквайринг в 1C‑Битрикс
Эквайринг 1С Битрикс — это приём онлайн‑платежей (карты, SBP, Apple/Google Pay) через платежный модуль, установленный в CMS. «Битрикс модуль оплаты эквайринг» отвечает за отображение способа оплаты на чекауте, передачу заказа в платёжный шлюз, приём статусов (успех/отмена/возврат), а также взаимодействие с фискальной кассой при необходимости.
Задача бизнеса — обеспечить: стабильную конверсию, соответствие 54‑ФЗ, корректный обмен с 1С и понятную операционную схему возвратов и отчётности.
Варианты подключения: модули и провайдеры
Есть три типовых подхода:
- Готовые модули банков и платёжных провайдеров из Marketplace.
- Быстрый старт и поддержка «из коробки».
- Подходят большинству магазинов.
- Аггрегаторы платежей.
- Один договор, много платёжных методов.
- Часто включают SBP, оплату по ссылке, рекуррентные списания.
- Кастомная интеграция по API.
- Максимальная гибкость, но выше стоимость внедрения и поддержки.
Полезные материалы для выбора:
Требования к сайту и безопасности
Перед установкой модуля проверьте базовые условия:
- Домен и SSL. Оплата должна идти по HTTPS, корректны редиректы и сертификат.
- Актуальная версия Битрикс и PHP. Совместимость модуля с вашим ядром D7.
- Политики безопасности и персональных данных.
- Соответствие нормам PCI DSS (если обрабатываете карточные данные) и 152‑ФЗ. Подробнее — в материале Безопасность: PCI DSS, 54‑ФЗ, 152‑ФЗ.
- Технические условия сайта под эквайринг: Требования к сайту для эквайринга.
Пошаговая настройка: модуль оплаты в Битрикс
Ниже — базовый алгоритм подключения «битрикс модуль оплаты эквайринг»:
- Выбор провайдера и получение доступов
- Подпишите договор, активируйте мерчант‑профиль.
- Получите ключи/пароли для API, webhook URL, тестовый магазин.
- Подумайте о резервном провайдере на случай отказа.
- Установка модуля
- Marketplace → Поиск модуля → Установка → Настройка.
- Убедитесь, что модуль поддерживает 3‑D Secure 2.0, Apple/Google Pay, SBP (при необходимости), возвраты и холд.
- Настройка платёжной системы в Битрикс
- Магазин → Платежные системы → Добавить → Выберите модуль.
- Заполните реквизиты: ключи API, подписи, URL успеха/ошибки, webhook.
- Включите нужные способы оплаты и валюты.
- Тестовый платёж и статусы
- Проверьте успешный и неуспешный кейсы, отмену и возврат.
- Настройте сопоставление статусов «Оплачен/Отменён/Частичный возврат».
- Фискализация (если требуется)
- Подключите облачную ККТ или кассу на стороне провайдера.
- Проверьте формирование чека и отправку в ОФД.
- Продакшн и мониторинг
- Переключитесь на боевой магазин.
- Настройте логи, оповещения о сбоях, контроль SLA.
Полезно: для разработчиков — API и Sandbox для разработчиков; общее — Онлайн‑эквайринг для сайта.
![Схема интеграции эквайринга с 1C-Битрикс — платёжный шлюз, ККТ, ОФД, 1С]
SBP в Битрикс: когда и как подключать
«Битрикс SBP модуль» добавляет оплату через Систему быстрых платежей. Сценарии:
- QR на странице оплаты (скан из банковского приложения).
- Push‑согласование в приложении банка.
- Динамический QR в счёте или e‑mail.
Плюсы: низкая комиссия, высокая конверсия в мобильном трафике, быстрые возвраты. Убедитесь, что ваш модуль поддерживает:
- Генерацию динамических QR.
- Корректную передачу признаков расчёта для чека по 54‑ФЗ.
- Возвраты по SBP и автоматическое оповещение магазина.
Фискализация по 54‑ФЗ: чеки, ККТ, ОФД
«Битрикс фискализация 54‑ФЗ» — это цепочка: сайт → провайдер → ККТ → ОФД → чек покупателю.
Ключевые моменты:
- Чеки. При полной оплате — чек прихода; при возврате — чек возврата прихода. При предоплатах и частичных оплатах применяют соответствующие признаки расчёта (предоплата, частичная оплата и т. д.).
- Номенклатура. В чеке должны быть позиции с ценой, количеством, ставкой НДС, признаком предмета расчёта; для маркированных товаров — коды маркировки.
- Контакты покупателя. E‑mail или телефон для отправки чека.
- Касса. Облачная ККТ провайдера или ваша ККТ с интеграцией.
- Возвраты. Автоматическая генерация чека возврата при частичном/полном возврате.
Лучшие практики:
- Валидируйте ставки НДС и категории товаров, чтобы исключить ошибки чека.
- При двухстадийной оплате (холд/списание) формируйте чек на момент списания.
- Храните связку «заказ → платёж → фискальный документ».
Подробнее о нормативных требованиях и моделях фискализации — в разделе Безопасность: PCI DSS, 54‑ФЗ, 152‑ФЗ.
Синхронизация с 1С: статусы, документы, возвраты
Грамотная 1C интеграция эквайринг устраняет разрыв между оплатой на сайте и документами в 1С.
Базовая схема:
- Обмен заказами по CommerceML (или через обмен с Битрикс24/корпоративным порталом).
- Сопоставление статусов оплаты.
- Формирование документов «Реализация», «Поступление безналичных», «Возврат» в 1С.
Рекомендованная матрица соответствий:
| Статус в Битрикс |
Статус у провайдера |
Документ в 1С |
Комментарий |
| Оплата удержана (холд) |
Authorized |
Платёж к подтверждению |
Не отгружать до Capture |
| Оплачен |
Captured/Success |
Поступление на р/с (безнал) + Реализация |
Разрешить отгрузку |
| Частичный возврат |
Partial Refund |
Возврат средст/корректировка |
Корректировка по позициям |
| Полный возврат |
Refunded |
Возврат денежных средств |
Закрыть заказ/возврат товара |
| Отмена |
Canceled/Failed |
Нет оплаты |
Освободить резерв |
Советы по обмену:
- Инициируйте обновление статусов из webhook провайдера, а не только при редиректе.
- В 1С заводите отдельный вид операции «Эквайринг», чтобы прозрачно сверять комиссии.
- Храните идентификаторы платежа/чека в полях заказа и передавайте их в 1С.
Сценарии оплаты: холд, частичные платежи, подписки
Разные модели продаж требуют разных сценариев в модуле:
- Одностадийная оплата. Мгновенное списание при оформлении.
- Двухстадийная (холд/списание). Бронь средств (Authorize) с последующим Capture при готовности к отгрузке или проверке наличия.
- Частичные списания и отгрузки. Списывайте по мере комплектации, формируя корректные чеки.
- Возвраты. Полные и частичные, в том числе по SBP и по картам.
- Рекуррентные платежи (подписки). Токенизация карты, регулярные списания без участия покупателя. Уточните поддержку в модуле и у провайдера.
- Оплата по ссылке/счёту. Генерация платёжной ссылки и чека для B2B/B2C.
Если требуется реализовать сложную логику (сплиты, маркетплейс, escrow) — выбирайте модуль с поддержкой этих функций или закладывайте доработку по API. Подробнее — API и Sandbox для разработчиков.
Тестирование, мониторинг и антифрод
Перед релизом прогоните чек‑лист:
- Тест‑карты и SBP в песочнице: успешный платёж, отмена, отказ, возврат, холд/Capture.
- Проверка чеков: структура, НДС, суммы, контакты покупателя, маркировка.
- Webhook’и: повторные доставки, idempotency, подписи.
- Время ответа и конверсия: 3‑D Secure 2.0, Apple/Google Pay, мобильные браузеры.
- Логи и алерты: ошибки модуля, таймауты, расхождения сумм.
Защита от фрода и работа с чарджбэками:
Частые ошибки и лучшие практики
Ошибки:
- Несовпадение сумм и валют между сайтом, чеком и 1С.
- Неверные ставки НДС и признаки расчёта в чеке.
- Отсутствие webhook — статусы не обновляются при закрытии вкладки.
- Двойные списания из‑за отсутствия idempotency ключей при ретраях.
- Блокировка редиректов/куков сторонними расширениями в мобильных браузерах.
Практики:
- Разделите «Статус заказа» и «Статус оплаты» — проще управлять логикой.
- Включите функции «Оплата одним кликом» и локальные кошельки для роста конверсии.
- Используйте кросс‑провайдерную абстракцию, чтобы быстро переключаться при сбоях.
- Фиксируйте комиссию провайдера в отдельной аналитике.
Выбор провайдера и тарифы
На разных оборотах и чекаут‑сценариях выигрывают разные решения. Сравните предложения и комиссии, а затем подключите выбранный вариант через модуль для Битрикс:
Вывод и следующий шаг
Интеграция эквайринга в 1C‑Битрикс — это не только «приём платежей», но и целостная цепочка: UX оплаты, фискализация по 54‑ФЗ и прозрачная 1С‑отчётность. Выберите подходящий модуль, продумайте сценарии (SBP, холд, возвраты, подписки), настройте синхронизацию с 1С и включите мониторинг.
Готовы к внедрению? Мы поможем подобрать модуль, настроить 54‑ФЗ и обмен с 1С.