Mono Acquiring — оплата карткою monobank для WooCommerce

Mono Acquiring для WooCommerce — платіжний плагін, що під’єднує еквайринг monobank до вашого магазину. Покупець оплачує замовлення карткою Visa або Mastercard на захищеній сторінці monobank, а плагін сам підтверджує оплату: банк надсилає вебхук, плагін перевіряє його ECDSA-підпис і переводить замовлення у потрібний статус. Жодної ручної звірки платежів — статус у WooCommerce завжди відповідає статусу в банку.

Базова версія — безкоштовна. Скачати: mono-acquiring-for-woocommerce-1.0.0.zip. Pro-ліцензія розблоковує журнал платежів зі звіркою статусів, двоетапну оплату (hold), повернення в один клік, збереження картки покупця і хук автофіскалізації для ПРРО.

Що отримує адмін

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

1. Покупець на чекауті обирає «Оплата карткою (monobank)» і підтверджує замовлення.
2. Плагін створює рахунок через API monobank і перенаправляє покупця на захищену сторінку оплати банку. Разом з рахунком передається склад кошика (basketOrder) — для чеків і фіскалізації.
3. Після оплати monobank надсилає вебхук з ECDSA-підписом (X-Sign). Плагін перевіряє підпис проти публічного ключа мерчанта і переводить замовлення у «В обробці» або «Виконано».
4. Якщо вебхук затримався, при поверненні покупця в магазин плагін сам робить резервний запит статусу — замовлення не «зависне» в очікуванні.
5. Якщо оплата не пройшла, покупець повертається в магазин, кошик зберігається — можна спробувати ще раз.

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

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

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 і повернення можна перевірити на власному магазині ще до покупки. Саме тому повернення коштів після оплати не передбачене — ви бачите модуль у справі до того, як платите.

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

• WordPress 6.2+
• WooCommerce 7.0+ (тестовано до 10.7)
• PHP 7.4+
• Токен monobank: бойовий видається у кабінеті мерчанта після підписання договору; тестовий створюється безкоштовно на api.monobank.ua — договір для тесту не потрібен

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

• Перевірка ECDSA-підпису вебхука — кожен callback від банку валідується заголовком X-Sign (base64 ECDSA-SHA256) проти публічного ключа мерчанта. Підробити підтвердження оплати неможливо.
• PSR-4 автозавантаження — неймспейс CatCodeMonoAcquiringWC, без глобального сміття у WordPress.
• Заявлена сумісність з HPOS і Checkout Blocks через WooCommerce FeaturesUtil — плагін не блокуватиме увімкнення нових таблиць замовлень.
• Резервна звірка статусу — якщо вебхук не дійшов (файрвол, затримка), статус підтягується прямим запитом до API при поверненні покупця.
• 7-денний тріал реалізований у коді ліцензії: після його завершення Pro-функції лише вимикаються — магазин продовжує приймати оплату.

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

1. Завантажте mono-acquiring-for-woocommerce-1.0.0.zip через Плагіни → Додати новий → Завантажити плагін і активуйте.
2. Відкрийте WooCommerce → Налаштування → Платежі → Mono Acquiring.
3. Увімкніть метод і вставте токен — тестовий для перевірки або бойовий для реальних платежів.
4. Збережіть. URL вебхука плагін встановить автоматично при першому платежі.
5. Для Pro-функцій після покупки вставте ліцензійний ключ з email у поле «Pro-ліцензія».

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

1.0.0 — липень 2026

Перший реліз: створення рахунку та редірект на сторінку оплати monobank, вебхук з перевіркою ECDSA-підпису, резервний запит статусу, повернення коштів, двоетапна оплата (hold), підтримка Checkout Blocks та HPOS, тестовий режим з окремим токеном.