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 і сама закриває замовлення.

Базова версія — безкоштовна. Завантажте з офіційного каталогу WordPress.org: wordpress.org/plugins/catcode-iban-smart-invoice — або знайдіть «CatCode IBAN Smart Invoice» у Плагіни → Додати новий. Pro додає авто-закриття замовлень через Monobank webhook, admin-журнал платежів, обробку переплат і часткових оплат та live-статус на Thank You.

Як це виглядає для покупця

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

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

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

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

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

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

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

• WordPress 6.5+, WooCommerce 10.0+
• PHP 8.0+
• Український IBAN (UA-формат)
• Для Pro — Monobank Personal API токен, отримується безкоштовно у застосунку Monobank

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

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

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

1. Плагіни → Додати новий → знайдіть «CatCode IBAN Smart Invoice» → Встановити → Активувати (або завантажте zip з WordPress.org).
2. WooCommerce → Settings → Payments → IBAN Smart Invoice → введіть IBAN, отримувача, ЄДРПОУ/ІПН.
3. Для Pro: після оплати в «Мій акаунт → Ліцензії» зʼявиться ключ і bundle-архів з Pro add-on — залийте iban-smart-invoice-pro.zip та активуйте.
4. WooCommerce → IBAN License → вставте ключ → «Активувати» — увімкнуться webhook, журнал і live-статус.
5. Для Pro введіть Monobank Personal API токен у налаштуваннях методу.

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

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