Кейсы

Интеграция оплаты по СБП для ИП через Альфа-Банк на Битрикс

Проект: a-teh.pro

Задача: Подключение оплаты по Системе быстрых платежей (СБП) для юридического лица (ИП) с использованием API Альфа-Банка.

Платформа: 1С-Битрикс

Срок реализации: 24.02.2026 – 07.04.2026
Задача клиента

Клиенту требовалось подключить прием оплаты через СБП на своем сайте a-teh.pro. Первоначально рассматривалось несколько вариантов интеграции (Paykeeper, API банка Точка), но в итоге выбор был сделан в пользу Альфа-Банка как более выгодного по условиям.

Основные требования:

  1. Организовать прием платежей от физических лиц через СБП.
  1. Интеграция должна работать через штатный модуль rbs.payment для 1С-Битрикс.
  2. Обеспечить корректную обработку колбэков (callback) от банка для автоматической смены статуса заказа в системе.
  3. Настроить разделение реквизитов: платежи с определенной платежной системой (ID 16) должны уходить на реквизиты ИП, в то время как другие — на старые реквизиты ИП заказчика.

В процессе реализации возник ряд технических сложностей:

  1. Ошибка авторизации (Ошибка №5):
  2. При первом внедрении на продуктивный сервер система возвращала ошибку: «Ошибка №5. Доступ запрещён».
  3. Причина: Несоответствие логинов/паролей для продуктивного и тестового контуров Альфа-Банка. Для тестового режима использовался домен alfa.rbsuat.com с одними учетными данными, для боевого — payment.alfabank.ru с другими.
  4. Проблема с Callback-уведомлениями:
  5. В процессе тестирования на стенде разработки выяснилось, что заказ в Битриксе не переходит в статус «Оплачен», хотя в системе Альфа-Банка платеж проходил успешно.
  6. Причина: Модуль не обрабатывал входящие колбэки корректно. Банк отправлял запрос на /bitrix/tools/sale_ps_result.php, но из-за настроек модуля и отсутствия необходимого GET-параметра operation=deposited система не фиксировала успешную оплату.
  7. Маршрутизация платежей:
  8. В 1С (учетной системе клиента) платежи от тестового заказа приходили на старые реквизиты ИП, хотя должны были уходить на новые реквизиты ИП.
  9. Решение: Требовалось жестко задать правило: если заказ оформлен с платежной системой ID 16, то в 1С необходимо подставлять реквизиты новые реквизиты ИП.
  10. Технические ограничения модуля:
  11. При анализе модуля rbs.payment были выявлены особенности кода (например, наличие проверок на сертификаты cacert.cer и логика обрезки суффикса -api в логине), которые требовали внимания при настройке.

Наше решение

  1. Двухэтапное тестирование:

- Сначала настройка и отладка проводились на тестовом домене (dev-среде) с использованием тестовых карт Альфа-Банка (4111 1111 1111 1111).

- После успешного прохождения тестов на dev-среде конфигурация была перенесена на прод.

  1. Активация Callback-механизма:

-В конфигурационном файле модуля config.php был принудительно включен параметр RBS_ENABLE_CALLBACK => true.

-Проведена дополнительная отладка взаимодействия с технической поддержкой Альфа-Банка для уточнения формата отправляемых колбэков. Выяснилось, что модуль ожидает параметр operation, который необходимо было корректно обрабатывать при получении уведомления.

  1. Настройка продуктивного контура:

-После получения от клиента подтверждения о смене временного пароля на постоянный (по требованию безопасности Альфа-Банка), новые учетные данные (r-a_teh_1-api и новый пароль) были внесены в настройки модуля на боевом сервере.

-Режим работы модуля переключен с «Тестового» на «Боевой».

  1. Синхронизация с 1С и бизнес-логикой:

-Внесены уточнения для смежников (разработчиков 1С): для корректной маршрутизации платежа в учетной системе необходимо ориентироваться на ID платежной системы (16) при формировании заказа.

Результат
  • Успешное проведение первого платежа: Создан и успешно оплачен тестовый заказ через продуктивный контур. Деньги корректно ушли на счет ИП.
  • Автоматизация: Статусы заказов в 1С-Битрикс обновляются автоматически после подтверждения оплаты банком (колбэк).
  • Стабильность: Платежная система прошла этап «Опытная эксплуатация на бою» и готова к эксплуатации.
  • Документирование: В процессе работы над задачей были зафиксированы все изменения (ветка new-sbp-for-ip-551634) и логи взаимодействия, что упростило дальнейшее сопровождение.

Используемые технологии
  • CMS: 1С-Битрикс
  • Модуль: rbs.payment (Альфа-Банк)
  • Интеграция: REST API Альфа-Банка (платежный шлюз)
  • Инструменты: Git, xDebug (отладка)