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-сумісність.