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

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

Як працює mono acquiring в OpenCart

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

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

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