Monobank Acquiring — один із найпопулярніших платіжних шлюзів в Україні. Він підтримує Visa, Mastercard і Apple Pay, не потребує тривалого підключення та має прозору комісію. Інтегрувати його у Laravel або OpenCart — задача на кілька днів, якщо знати, де підводні камені.
Чому Monobank Acquiring, а не конкурент
LiqPay і WayForPay теж надійні шлюзи. Але Monobank виграє у мобільних покупців: кнопка Apple Pay з'являється одразу, без додаткових налаштувань. Для інтернет-магазинів, де понад 60% трафіку — смартфони, це пряма різниця в конверсії.
Як виглядає інтеграція у Laravel
Laravel-інтеграція будується на офіційному REST API Monobank. Основний flow складається з чотирьох кроків.
1. Ініціалізація платежу
POST-запит до https://api.monobank.ua/api/merchant/invoice/create повертає invoiceId та pageUrl. Покупець переходить на pageUrl — платіж проходить на стороні банку.
2. Webhook-обробник
Monobank надсилає POST на callback URL зі статусом платежу (success, failure, reversed). Laravel слухає на захищеному маршруті, верифікує підпис X-Sign за публічним ключем банку та оновлює статус замовлення.
3. Ідемпотентність
Мережеві збої призводять до повторних webhook-ів. Перевірка invoiceId на унікальність перед обробкою запобігає подвійному зарахуванню.
4. Повернення коштів
API підтримує повний і частковий рефанд через POST /api/merchant/invoice/cancel — зручно для CRM-автоматизації та обробки повернень у менеджері замовлень.
OpenCart: модуль замість хаку
Для OpenCart ми розробляємо окремий платіжний модуль у стандартній архітектурі MVC. Адмін-панель дозволяє вводити merchantId і токен, обирати статуси для success/failure, налаштовувати мінімальну суму платежу. Жодного прямого редагування core-файлів — модуль оновлюється незалежно від версії магазину.
Що ми доставляємо
- Laravel service-клас для Monobank API з unit-тестами
- Webhook-контролер із верифікацією підпису X-Sign
- OpenCart-модуль (2.3 / 3.x / 4.x) з адмін-UI
- Документацію для команди підтримки та QA-чеклист
Хочеш приймати платежі через Monobank вже цього тижня? Звертайся до MaxiMoruM — підключимо, протестуємо та здамо готове рішення.