Подключение эквайринга Альфа-Банка

Интернет-эквайринг Альфа-Банка работает на платёжном шлюзе семейства RBS — том же, что и у Сбербанка. Это упрощает подключение к 1С-Битрикс: логика REST-запросов, реквизиты и обработчики почти идентичны. Разберём, как получить доступы, настроить платёжную систему и не забыть про фискализацию.

Как устроен эквайринг Альфа-Банка

Интернет-эквайринг Альфа-Банка построен на платёжном шлюзе RBS (Realtime Banking Solutions, платформа BPC) — той же технологической базе, что используют Сбербанк и ряд других банков. Для интегратора это ключевой факт: взаимодействие идёт через понятный REST API, а поведение шлюза совпадает со сбербанковским с точностью до адресов и реквизитов.

Схема оплаты стандартная для внешнего эквайринга: покупатель на сайте формирует заказ, магазин запросом register.do регистрирует заказ на стороне банка и получает ссылку на платёжную форму. Клиент вводит данные карты уже на защищённой странице банка (сайт карточных данных не видит), проходит 3-D Secure, после чего возвращается на returnUrl или failUrl. Магазин уточняет финальный статус запросом getOrderStatusExtended.do.

• register.do / registerPreAuth.do — регистрация одно- или двухстадийного платежа;
• deposit.do — списание ранее захолдированной суммы;
• reverse.do — отмена (полный откат холда);
• refund.do — возврат средств по завершённой оплате.

Заявка на подключение и получение реквизитов

Технической настройке предшествует организационная часть. Нужно заключить договор интернет-эквайринга с Альфа-Банком, пройти проверку сайта (наличие оферты, контактов, реквизитов юрлица, описания товара, условий возврата) и дождаться выдачи доступов к личному кабинету и платёжному шлюзу.

Для интеграции с Битрикс от банка потребуются:

• Логин и пароль API (userName и password) — служебная учётная запись мерчанта, отдельная от логина в личный кабинет; либо token, если банк выдаёт доступ по токену вместо пары логин/пароль;
• Адреса шлюза — боевой https://pay.alfabank.ru/payment/rest/ и тестовый https://web.rbsuat.com/ab/rest/;
• Настройки уведомлений и колбэков — URL, на который банк присылает статус, и симметричный/асимметричный ключ подписи, если включена проверка.

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

Платёжные системы в 1С-Битрикс живут в разделе Магазин → Настройки → Платёжные системы (модуль sale). Здесь два пути подключения Альфа-Банка.

1. Модуль из Маркетплейс. Банк и партнёры публикуют готовые решения — установите модуль через Marketplace → Установить решение, после чего в списке обработчиков появится «Альфа-Банк». Это предпочтительный вариант: обработчик учитывает нюансы шлюза и обновляется.
2. Штатный обработчик RBS/Сбербанк. При добавлении платёжной системы выберите обработчик sberbank (или универсальный REST) и переопределите адреса на альфовские. Схема запросов совпадает, но фискализацию и подпись проверьте отдельно.

В параметрах обработчика заполняются:

Платёжную систему обязательно привяжите к нужному типу плательщика (например, «Физическое лицо») — иначе способ оплаты не покажется в оформлении заказа.

Одностадийная и двухстадийная оплата

Шлюз поддерживает две модели списания, и выбирать их нужно осознанно, исходя из бизнес-процесса магазина.

• Одностадийная (register.do) — сумма списывается с карты сразу при успешной оплате. Подходит, когда товар в наличии и заказ подтверждается автоматически.
• Двухстадийная (registerPreAuth.do) — сначала на карте холдируется сумма, а фактическое списание выполняется отдельным вызовом deposit.do после сборки заказа. Если товара нет — холд снимается через reverse.do.

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

Фискализация и чеки по 54-ФЗ

Онлайн-оплата картой — это расчёт, который по 54-ФЗ требует фискального чека. Есть два подхода, и их важно не перепутать при настройке.

• Чек на стороне банка. Альфа-Банк может фискализировать платёж через своего ОФД. Для этого в запрос register.do передаётся состав корзины в параметре orderBundle — позиции, цены, количество, ставка НДС (taxType) и признак способа/предмета расчёта.
• Чек на стороне магазина. Пробивается штатным модулем «Кассы» Битрикс (Магазин → Кассы) через подключённую онлайн-кассу или облачного оператора (АТОЛ Онлайн, Бизнес.Ру, Orange Data и т. п.), независимо от эквайринга.

Для корректного orderBundle проверьте, что у товаров заданы ставки НДС и настроены системы налогообложения в модуле магазина.

Тестовый режим и проверка перед запуском

До перевода в бой всё отлаживается на тестовом контуре Альфа-Банка (адреса web.rbsuat.com). Банк предоставляет тестовые доступы и номера карт, по которым эмулируются успешная оплата, отказ и прохождение 3-D Secure.

Минимальный чек-лист приёмки:

1. Оформить тестовый заказ и убедиться, что происходит редирект на платёжную форму банка;
2. Проверить возврат на returnUrl и корректную смену статуса заказа на «Оплачен»;
3. Смоделировать неуспешную оплату и проверить failUrl — заказ не должен помечаться оплаченным;
4. Проверить приход банковского колбэка/уведомления и совпадение суммы;
5. Для двухстадийной схемы — прогнать холд, списание и отмену;
6. Сверить фискальный чек (если включён) в тестовом ОФД.

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

Типичные ошибки и их диагностика

Большинство проблем при подключении Альфа-Банка сводится к нескольким повторяющимся причинам. Диагностику начинайте с логов платёжной системы Битрикс (Магазин → Настройки → Платёжные системы → журнал) и ответа шлюза — в нём поле errorCode и errorMessage.

Отдельно проверьте, что сумма и валюта заказа передаются в минимальных единицах, как ждёт шлюз (копейки), и что returnUrl указывает на публично доступный адрес сайта, а не на локальный или служебный хост.

Итог

Подключение эквайринга Альфа-Банка к 1С-Битрикс — это связка организационных шагов (договор, доступы API) и технической настройки платёжной системы на шлюзе семейства RBS. Ключевые решения: выбрать обработчик (модуль Маркетплейс или штатный RBS/Сбербанк), определиться с одно- или двухстадийной оплатой, корректно закрыть 54-ФЗ и обкатать все сценарии на тестовом контуре.

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