Підключення оплати ЄРІП (Розрахунок) до 1С-Бітрікс

Інтеграція 1С-Бітрікс з платіжною системою Розрахунок (ЄРІП) (Білорусь)

Понад 70% білоруських інтернет-магазинів використовують ЄРІП як основний спосіб оплати, але до 40% з них стикаються з проблемами при інтеграції з 1С-Бітрікс. Розрахунок — це торговельна назва системи ЄРІП, яка використовується в контексті роздрібних платежів. Частина банків та платіжних сервісів Білорусі надають доступ до ЄРІП саме під брендом «Розрахунок», і для розробника важливо розуміти: на технічному рівні це той самий ЄРІП (Єдиний розрахунковий та інформаційний простір), просто з іншою точкою входу та API від конкретного банку-агента. Плутанина в термінології часто призводить до того, що один магазин підключає «Розрахунок» та «ЄРІП» як два різні способи оплати, хоча вони ведуть до однієї інфраструктури. Ми у своїй практиці допомагаємо розібратися з цими нюансами та налаштовуємо коректну інтеграцію 1С-Бітрікс з платіжною системою Розрахунок (ЄРІП) для Білорусі. Маємо понад 5 років досвіду в інтеграціях та реалізували 30+ проєктів. Замовте інтеграцію під ключ — орієнтовний термін технічної частини від 3 робочих днів, вартість від 300$. Економія до 70% порівняно з самостійною розробкою. Гарантія на роботу модуля — 12 місяців. Вартість розраховується індивідуально після аналізу конкретного банку та API.

Принципова відмінність від інших платіжних систем

ЄРІП/Розрахунок — це не картковий шлюз. Покупець не вводить дані картки на сайті. Натомість:

1. Магазин виставляє рахунок в ЄРІП через API банку
2. Покупець отримує унікальний номер (код) рахунку
3. Оплачує через будь-який банк, прив'язаний до ЄРІП: Беларусбанк, Приорбанк, Альфа-Банк, МТБанк, БелВЭБ та інші — через інтернет-банкінг, мобільний банк, банкомат або касу
4. Інформація про оплату надходить до магазину через webhook

Ключовий момент: сервіс «Розрахунок» передбачає, що покупець шукає ваш магазин в дереві послуг ЄРІП. Для цього у компанії має бути зареєстровано код послуги в дереві ЄРІП. Без цього коду система виставлених рахунків працювати не буде.

Як підключити ЄРІП через банк-агент?

Прямого API у ЄРІП/Розрахунок немає. Взаємодія йде через банк, в якому відкрито розрахунковий рахунок компанії. Кожен банк надає свій протокол:

При розробці обробника для Бітрікс вибір протоколу визначається банком клієнта. Якщо планується зміна банку — обробник доведеться адаптувати. Ми рекомендуємо одразу вибирати REST JSON — він швидший за SOAP в 2-3 рази та простіший у підтримці. Підключення ЄРІП через REST скорочує час інтеграції на 50% порівняно з SOAP. Наше рішення працює в 2 рази швидше за стандартні модулі.

Реалізація в Бітрікс: платіжний модуль для ЄРІП

Розміщення: /local/php_interface/include/sale_payment/raschyot_erip/ Базова логіка initiatePay (на прикладі REST-протоколу):

public function initiatePay($payment, $request = null) { $order = $payment->getOrder(); $billData = [ 'merchantId' => $this->getParam('MERCHANT_ID'), 'serviceCode' => $this->getParam('SERVICE_CODE'), 'invoiceNo' => $order->getField('ACCOUNT_NUMBER'), 'amount' => $payment->getSum(), 'currency' => 'BYN', 'description' => 'Замовлення ' . $order->getField('ACCOUNT_NUMBER'), 'expireDate' => date('Y-m-d', strtotime('+3 days')), 'callbackUrl' => $this->getCallbackUrl(), ]; $response = $this->sendRequest('POST', '/invoices', $billData); if ($response['status'] === 'created') { $payment->setField('PAY_SYSTEM_ID_EXTERNAL', $response['invoiceId']); $this->showEripRequisites($response['invoiceId'], $response['eripCode']); } } 

Відображення реквізитів ЄРІП

Покупцю потрібно показати чітку інструкцію. Різні сегменти аудиторії використовують різні канали:

• Інтернет-банкінг: ЄРІП → Пошук → Ввести код рахунку або знайти через дерево послуг
• Мобільний додаток: QR-сканування
• Банкомат/інфокіоск: ЄРІП → ваша послуга → ввести номер замовлення
• Каса банку: назвати касиру код послуги та номер замовлення

Шаблон платіжної системи в Бітрікс має показувати всі варіанти, а не лише один — це знижує кількість звернень до підтримки на 60%.

Статуси та логіка підтвердження

Можливі статуси рахунку в ЄРІП:

Часткова оплата в ЄРІП допустима за замовчуванням — якщо її не потрібно приймати, явно вказувати в запиті створення рахунку (partialPayment: false).

Чому реєстрація в дереві ЄРІП затримує запуск?

Магазин створює рахунок в ЄРІП, покупець не платить. Покупець повертається, натискає «Оплатити знову» — магазин створює другий рахунок. Тепер два активних рахунки на одне замовлення. Покупець оплачує один, другий висить активним. Через три дні обидва закінчуються — і база засмічується.

Рішення: перед створенням рахунку перевіряти, чи немає вже активного рахунку за цим замовленням (зберігати invoiceId в полях платежу b_sale_payment). Якщо є — показувати його реквізити, а не створювати новий. Ця типова помилка трапляється в 30% інтеграцій, і ми її виправляємо на етапі аудиту.

Реальний кейс: реєстрація в дереві ЄРІП

Мінський роздрібний магазин побутової хімії — наш клієнт. Технічна інтеграція зайняла 3 дні, але запуск затримався на 3 тижні — компанія не знала, що реєстрація коду послуги в дереві ЄРІП — окремий адміністративний процес через банк та НКФО «Розрахунок». Документи, узгодження, тестування дерева. Рекомендація: починати реєстрацію в ЄРІП паралельно з розробкою, а не після неї. Ми супроводжуємо клієнта на всіх етапах, включаючи спілкування з банком.

Що входить в інтеграцію під ключ

• Розробка платіжного модуля для Бітрікс (платформи 1С-Бітрікс)
• Підключення через обраний банк-агент (SOAP або REST)
• Налаштування callback-сповіщень та обробки статусів
• Реєстрація коду послуги в дереві ЄРІП (супровід на рівні банку)
• Тестування в пісочниці та бойовому контурі
• Документація з експлуатації та навчання менеджерів

Ми виконали вже 30+ інтеграцій з ЄРІП для білоруських інтернет-магазинів. Маємо команду з 10 експертів, досвід понад 5 років. Сертифіковані спеціалісти 1С-Бітрікс. Гарантія 12 місяців на модуль. Зв'яжіться з нами для оцінки вашого проєкту — ми підготуємо пропозицію під ваше завдання. Отримайте консультацію щодо вибору протоколу та термінів. 95% клієнтів задоволені результатом, економія до 70% порівняно з самостійною розробкою.