Payments · WordPress

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

Покажіть EPC QR + Monobank/Privat24 deep-links на Thank You — і Monobank API сам закриє оплачені замовлення.

1 990 грн ліцензія назавжди Спробувати 7 днів безкоштовно Завантажити Free версію

Версія: v0.1.5
Платформа: WordPress

IBAN Smart Invoice — плагін для WooCommerce, що показує EPC QR-код для оплати + deep-link кнопки на Monobank/Privat24 прямо на Thank You-сторінці. Pro-версія ще і автоматично детектує вхідну оплату через Monobank Personal API і сама закриває замовлення.

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

Thank You сторінка з QR-кодом і реквізитами IBAN — Покупець після оформлення замовлення бачить QR (сканує банк-додатком → реквізити заповнюються самі), deep-link «Або відкрити в банк-додатку» і всі реквізити з copy-кнопками. У Pro знизу — індикатор «Очікуємо надходження платежу» який сам змінюється на «Зараховано» коли webhook прийде.

Pro vs Free — що в якому

Фіча	Free	Pro
EPC SCT (BCD v002) QR-код за стандартом НБУ	✔	✔
IBAN / сума / призначення на Thank You	✔	✔
Copy-кнопки для всіх полів	✔	✔
Deep-link «Відкрити в Monobank» / «Відкрити в Privat24»	✔	✔
HPOS-сумісність (custom order tables)	✔	✔
Cart/Checkout Blocks support	✔	✔
Email-інструкції з реквізитами у “On-hold” листі	✔	✔
Multi-language (UA + EN)	✔	✔
Автоматичне закриття замовлень через Monobank API webhook	—	✔
Admin-журнал «IBAN Payments» (Невідомі / Зіставлені / Часткові / Переплата)	—	✔
Ручний attach невідповідних платежів до будь-якого замовлення в один клік	—	✔
Обробка переплат і часткових платежів	—	✔
Polling статусу платежу на Thank You (без перезавантаження)	—	✔
Priority support 30 днів + lifetime updates	—	✔

Free версія готується для wordpress.org (на review). До моменту публікації — можете завантажити Free zip напряму звідси і встановити як звичайний WP-плагін. Без Pro add-on плагін працює у Free-режимі (QR + реквізити + deep-links, оплати підтверджуєте вручну).

Що ви отримуєте після оплати (Pro)

На сторінці Мій акаунт → Ліцензії зʼявляється:

Ваш ліцензійний ключ (формат XXXXXXXX-XXXX-NNN)
Кнопка «Завантажити» — віддає bundle-архів iban-smart-invoice-bundle-X.Y.Z.zip

Усередині архіву — дві папки:

iban-smart-invoice/ — Free-плагін (база: QR, deep-links, налаштування). Встановлюється першим.
iban-smart-invoice-pro/ — Pro add-on (webhook, journal, polling). Активується другим — і автоматично хукається у Free.

Шлях встановлення:

WP Admin → Плагіни → Додати новий → Завантажити плагін → залити iban-smart-invoice.zip (Free) → Активувати.
Так само залити iban-smart-invoice-pro.zip (Pro add-on) → Активувати.
WooCommerce → IBAN License → вставити ліцензійний ключ → «Активувати». Після цього Pro-функції (webhook, admin-журнал, polling) увімкнуться.
WooCommerce → Settings → Payments → IBAN Smart Invoice → ввести IBAN, отримувача і (для Pro) Monobank Personal API токен.

Якщо переносите ліцензію на інший сайт — на старому WP Admin → WooCommerce → IBAN License → Деактивувати на цьому сайті. Слот звільниться миттєво, ключ можна вводити на новому домені.

Адмін-журнал — вся історія платежів в одному місці (Pro)

Admin IBAN Payments — таби Всі / У черзі / Невідомі / Зіставлені / Часткові / Переплата — Pro: «IBAN Payments» в адмінці. Таби «У черзі / Невідомі / Зіставлені / Часткові / Переплата». Платіж без референсу або з помилкою → один клік щоб привʼязати до будь-якого замовлення вручну.

Налаштування — все в одній сторінці

Сторінка налаштувань: IBAN, отримувач, Monobank token, toggles — WooCommerce → Settings → Payments → IBAN Smart Invoice. IBAN, отримувач, ЄДРПОУ/ІПН, шаблон призначення, Monobank токен (шифрується), окремі toggles для QR / Monobank / Privat24 кнопок.

Чому 1 990 ₴ назавжди замість SaaS 50 ₴/міс?

На ринку є SaaS-сервіси для генерації IBAN/QR за 50-100 ₴/міс — але вони:

Не мають Monobank webhook auto-detect (платежі ручні)
Тягнуть ваші IBAN і токени через third-party API → вендор-локі
Не інтегруються з WooCommerce статусами
Стають дорожчими після 3-го року (1 800+ ₴ за 3 роки vs 1 990 ₴ назавжди в нас)

Як це працює

Покупець обирає метод “Pay to IBAN / card” на checkout-у
На Thank You-сторінці бачить QR + deep-link кнопки + реквізити
Сканує QR у банк-додатку — переказ заповнюється автоматом
Підтверджує переказ
Pro: Протягом 5-30 секунд Monobank webhook приходить, плагін матчить суму і референс — замовлення стає “Processing”
Free: ви бачите переказ у банку → вручну переводите замовлення в “Processing”

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

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

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

0.1.5 — 23 травня 2026: Pro add-on тепер містить License-клієнт, який звіряється з catcode.com.ua: без активного ключа webhook, REST endpoint, admin-журнал і polling не реєструються (паттерн як у EDD Software Licensing). Cached status з grace-періодом 7 днів. Деактивація з адмінки звільняє slot для перенесення на інший сайт.
0.1.4 — 23 травня 2026: Pro-функції винесено в окремий add-on плагін iban-smart-invoice-pro — щоб Free-версія пройшла гайдлайни wordpress.org. Дистрибутив для покупців — bundle-архів з двома папками: Free базою + Pro add-on. Активуються незалежно, Pro хукається у Free через isi/plugin/boot.
0.1.3 — 21 травня 2026: Аудит Plugin Check пройдено: виправлено заголовки плагіна, прибрано load_plugin_textdomain() (автозавантаження з WP 4.6+), додано translators-коментарі, очищено dev-артефакти з build, захищено $wpdb-запити через prepare() placeholders, escape admin output, nonce-перевірки на адмін-фільтрах. Додано .pot-файл (iban-smart-invoice.pot).
0.1.2 — 18 травня 2026: Виправлено обробку часткових платежів: коли клієнт переказує менше повної суми, замовлення лишається “On hold”, а партіальний платіж акумулюється в admin-журналі (Stage 7). Замість того щоб мовчки чекати, на Thank You з’являється підказка “Отримано N ₴ з M ₴, чекаємо ще K ₴”.
0.1.1 — 16 травня 2026: Перший Pro-реліз з автоматичною детекцією: Monobank Personal API webhook + Order Matcher (зіставлення за reference + сумою). Додано admin сторінку “IBAN Payments” з табами та одно-кліковим attach невідповідних транзакцій.
0.1.0 — 15 травня 2026: Стартовий реліз. QR-код за стандартом NBU v002 (EPC SCT), deep-link кнопки Monobank/Privat24, copy-кнопки для IBAN/суми/призначення. WC payment gateway + Cart/Checkout Blocks support + HPOS-сумісність. Free-режим: оплата підтверджується вручну адміном.

Часті питання

Чи безпечно зберігати Monobank токен?

Так. Токен шифрується через sodium_secretbox з ключем похідним від wp_salt('auth') і зберігається в options. Адмін-поле показує що токен встановлений без розкриття значення.

Що якщо клієнт переплатив?

Pro: замовлення переходить у “Processing”, переплата записується у meta + нотатка для manual review.
Free: ви бачите факт переплати в банку — обробляєте вручну.

Що якщо клієнт заплатив без референсу?

Pro: платіж попадає в “Невідомі” таб на адмін-сторінці IBAN Payments. Ви прив’язуєте його до будь-якого замовлення одним кліком.
Free: вам треба перевіряти банк-виписку вручну.

А якщо мені треба спочатку потестити на staging, а потім перенести на прод?

На staging-сайті в WP Admin → WooCommerce → IBAN License натискаєте «Деактивувати на цьому сайті» — слот звільняється миттєво. На prod-сайті встановлюєте Pro + вводите той самий ключ. Без звернень до підтримки.

Чи можу повернути кошти якщо не підійшло?

Замість стандартного “30 днів — без питань” ми даємо 7-денний безкоштовний Pro-trial: встановлюєш, тестуєш всі Pro-функції, і тільки потім вирішуєш чи купувати Lifetime. Деталі — у Refund Policy.

Питання щодо модуля?

Пишіть у Telegram — відповімо протягом робочого дня. Допоможемо з налаштуванням, сумісністю та активацією ключа.

@catcode_support

Поки що жодного відгуку. Будь першим — нижче.

Залишити відгук

Відгук модерується перед публікацією — це звичайно займає до 24 годин.

Ваша оцінка *

Імʼя *

Email *

Ваш відгук *