IBAN Smart Invoice — QR + Monobank auto-detect для WooCommerce

IBAN Smart Invoice — плагин для WooCommerce, который показывает EPC QR-код для оплаты и deep-link кнопки Monobank/Privat24 прямо на Thank You-странице. Покупатель сканирует QR в банк-приложении — реквизиты заполняются сами. Pro-версия ещё и автоматически детектирует входящую оплату через Monobank Personal API и сама закрывает заказ.

Скачать можно бесплатно. Это одна сборка: QR-счёт, реквизиты, кнопки банков и письмо покупателю работают без ключа, а Pro-возможности видно на своих местах — серыми, с пояснением, что они дают. Ключ или 7-дневный пробный период включают автоматическую детекцию оплаты через Monobank, журнал платежей, частичные оплаты и переплаты, а также живой статус на странице благодарности. В каталоге WordPress.org лежит отдельная упрощённая версия: wordpress.org/plugins/catcode-iban-smart-invoice — в ней автоматической детекции нет вообще.

Как это выглядит для покупателя

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

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

1. Покупатель выбирает метод «Pay to IBAN / card» на checkout-е.
2. На Thank You-странице видит QR, deep-link кнопки и реквизиты.
3. Сканирует QR в банк-приложении — перевод заполняется автоматически, остаётся подтвердить.
4. Pro: за 5–30 секунд приходит Monobank webhook, плагин сопоставляет сумму и референс — заказ сам переходит в «Processing».
5. Free: вы видите перевод в банке и вручную переводите заказ в «Processing».

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

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

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 день до окончания.

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

Сначала триал, потом оплата. Пробный период не включается сам: в настройках способа оплаты есть кнопка «Попробовать Премиум 7 дней бесплатно» — вводите e-mail, ключ приходит на почту и активируется сразу, без карты. Через 7 дней Премиум просто выключается, остальной модуль работает дальше. Именно поэтому возврат средств после оплаты не предусмотрен — вы видите модуль в деле до того, как платите.

Технические требования

• WordPress 6.5+, WooCommerce 8.0+
• PHP 8.2+ (этого требует библиотека генерации QR-кодов)
• Украинский IBAN (UA-формат)
• Для Pro — Monobank Personal API токен, получается бесплатно в приложении Monobank

Что под капотом

• Monobank токен шифруется через sodium_secretbox с ключом, производным от wp_salt('auth') — в БД он не лежит в открытом виде.
• Одна сборка вместо двух плагинов: Pro-возможности закрывает серверная лицензия, а не отдельный архив. Ключ проверяется на catcode.com.ua раз в сутки, с 14-дневным льготным периодом на случай, если наш сервер недоступен.
• Order Matcher сопоставляет платежи по референсу и сумме; частичные платежи накапливаются, на Thank You появляется подсказка «Получено N ₴ из M ₴».
• Аудит Plugin Check пройден — $wpdb->prepare(), escape админ-вывода, nonce-проверки; плагин одобрен рецензентами WordPress.org.

Как установить

1. Плагины → Добавить новый → Загрузить плагин → выберите iban-smart-invoice-1.0.0.zip → Установить → Активировать.
2. Если стоит упрощённая версия из каталога WordPress.org — выключите её: в этой сборке есть всё то же самое. Настройки и заказы сохраняются.
3. WooCommerce → Настройки → Платежи → IBAN Smart Invoice → включите метод, введите IBAN, получателя, ЕГРПОУ/ИНН.
4. Премиум: в блоке «Лицензия Премиум» вставьте ключ и нажмите «Активировать лицензию» — или «Попробовать Премиум 7 дней бесплатно».
5. Вставьте Monobank Personal API токен и нажмите «Подключить Monobank» — банк начнёт присылать выписку, и заказы будут закрываться сами.

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

1.0.0 — 11 августа 2026

Премиум-сборка: автоматическая детекция оплаты, журнал «IBAN Payments», частичные оплаты и переплаты, а также живой статус на странице благодарности теперь в одном плагине, а не в отдельном add-on. Пробный период больше не стартует сам — только по кнопке, с выдачей настоящего ключа на e-mail. Премиум-поля остаются видимыми без лицензии: серыми, с бейджем «Pro» и строкой о том, что они дают. Токен monobank шифруется at-rest и не затирается сохранением формы.

0.2.2 — 16 июля 2026

В пакет добавлен полный украинский перевод интерфейса (114 строк, локаль uk). Без изменений в коде.

0.2.1 — 15 июля 2026

Плагин опубликован в официальном каталоге WordPress.org под слагом catcode-iban-smart-invoice. Релизы 0.1.6–0.2.1 — compliance-правки по итогам рецензии WordPress.org: унификация префиксов функций/опций/хуков, обновление text domain и названия. Функциональных изменений нет.

0.1.1–0.1.5 — май 2026

Pro-линия: Monobank webhook + Order Matcher (сопоставление по референсу и сумме), admin-журнал «IBAN Payments» с табами и одно-кликовой привязкой, обработка частичных платежей с подсказкой на Thank You, вынос Pro в отдельный add-on, License-клиент со сверкой с catcode.com.ua и деактивацией слота из админки.

0.1.0 — 15 мая 2026

Стартовый релиз: QR-код по стандарту НБУ (EPC SCT, BCD v002), deep-link кнопки Monobank/Privat24, copy-кнопки реквизитов, WC payment gateway, Cart/Checkout Blocks, HPOS-совместимость.