Подключение bePaid ЕРИП (Беларусь)

bePaid — белорусский платёжный сервис, который закрывает сразу два канала: эквайринг банковских карт и оплату через ЕРИП (систему «Расчёт»). Для интернет-магазина на 1С-Битрикс, работающего в Беларуси, связка bePaid + ЕРИП часто обязательна: значительная часть покупателей платит именно через дерево «Расчёт» в интернет-банкинге. Разберём, как корректно подключить этот способ оплаты и не сломать логику заказов.

Что такое bePaid и ЕРИП и зачем связка

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

bePaid выступает расчётным (платёжным) агентом: он регистрирует услугу вашего магазина в дереве «Расчёт», принимает деньги и передаёт магазину статус оплаты. При этом bePaid даёт единый API и личный кабинет и на карточный эквайринг (Visa, Mastercard, Белкарт), и на ЕРИП.

• Карта — оплата мгновенная, покупатель не уходит с сайта.
• ЕРИП — оплата отложенная: клиент получает номер заказа и оплачивает его позже в своём банке, а статус приходит асинхронно.

Что нужно подготовить до настройки

Техническая настройка в 1С-Битрикс — последний шаг. Сначала закрываются организационные вопросы на стороне bePaid и ЕРИП:

1. Заключён договор с bePaid и подключён приём платежей через ЕРИП (это отдельная услуга, не всегда включена по умолчанию).
2. Ваша услуга зарегистрирована в дереве «Расчёт» — получен номер услуги и путь (раздел → подраздел), по которому покупатель вас найдёт.
3. В личном кабинете bePaid получены идентификатор магазина (shop_id) и секретный ключ (secret_key).
4. Валюта расчётов — белорусский рубль BYN (числовой код 933). Убедитесь, что она заведена в магазине.

Обработчик bePaid в 1С-Битрикс

В коробке 1С-Битрикс нет штатного обработчика bePaid — в отличие от ЮKassa или Сбербанка. Есть три рабочих пути:

Собственный обработчик размещается в каталоге /bitrix/php_interface/include/sale_payment/ (или в своём модуле). Обработчик формирует запрос в API bePaid, передаёт сумму заказа через макрос PAYMENT_SHOULD_PAY, идентификатор заказа ORDER_ID и указывает тип платежа erip, чтобы платёж пошёл именно через «Расчёт», а не через карту.

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

Платёжные системы настраиваются в разделе Магазин → Настройки → Платёжные системы (страница sale_pay_system.php). Порядок действий:

1. Нажмите «Добавить платёжную систему» и выберите обработчик bePaid.
2. Заполните параметры бизнес-логики: shop_id и secret_key из личного кабинета.
3. Задайте название способа оплаты понятно для покупателя — например, «Оплата через ЕРИП (Расчёт)».
4. Проверьте, что сумма к оплате подставляется из PAYMENT_SHOULD_PAY, а валюта заказа — BYN.

Отдельно свяжите способ оплаты с нужным типом плательщика (физлицо / юрлицо) в настройках платёжной системы. Для ЕРИП это обычно физлица. Если карту и ЕРИП вы предлагаете как разные кнопки, заведите две платёжные системы с одним обработчиком, но разными параметрами метода оплаты.

Как проходит оплата через ЕРИП

Сценарий отличается от карточного эквайринга и это важно донести до покупателя прямо на странице оплаты:

1. Клиент оформляет заказ и выбирает «Оплата через ЕРИП».
2. Магазин через bePaid регистрирует платёж, получает номер заказа в системе «Расчёт».
3. Покупатель заходит в свой интернет-банкинг, идёт по дереву ЕРИП: раздел → подраздел → ваша услуга, вводит номер заказа и оплачивает.
4. bePaid фиксирует оплату и присылает магазину уведомление (webhook).

Хорошая практика — выводить покупателю на странице «спасибо за заказ» краткую инструкцию: путь в дереве ЕРИП и номер заказа, а также дублировать их в письме.

Webhook и смена статуса заказа

Поскольку оплата отложенная, корректная обработка уведомлений — самая ответственная часть интеграции. В личном кабинете bePaid указывается URL уведомления (webhook), на который сервис шлёт статус платежа.

• Обработчик принимает уведомление, проверяет подпись (по secret_key), сверяет сумму и идентификатор заказа ORDER_ID.
• При успешной оплате заказ в Битрикс переводится в оплаченный: устанавливается флаг PAYED = "Y" у платежа заказа.
• Только после этого запускается резервирование и логика отгрузки/уведомлений.

URL webhook должен быть доступен извне и отвечать корректным кодом, иначе bePaid будет повторять попытки, а заказ зависнет в неоплаченных.

Тестирование и типичные ошибки

Перед запуском включите тестовый режим (тестовые shop_id / secret_key из песочницы bePaid) и проведите полный цикл: заказ → номер ЕРИП → оплата в тесте → приход webhook → смена статуса.

• Несовпадение валюты — заказ не в BYN; проверьте валюту заказа и настройки магазина.
• Заказ не переходит в оплаченный — webhook не доходит (закрыт извне, отдаёт 500) или падает проверка подписи.
• Покупатель не находит услугу в дереве — услуга не зарегистрирована в ЕРИП или указан неверный путь.
• Двойные оплаты/статусы — обработчик не идемпотентен, обрабатывает повторные уведомления как новые.

Логируйте входящие уведомления и запросы к API — при разборе спорных платежей это экономит часы. Полезно смотреть журнал в Магазин → Настройки → Журнал и логи веб-сервера.

Итог

Подключение bePaid с ЕРИП в 1С-Битрикс — это не просто «вставить ключи»: ключевое отличие от карточного эквайринга в отложенной оплате. Нужно правильно завести валюту BYN, зарегистрировать услугу в дереве «Расчёт», настроить обработчик и — самое важное — надёжно обрабатывать webhook с проверкой подписи и суммы, меняя статус заказа только по факту подтверждённой оплаты.

Мы в B2Bsite подключаем bePaid и ЕРИП белорусским магазинам под ключ: пишем и отлаживаем обработчик, настраиваем валюту и типы плательщиков, проверяем webhook и сценарии оплаты в песочнице. Если нужна нестандартная логика или интеграция с 1С и CRM — поможем свести всё в один рабочий процесс.