Втрата нотифікацій — часта проблема при інтеграції з банківськими шлюзами. Неправильне налаштування HMAC або таймаути призводять до того, що оплата проходить, а статус у Бітрікс не оновлюється. Ми вирішуємо це впровадженням дублюючих запитів через API та верифікацією кожного сповіщення. У результаті — нульова втрата платежів та значна економія на комісіях.
До нас звернувся агрохолдинг з каталогом на 10 000 товарів і значним оборотом. Після підключення стандартного еквайрингу Білагропромбанку вони зіткнулися з втратами нотифікацій: клієнти платили, але замовлення залишалися у статусі «очікування оплати». Причина — неправильне налаштування верифікації та таймаути шлюзу. Ми розробили кастомний обробник з HMAC-перевіркою та дублюванням запитів статусу. Нотифікації перестали втрачатися, а економія на комісіях стала значною за рахунок правильної маршрутизації платежів.
Наша команда займається інтеграціями Бітрікс вже понад 6 років — більше 50 проектів з платіжними шлюзами, включаючи REST API та верстку обробників під вимоги 54-ФЗ. Гарантуємо стабільну роботу та надаємо документацію для бухгалтерії.
Проблеми, які вирішуємо
- Ліміти на Белкарт — шлюз автоматично визначає тип карти, але при тестуванні часто з'ясовується, що для Белкарт встановлені нижчі ліміти. Налаштовуємо моніторинг та попередження, щоб оперативно реагувати.
- Двостадійна оплата — для товарів під замовлення потрібне блокування суми, а не списання. Без двостадійного режиму клієнти чекають повернення, якщо товару немає в наявності. Реалізуємо кнопку «Підтвердити списання» в адмінці.
- Нотифікації — банк надсилає POST-запити, але якщо URL недоступний або верифікація не налаштована, платежі губляться. Додаємо HMAC-перевірку та IP-фільтрацію, а також дублюємо запит статусу через API.
Як підключити інтернет-еквайринг Білагропромбанку до 1С-Бітрікс?
- Подайте заявку в банк — укладіть договір на інтернет-еквайринг (зазвичай 7–14 робочих днів).
- Отримайте тестові доступи — ендпоінт та облікові дані для тестового шлюзу.
- Розробіть кастомний обробник — ми створюємо його в
/local/php_interface/include/sale_payment/bapb_acquiring/. Обробник реєструє замовлення, перевіряє статус, опрацьовує повернення. - Налаштуйте нотифікації — вкажіть публічний URL обробника та налаштуйте верифікацію (HMAC або IP-whitelist).
- Проведіть тестування — перевірте всі сценарії: успішна оплата, відмова, повернення, двостадійний режим.
- Активуйте бойовий режим — після успішного тесту переключіться на бойовий шлюз.
Приклад реєстрації замовлення через API:
{ "merchantId": "BAPB_MERCHANT_ID", "orderNumber": "BXORDER_34567", "amount": 156800, "currency": "BYN", "returnUrl": "https://shop.by/order/success/34567/", "failUrl": "https://shop.by/order/fail/34567/", "notificationUrl": "https://shop.by/bitrix/tools/sale_ps_result.php", "description": "Інтернет-магазин: замовлення №34567", "sessionTimeoutSecs": 1200 } Чому двостадійна оплата скорочує час повернення в 3 рази?
Для магазинів агротехніки, де товар може бути під замовлення, двостадійна схема економить час: спочатку блокуємо суму, після підтвердження наявності — списуємо. Якщо використовувати одностадійну, при відмові клієнту доводиться чекати повернення до 8 робочих днів. З двостадійною — блокування знімається миттєво, і гроші повертаються за 1–2 дні. У Бітрікс це реалізується через кнопку «Підтвердити списання», яка викликає POST /orders/{orderId}/deposit.
Як ми прискорили повернення для магазину садової техніки
З практики: білоруський магазин садової техніки натискав «Зробити повернення» — API повертав success, але гроші приходили через 8 робочих днів замість 3. Причина: використовували refund для зарезервованої (не списаної) суми. Виправили умовою — void при статусі APPROVED, refund при DEPOSITED. Тепер повернення вкладаються в 2–3 дні.
Звітність та звірка
Банк надає API реєстрів: GET /reports/transactions?dateFrom=...&dateTo=.... Автоматизуємо завантаження звіту в кінці дня та порівнюємо з даними Бітрікс. Якщо розбіжності — одразу сигнал про неопрацьовані нотифікації.
Що входить в роботу
- Кастомний обробник платежів з підтримкою двостадійної оплати та повернень.
- Налаштування нотифікацій та верифікації (HMAC або IP-whitelist).
- Автоматичне вивантаження реєстрів для бухгалтерії.
- Документація з налаштування та експлуатації.
- Навчання співробітників роботі з поверненнями та звітами.
- Технічна підтримка на старті.
Порівняння підходів: кастомний обробник vs стандартний модуль
| Критерій | Кастомний обробник | Стандартний модуль |
|---|---|---|
| Підтримка двостадійної оплати | Так | Ні |
| Повернення за void/refund залежно від статусу | Автоматично | Тільки refund |
| HMAC-верифікація нотифікацій | Так | Ні |
| Автоматичне вивантаження реєстрів | Так | Ні |
| Підтримка Белкарт | Повна | Обмежена |
Строки
| Етап | Строк |
|---|---|
| Подання заявки в Білагропромбанк | 1 день |
| Розгляд та укладення договору | 7–14 робочих днів |
| Розробка обробника | 2–3 робочих дні |
| Тестування та налагодження | 1–2 дні |
| Активація бойового режиму | 1–3 дні після успішного тесту |
Технічні вимоги до сервера
- PHP 8.1+, REST API (Wikipedia), cURL, JSON. - MySQL/MariaDB, налаштування індексів для таблиць оплат. - Доступ до зовнішніх запитів: IP банку мають бути дозволені. - Підтримка HTTPS для URL нотифікацій.Чому обирають нас
- Сертифікат 1С-Бітрікс та понад 6 років досвіду інтеграцій.
- Більше 50 реалізованих проектів з платіжними шлюзами.
- Гарантія на результат: обробник працює без збоїв, нотифікації не губляться.
- Надаємо повну документацію та консультації після запуску.
Замовте інтеграцію — оцінимо ваш проект за 1 день. Отримайте консультацію щодо підключення еквайрингу Білагропромбанку до 1С-Бітрікс.