MonoBank — один з найпопулярніших банків серед українських підприємців. Якщо ваш інтернет-магазин або система виставлення рахунків працює на Odoo, є прямий спосіб приймати оплати через MonoPay без ручного звіряння платежів: модуль payment_monobank від KitWorks Systems інтегрує еквайринг MonoBank безпосередньо в стандартний механізм платежів Odoo. Ця стаття — для власника бізнесу або ops-менеджера, який хоче розібратись: що відбувається з замовленням після оплати і що потрібно для запуску.
Що таке MonoPay-еквайринг і навіщо підключати його в Odoo
Інтернет-еквайринг MonoBank: що це дає бізнесу
MonoPay — платіжна система MonoBank для прийому онлайн-платежів. Покупець може розплатитись карткою будь-якого банку, через Apple Pay або Google Pay. Для підприємця достатньо мати відкритий ФОП-рахунок у MonoBank і активований еквайринг — тоді банк видає токен для роботи з API.
MonoBank офіційно підтримує плагіни для Shopify, WIX, PrestaShop, Joomla та Odoo. Тобто підключення через готовий модуль — це очікуваний і підтримуваний банком сценарій.
Чому підключати прямо в Odoo, а не окремою касою
Якщо приймати оплату поза Odoo (наприклад, через окремий особистий кабінет MonoPay), статус замовлення в Odoo треба оновлювати вручну. При десятках замовлень на день — це джерело помилок: замовлення "зависають" у статусі "очікує оплати", менеджери плутаються, клієнти не отримують підтвердження вчасно.
Інтеграція через модуль вирішує це одним webhook-ом.
Як виглядає оплата з боку покупця
Flow від кошика до підтвердження
- Покупець вибирає "MonoPay" на сторінці оплати в Odoo Shop.
- Odoo перенаправляє його на захищену платіжну сторінку MonoPay (pageUrl), де відображається сума і назва замовлення.
- Покупець вводить дані картки або використовує Apple Pay / Google Pay.
- Після успішної оплати MonoPay автоматично повертає покупця на сторінку підтвердження в Odoo.
Покупець завжди лишається в знайомому середовищі — платіжна сторінка MonoPay виглядає як стандартна для всіх, хто вже платив через MonoPay (а це більшість українських онлайн-покупців).
Способи оплати
Через MonoPay приймаються: картки Visa / Mastercard будь-якого банку, Apple Pay, Google Pay та інші методи, підтримувані MonoPay на момент платежу.
Що відбувається в Odoo після оплати
Автоматичне оновлення статусу замовлення
Це ключова частина. Після того як покупець оплатив, MonoBank надсилає webhook на Odoo з підписом X-Sign. Odoo перевіряє підпис (ECDSA SHA-256 за публічним ключем MonoBank), і якщо верифікація пройшла — статус транзакції оновлюється автоматично: success переводить замовлення у "Оплачено", failure або expired — у відповідний статус помилки.
Менеджер бачить актуальний стан замовлення в режимі реального часу без жодних ручних дій.
Автоматичне виставлення рахунку (опція)
В налаштуваннях Sales → General Settings є опція автоматичного створення рахунку після підтвердження онлайн-оплати. Якщо активувати — Odoo сам виставляє рахунок і одразу переводить його в статус "Оплачено". Це зручно для магазинів, де рахунок потрібен для обліку або для передачі в бухгалтерію.
Безпека: перевірка підпису webhook
Кожен вхідний webhook від MonoBank містить заголовок X-Sign з цифровим підписом. Модуль перевіряє цей підпис за публічним ключем MonoBank (якщо ключ ще не збережений — завантажує автоматично). Webhook без коректного підпису ігнорується. Це захист від підроблених сповіщень про "оплату", яких не було.
Підключення: що потрібно
Передумови
- Відкритий ФОП-рахунок у MonoBank з активованим інтернет-еквайрингом.
- Токен API з особистого кабінету MonoBank (видається після активації еквайрингу).
- Odoo 14, 15, 16, 17, 18 або 19 (модуль підтримує всі актуальні версії).
Три кроки налаштування в Odoo
- Встановити модуль payment_monobank з Odoo Apps Store (разом із залежністю
kw_payment_base). - Перейти в Invoicing → Settings → Payment Providers → MonoBank і вставити токен із особистого кабінету MonoBank.
- Налаштувати вигляд: іконки платіжних методів, сповіщення під час та після оплати, автоматичне виставлення рахунку — за потребою.
Готово. Після збереження MonoPay з'являється як опція оплати на сайті та у B2B-рахунках.
Підсумок
MonoPay-еквайринг в Odoo — це не просто кнопка "оплатити". Це повний цикл: покупець платить, Odoo отримує підтверджений webhook, статус замовлення оновлюється автоматично, рахунок виставляється (опціонально) — без ручного втручання менеджера. Для решти платіжних провайдерів, доступних для Odoo в Україні (LiqPay, WayforPay, RozetkaPay тощо), дивіться огляд усіх платіжних систем для Odoo.
Якщо хочете підключити MonoPay або іншу платіжну систему до вашого Odoo — команда KitWorks Systems налаштує інтеграцію під ваш процес.