Настройка платёжных систем в Битрикс: обзор

Оплата в 1С-Битрикс — это не одна кнопка, а связка из платёжной системы, обработчика, типа плательщика и настроек заказа. Разберём, как эти элементы соединяются в модуле «Интернет-магазин» и на что смотреть при первой настройке.

Где в админке живут платёжные системы

Все настройки оплаты собраны в разделе Магазин → Настройки → Платёжные системы (модуль sale). Здесь создаются отдельные платёжные системы — каждая привязана к обработчику, который знает, как формировать запрос к банку или агрегатору и как принимать ответ о статусе платежа.

Не путайте два уровня: платёжная система — это запись в списке, которую видит покупатель на странице оформления заказа, а обработчик — это PHP-код, реализующий протокол конкретного провайдера (ЮKassa, Robokassa, Сбербанк и т. д.). Одна платёжная система = один обработчик, но обработчиков в поставке и в маркетплейсе десятки.

Обработчики: коробочные и пользовательские

Битрикс делит обработчики на несколько типов по назначению. Понимание этого деления экономит время при выборе решения:

• Системные — идут в поставке модуля: банковская карта (демо), наличные, ЮKassa, Robokassa, PayMaster, Assist, Сбербанк и другие.
• Пользовательские — созданные вручную через REST или скопированные из системного как шаблон; хранятся в /bitrix/php_interface/include/sale_payment/.
• Из маркетплейса — устанавливаются модулем решения и добавляют свой обработчик автоматически.

Каждый обработчик описывается файлами .description.php (набор полей настройки) и handler.php или платёжным классом-наследником \Bitrix\Sale\PaySystem\ServiceHandler. Именно там задаётся, какие параметры (магазин ID, секретный ключ, URL) вы будете заполнять в админке.

Типы плательщиков и привязка систем

Ключевая для магазина логика: платёжная система показывается покупателю не всем подряд, а в зависимости от типа плательщика. Типы задаются в Магазин → Настройки → Плательщики — обычно это «Физическое лицо» и «Юридическое лицо».

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

Если система не появляется на оформлении заказа, первым делом проверьте связку «тип плательщика ↔ платёжная система» и активность обеих записей.

Ограничения и логика показа

Помимо типа плательщика, показ платёжной системы регулируют ограничения (restrictions) — их видно в карточке системы на вкладке «Ограничения». Через них можно скрыть способ оплаты по сумме заказа, службе доставки, сайту или группе пользователей.

• По сумме — например, рассрочка доступна только для заказов от определённого порога.
• По доставке — оплата при получении логична только для курьера или самовывоза.
• По личному кабинету — часть систем показывают лишь авторизованным клиентам.

Тестовый режим и фискализация

Почти каждый серьёзный обработчик поддерживает тестовый режим: платёж проходит по песочнице провайдера, деньги не списываются, но весь сценарий возврата статуса воспроизводится. Перед боевым запуском обязательно проведите тестовую оплату и убедитесь, что заказ переходит в статус «оплачен» автоматически по колбэку.

Отдельный слой — онлайн-касса по 54-ФЗ. В Битрикс фискализация настраивается в Магазин → Кассы → Кассы ККМ и работает независимо от платёжной системы: касса формирует и отправляет чек в ОФД, а платёжка занимается только списанием денег. У некоторых агрегаторов (ЮKassa, Тинькофф) чек может пробивать сама платёжная система — тогда встроенную кассу дублировать не нужно.

Возвраты и статусы платежей

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

Важно различать сущности: Order (заказ), Payment (оплата) и Shipment (отгрузка) в новом ядре \Bitrix\Sale — это разные объекты. Один заказ может содержать несколько оплат, а колбэк от банка меняет флаг именно у объекта Payment. Если после успешной оплаты заказ висит неоплаченным, ищите проблему в обработке ответа (callback URL, IP-фильтр, подпись).

Как выбрать платёжную систему под проект

Выбор зависит не от «модности» агрегатора, а от аудитории и юрлица магазина. Ориентиры при подборе:

1. Кто платит. Только физлица — достаточно карты и СБП; есть B2B — добавляйте безналичный счёт для юрлиц.
2. География. Для РФ — ЮKassa, Тинькофф, Сбербанк, СБП; для Беларуси — bePaid и ЕРИП.
3. Комиссия и вывод. Сравнивайте не только процент, но и сроки зачисления и условия возвратов.
4. Готовый обработчик. Наличие коробочного или маркетплейс-модуля резко сокращает срок внедрения против самописной интеграции по REST.

Разумная практика — подключить 2–3 взаимодополняющих способа: онлайн-карта, СБП и счёт для юрлиц покрывают большинство сценариев без перегрузки страницы оплаты.

Итог

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

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