Ми вже не раз стикалися з ситуацією, коли білоруський інтернет-магазин втрачає до 30% замовлень тільки тому, що в списку способів оплати немає ЄРІП. Для місцевого ринку це не просто опція, а необхідність — понад 90% усіх безготівкових платежів у Білорусі проходить саме через Єдине розрахункове та інформаційне простір. Без ЄРІП ви відсікаєте значну частину аудиторії, звиклої оплачувати через банкомат, інтернет-банкінг або мобільний додаток. Маємо 7+ років досвіду інтеграції платіжних систем та 30+ успішних проектів з ЄРІП, тому гарантуємо якість.
Переваги ЄРІП перед картковим еквайрингом
ЄРІП — не миттєва оплата, а процес: магазин реєструє рахунок через API банку-агента, покупець отримує номер або QR-код ЄРІП і оплачує його в будь-якому банку чи терміналі. Потім система надсилає нотифікацію. Вартість транзакції через ЄРІП значно нижча, ніж при картковому еквайрингу.
Порівняння з класичним еквайрингом:
| Параметр | Картковий еквайринг | ЄРІП |
|---|---|---|
| Миттєвість оплати | Так (онлайн) | Ні (потрібна ручна оплата) |
| Охоплення аудиторії | Власники карток | Всі громадяни РБ |
| Повернення | Стандартний | Через банк, довше |
Чому ЄРІП критично важливий для білоруського e-commerce?
За даними Нацбанку, близько 40% населення не використовують банківські картки для онлайн-платежів, надаючи перевагу терміналам та інтернет-банкінгу. ЄРІП дає доступ до цієї аудиторії, збільшуючи конверсію на 10–20%. Типовий інтернет-магазин отримує 50–200 транзакцій через ЄРІП на день, причому 70% з них — рекурентні.
Як ми реалізуємо інтеграцію з ЄРІП в 1С-Бітрікс
Оскільки єдиного API не існує, інтеграція будується як кастомний обробник платежів Бітрікс модуля sale, адаптований під API банку конкретного банку. Типова структура обробника в /local/php_interface/include/sale_payment/erip/:
handler.php — логіка виставлення рахунків та перевірки статусу .description.php — метадані, назва, іконка .settings.php — bankApiUrl, merchantId, apiKey, serviceCode template/ — відображення реквізитів покупцеві Приклад запиту до банку для реєстрації рахунку
{ "merchantId": "YOUR_MERCHANT_ID", "serviceCode": "ERIP_SERVICE_CODE", "invoiceNumber": "ORD-12345", "amount": 125.50, "currency": "BYN", "description": "Оплата замовлення №12345", "expireAt": "YYYY-MM-DDTHH:MM:SS", "callbackUrl": "https://yourshop.by/bitrix/tools/sale_ps_result.php", "returnUrl": "https://yourshop.by/personal/order/detail/12345/" } serviceCode — код послуги в дереві ЄРІП, присвоюється банком при підключенні. За ним покупець знаходить магазин у меню ЄРІП («Інтернет-магазини → Категорія → Ваш магазин»).
Як відобразити реквізити покупцеві?
Після виставлення рахунку покажіть:
- Номер рахунку в ЄРІП (або QR-код ЄРІП) для оплати вручну.
- Інструкцію: «Інтернет-банкінг → ЄРІП → Пошук за номером» або шлях через дерево послуг.
- Термін дії рахунку (зазвичай 24–72 години).
- QR-код ЄРІП для швидкої оплати через мобільний банк.
Шаблон template/ компонента платіжної системи відповідає за цей екран. Стандартна сторінка «дякую за замовлення» тут не підходить — потрібна сторінка очікування оплати з динамічним оновленням статусу через AJAX або WebSocket.
Як обробляти нотифікації платежів та підтверджувати оплату?
Банк надсилає POST-повідомлення на callbackUrl при надходженні платежу. Обробник повинен:
- Верифікувати підпис запиту (HMAC, RSA або IP-whitelist залежно від банку).
- Знайти платіж за
invoiceNumberабоbillId. - Перевірити відповідність суми — покупець міг оплатити частково.
- Викликати
$payment->setPaid('Y')тільки при повній оплаті. - Оновити статус замовлення згідно з бізнес-логікою.
Часткова оплата ЄРІП — специфіка системи. ЄРІП допускає оплату рахунку кількома транзакціями. Якщо це небажано, при реєстрації рахунку вказуйте partialPaymentAllowed: false.
З нашої практики: у білоруського магазину будматеріалів покупець оплатив рахунок у ЄРІП, але замовлення не підтвердилося через розбіжність у сумі при ручному введенні. Рішення — додати автоматичне повідомлення менеджера при відхиленні до 1% та інтерфейс ручного підтвердження в адміністративній частині. У вашому проекті ми передбачимо подібні сценарії.
Що входить у роботу
- Аналіз обраного банку-агента та отримання API-документації.
- Розробка кастомного обробника з урахуванням специфіки протоколу банку.
- Налаштування шаблону відображення реквізитів та сторінки очікування оплати.
- Інтеграція webhook-повідомлень та обробка часткових оплат.
- Реєстрація послуги в дереві ЄРІП (супровід на стороні банку).
- Тестування повного циклу: виставлення рахунків → оплата → підтвердження.
- Надання документації з налаштування та експлуатації.
Строки та етапи
| Етап | Строк |
|---|---|
| Отримання API-доступу від банку | 3–10 робочих днів |
| Розробка обробника | 2–4 дні |
| Інтеграція та тестування | 1–2 дні |
| Реєстрація послуги в дереві ЄРІП | 5–15 робочих днів (банк + НКФО) |
Реєстрація в дереві ЄРІП — найдовший етап, який не залежить від розробника. Починайте його паралельно з розробкою.
Зв'яжіться з нами, щоб підключити ЄРІП до вашого інтернет-магазину на 1С-Бітрікс — оцінимо проект за 1 день і запропонуємо оптимальне рішення під ваш банк. Гарантуємо коректну обробку всіх сценаріїв: часткові оплати, повернення, помилки. Маємо сертифікат партнера 1С-Бітрікс та досвід роботи з банками РБ.
Спираємося на офіційну документацію ЄРІП та багаторічний досвід роботи з платіжними системами Бітрікс.