Mono Acquiring — оплата карткою monobank для OpenCart 2.3, 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 490 грн — разова покупка. Ліцензія безстрокова: платите один раз, оновлення й технічна підтримка входять у ціну. Один ключ — один домен і його піддомени.

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

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

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

Спершу тріал, потім оплата. Свіжий інстал — це безкоштовна версія: Pro сам не вмикається і нічого не гасне через тиждень. Коли захочете подивитись Pro — натисніть «Спробувати Pro» в налаштуваннях модуля, вкажіть email і отримайте ключ на 7 днів (він же прийде листом). Тож журнал операцій, hold і повернення ви перевіряєте на власному магазині ще до покупки — саме тому повернення коштів після оплати не передбачене.

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

• OpenCart 4.x — нативне розширення, встановлюється стандартним інсталятором; для 3.0.x і 2.3.0.x у комплекті окремі збірки (2.3 заливається файлами, бо штатний інсталятор тієї версії вміє лише FTP)
• Токен 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. Для 3.0.x беріть mono_acquiring-oc3.ocmod.zip, для 2.3 — mono-oc2.ocmod.zip і залийте теку upload/ у корінь магазину по SFTP.
2. У списку Розширення → Платежі знайдіть Mono Acquiring і натисніть «Встановити» — модуль створить свої таблиці. Pro при цьому не вмикається: тріал видається лише кліком «Спробувати Pro» в налаштуваннях.
3. Відкрийте налаштування, вставте токен (тестовий або бойовий) і натисніть «Перевірити токен» — побачите назву вашого мерчанта.
4. Оберіть тип платежу (списання одразу чи hold), статуси замовлень і збережіть.
5. URL вебхука модуль показує в налаштуваннях і передає банку автоматично при створенні рахунку.
6. Для Pro після покупки вставте ліцензійний ключ з email у поле «Pro-ліцензія».

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

1.1.0 (OpenCart 3.x) — 10 серпня 2026

Збірка під OpenCart 3.0.x перебудована з нуля до рівня версій 4.x і 2.3: та сама модель Free/Pro із тріалом за кліком, журнал платежів, повернення з адмінки, двоетапна оплата, збереження картки й автофіскалізація. Порівняно зі старою збіркою 1.0.5 виправлено дві грошові помилки: сума повернення тепер переводиться у валюту рахунку monobank (раніше запит на $150 повертав 150 ₴), а часткове повернення більше не закриває замовлення — monobank позначає рахунок «reversed» навіть коли повернуто частину, тож залишок лишався неповерненим. Перевірено живими оплатами на тестовому мерчанті: оплата карткою, часткове й повне повернення, підпис вебхука. ⚠️ Двоетапна оплата (hold) у monobank доступна лише для гривні.

1.1.0 (OpenCart 2.3) — 7 серпня 2026

Збірка під OpenCart 2.3.0.x: та сама модель Free/Pro і тріал за кліком, журнал, повернення, двоетапна оплата, збереження картки й автофіскалізація. Виправлено проти старших збірок: сума повернення тепер переводиться у валюту рахунку monobank (раніше запит на $150 повертав 150 ₴); часткове повернення більше не закриває замовлення — monobank позначає рахунок «reversed» навіть коли повернуто частину, тож залишок лишався неповерненим; пізній вебхук «processing» більше не затирає кінцевий статус у журналі; дані картки не стираються при списанні заблокованих коштів. ⚠️ Двоетапна оплата (hold) у monobank доступна лише для гривні.

1.1.0 — 2 серпня 2026

Перебудовано Free/Pro: свіжий інстал — чиста безкоштовна версія, 7-денний тріал стартує лише вашим кліком і видається як справжній ключ на пошту. Pro-межа тепер видима на місці: двоетапна оплата, збереження картки, автофіскалізація й журнал лишаються на екрані, але сірі, з поясненням користі. Виправлено: подія списання заблокованих коштів реєструвалась із крапкою замість «*» — на OpenCart 4 двоетапна оплата не спрацьовувала взагалі; колбек із заниженою сумою більше не зберігається як успішна оплата (раніше це назавжди блокувало наступну повну); повне повернення більше не пишеться в історію двічі; часткові повернення рахуються накопичувально, а ворожа сума відбивається до звернення в API; ліцензія переживає недоступність catcode.com.ua (14-денний пільговий період).

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), повернення, збереження картки, подія автофіскалізації.