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

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

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

Что получает админ

Как это работает — шаг за шагом

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

Что включено в лицензии

Сколько стоит

890 грн — лицензия на год. Год обновлений, технической поддержки и доступа ко всем Pro-функциям. Без автосписаний: продление всегда вручную, реквизиты карты мы не храним.

Можно сразу взять более длинный срок — чем он длиннее, тем дешевле за год:

• 1 год — 890 грн
• 2 года — 1 690 грн (−5%, по 845 грн за год)
• 3 года — 2 350 грн (−12%, по 783 грн за год)
• 4 года — 2 920 грн (−18%, по 730 грн за год)
• 5 лет — 3 340 грн (−25%, по 668 грн за год)

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

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

Сначала триал, потом оплата. Свежая установка — это чистая бесплатная версия: ничего Pro не включается само собой. 7-дневный триал вы запускаете кнопкой «Попробовать Pro 7 дней» в настройках шлюза — указываете e-mail и сразу получаете настоящий ключ. Журнал операций, 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.1.0.zip через Плагины → Добавить новый → Загрузить плагин и активируйте.
2. Откройте WooCommerce → Настройки → Платежи → Mono Acquiring.
3. Включите метод и вставьте токен — тестовый для проверки или боевой для реальных платежей.
4. Сохраните. URL вебхука плагин установит автоматически при первом платеже.
5. Для Pro-функций после покупки вставьте лицензионный ключ из email в поле «Pro-лицензия».

История версий

1.1.0 — август 2026

Free = free: свежая установка больше не включает Pro сама, триал стартует кнопкой «Попробовать Pro 7 дней». Pro-возможности остаются видимыми на своих местах — серыми, с бейджем «Pro» и строкой о том, что именно они дают. Лицензия проверяется на сервере CatCode с 14-дневным льготным периодом. Журнал платежей больше не исчезает из меню без лицензии, добавлена кнопка «Проверить токен», токены мерчанта хранятся зашифрованно. Исправлено: гонка вебхука и возврата покупателя могла провести оплату дважды (на HPOS — даже с локом), поздний колбек «processing» затирал конечный статус счёта, частичный возврат закрывал заказ как полностью возвращённый, валюта счёта бралась из магазина вместо заказа.

1.0.0 — июль 2026

Первый релиз: создание счёта и редирект на страницу оплаты monobank, вебхук с проверкой ECDSA-подписи, резервный запрос статуса, возврат средств, двухэтапная оплата (hold), поддержка Checkout Blocks и HPOS, тестовый режим с отдельным токеном.