Проект: a-teh.pro
Задача: Подключение оплаты по Системе быстрых платежей (СБП) для юридического лица (ИП) с использованием API Альфа-Банка.
Платформа: 1С-Битрикс
Срок реализации: 24.02.2026 – 07.04.2026
Задача: Подключение оплаты по Системе быстрых платежей (СБП) для юридического лица (ИП) с использованием API Альфа-Банка.
Платформа: 1С-Битрикс
Срок реализации: 24.02.2026 – 07.04.2026
Задача клиента
Клиенту требовалось подключить прием оплаты через СБП на своем сайте a-teh.pro. Первоначально рассматривалось несколько вариантов интеграции (Paykeeper, API банка Точка), но в итоге выбор был сделан в пользу Альфа-Банка как более выгодного по условиям.
Основные требования:
Клиенту требовалось подключить прием оплаты через СБП на своем сайте a-teh.pro. Первоначально рассматривалось несколько вариантов интеграции (Paykeeper, API банка Точка), но в итоге выбор был сделан в пользу Альфа-Банка как более выгодного по условиям.
Основные требования:
- Организовать прием платежей от физических лиц через СБП.
- Интеграция должна работать через штатный модуль rbs.payment для 1С-Битрикс.
- Обеспечить корректную обработку колбэков (callback) от банка для автоматической смены статуса заказа в системе.
- Настроить разделение реквизитов: платежи с определенной платежной системой (ID 16) должны уходить на реквизиты ИП, в то время как другие — на старые реквизиты ИП заказчика.
В процессе реализации возник ряд технических сложностей:
- Ошибка авторизации (Ошибка №5):
- При первом внедрении на продуктивный сервер система возвращала ошибку: «Ошибка №5. Доступ запрещён».
- Причина: Несоответствие логинов/паролей для продуктивного и тестового контуров Альфа-Банка. Для тестового режима использовался домен alfa.rbsuat.com с одними учетными данными, для боевого — payment.alfabank.ru с другими.
- Проблема с Callback-уведомлениями:
- В процессе тестирования на стенде разработки выяснилось, что заказ в Битриксе не переходит в статус «Оплачен», хотя в системе Альфа-Банка платеж проходил успешно.
- Причина: Модуль не обрабатывал входящие колбэки корректно. Банк отправлял запрос на /bitrix/tools/sale_ps_result.php, но из-за настроек модуля и отсутствия необходимого GET-параметра operation=deposited система не фиксировала успешную оплату.
- Маршрутизация платежей:
- В 1С (учетной системе клиента) платежи от тестового заказа приходили на старые реквизиты ИП, хотя должны были уходить на новые реквизиты ИП.
- Решение: Требовалось жестко задать правило: если заказ оформлен с платежной системой ID 16, то в 1С необходимо подставлять реквизиты новые реквизиты ИП.
- Технические ограничения модуля:
- При анализе модуля rbs.payment были выявлены особенности кода (например, наличие проверок на сертификаты cacert.cer и логика обрезки суффикса -api в логине), которые требовали внимания при настройке.
Наше решение
- Двухэтапное тестирование:
- Сначала настройка и отладка проводились на тестовом домене (dev-среде) с использованием тестовых карт Альфа-Банка (4111 1111 1111 1111).
- После успешного прохождения тестов на dev-среде конфигурация была перенесена на прод.
- Активация Callback-механизма:
-В конфигурационном файле модуля config.php был принудительно включен параметр RBS_ENABLE_CALLBACK => true.
-Проведена дополнительная отладка взаимодействия с технической поддержкой Альфа-Банка для уточнения формата отправляемых колбэков. Выяснилось, что модуль ожидает параметр operation, который необходимо было корректно обрабатывать при получении уведомления.
- Настройка продуктивного контура:
-После получения от клиента подтверждения о смене временного пароля на постоянный (по требованию безопасности Альфа-Банка), новые учетные данные (r-a_teh_1-api и новый пароль) были внесены в настройки модуля на боевом сервере.
-Режим работы модуля переключен с «Тестового» на «Боевой».
- Синхронизация с 1С и бизнес-логикой:
-Внесены уточнения для смежников (разработчиков 1С): для корректной маршрутизации платежа в учетной системе необходимо ориентироваться на ID платежной системы (16) при формировании заказа.
Результат
- Успешное проведение первого платежа: Создан и успешно оплачен тестовый заказ через продуктивный контур. Деньги корректно ушли на счет ИП.
- Автоматизация: Статусы заказов в 1С-Битрикс обновляются автоматически после подтверждения оплаты банком (колбэк).
- Стабильность: Платежная система прошла этап «Опытная эксплуатация на бою» и готова к эксплуатации.
- Документирование: В процессе работы над задачей были зафиксированы все изменения (ветка new-sbp-for-ip-551634) и логи взаимодействия, что упростило дальнейшее сопровождение.
Используемые технологии
- CMS: 1С-Битрикс
- Модуль: rbs.payment (Альфа-Банк)
- Интеграция: REST API Альфа-Банка (платежный шлюз)
- Инструменты: Git, xDebug (отладка)