Mono Acquiring — оплата карткою monobank для OpenCart 3.x & 4.x

Mono Acquiring для OpenCart 4 — платіжний модуль, який додає у магазин оплату карткою через еквайринг monobank. Модуль створює рахунок через API банку, відправляє покупця на захищену платіжну сторінку monobank, а після оплати приймає вебхук, звіряє його ECDSA-підпис і сам змінює статус замовлення. Адміністратору не треба вручну перевіряти, хто оплатив — статуси в OpenCart оновлюються автоматично.

Базова версія — безкоштовна. Скачати з офіційного OpenCart marketplace: opencart.com/…/extension_id=48694. Pro-ліцензія додає журнал платежів зі звіркою статусів, двоетапну оплату (hold), часткові та повторні повернення, збереження картки покупця для оплати в 1 клік і подію автофіскалізації чека для ПРРО.

Як це працює — крок за кроком

1. Покупець у чекауті обирає оплату карткою monobank і підтверджує замовлення.
2. Модуль звертається до API monobank, створює рахунок із заданим часом життя і перенаправляє покупця на платіжну сторінку банку — картку він вводить на стороні monobank, а не у вашому магазині.
3. Банк надсилає вебхук на адресу extension/mono_acquiring/payment/mono.callback. Модуль перевіряє ECDSA-підпис (заголовок X-Sign) і ставить замовленню статус, який ви обрали в налаштуваннях: окремо для успішної оплати, невдалої/простроченої та повернення.
4. При двоетапній оплаті (Pro) кошти спочатку блокуються на картці, а списуються, коли ви підтверджуєте замовлення — зручно, якщо треба перевірити наявність товару перед списанням.
5. Повернення (Pro) робиться з журналу платежів в адмінці: повне або на вказану суму, без входу в кабінет банку.

Що включено в ліцензії

Скільки коштує

1 990 грн — ліцензія на рік. Рік оновлень, технічної підтримки та доступу до всіх Pro-функцій. Без автосписань: продовження завжди вручну, реквізити картки ми не зберігаємо.

Можна одразу взяти довший термін — що довший, то дешевше за рік:

• 1 рік — 1 990 грн
• 2 роки — 3 780 грн (−5%, по 1 890 грн за рік)
• 3 роки — 5 250 грн (−12%, по 1 750 грн за рік)
• 4 роки — 6 530 грн (−18%, по 1 630 грн за рік)
• 5 років — 7 460 грн (−25%, по 1 490 грн за рік)

Коли термін спливає, вимикаються лише Pro-функції — безкоштовна версія працює далі, налаштування і дані нікуди не діваються. Щоб знову відкрити Pro, достатньо продовжити ліцензію в особистому кабінеті. Нагадаємо на пошту за 14, 7, 3 і 1 день до завершення.

Один ключ — один домен. Переносите магазин — деактивуйте ліцензію на старому домені й активуйте на новому самостійно, без звернення до підтримки.

Спершу тріал, потім оплата. Одразу після встановлення вмикається 7-денний безкоштовний Pro-тріал: журнал операцій, hold і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

Технічні вимоги

• OpenCart 4.x — нативне розширення, встановлюється стандартним інсталятором
• Токен monobank: бойовий (X-Token) — з кабінету мерчанта після укладання договору; тестовий — безкоштовно на api.monobank.ua
• Магазин має бути доступний з інтернету по HTTPS — інакше вебхук від банку не дійде

Що під капотом

• Криптографічна перевірка вебхуків: підпис X-Sign (base64 ECDSA-SHA256) звіряється з публічним ключем мерчанта — фальшивий запит «замовлення оплачено» модуль відкине.
• Власні таблиці cc_mono_order і cc_mono_card — платежі та wallet-токени карток зберігаються окремо і не чіпають стандартні таблиці OpenCart.
• Повний API-клієнт monobank: створення рахунку з передачею складу кошика (basketOrder), запит статусу, finalize для hold-платежів, повернення.
• Двомовна адмінка — українська та англійська локалізації з коробки.
• Автофіскалізація через подію OpenCart — ПРРО-модуль підписується на подію і видає чек одразу після успішної оплати.

Як встановити

1. Завантажте mono_acquiring.ocmod.zip через Розширення → Інсталятор в адмінці OpenCart.
2. У списку Розширення → Платежі знайдіть Mono Acquiring і натисніть «Встановити» — модуль створить свої таблиці й запустить 7-денний тріал Pro.
3. Відкрийте налаштування, вставте токен (тестовий або бойовий) і натисніть «Перевірити токен» — побачите назву вашого мерчанта.
4. Оберіть тип платежу (списання одразу чи hold), статуси замовлень і збережіть.
5. URL вебхука модуль показує в налаштуваннях і передає банку автоматично при створенні рахунку.
6. Для Pro після покупки вставте ліцензійний ключ з email у поле «Pro-ліцензія».

Історія версій

1.0.3 — 23 липня 2026

Виправлено конфлікт при оформленні замовлення на OpenCart 4.0.2.x: перевірка гео-зони більше не завантажує відсутню в цій версії каталогу модель і не блокує вибір способу оплати чи доставки.

1.0.1 — липень 2026

Виправлено встановлення на OpenCart 4.1: подія списання утримання реєструвалася у форматі OpenCart 4.0, через що установка модуля переривалася помилкою.

1.0.0 — липень 2026

Перший публічний реліз: оплата на платіжній сторінці monobank, вебхук-підтвердження з перевіркою ECDSA-підпису, тестовий режим, налаштування статусів і гео-зони; у Pro — журнал платежів, двоетапна оплата (hold), повернення, збереження картки, подія автофіскалізації.