Опис
Замість того щоб вводити IBAN вручну, покупець сканує QR-код у своєму банківському застосунку — IBAN, сума та призначення платежу підставляються автоматично. Власник магазину бачить переказ у застосунку свого банку і підтверджує замовлення в WooCommerce Замовлення.
Основні можливості
- QR-код NBU v002, який розпізнають Monobank, Privat24 та інші українські банківські застосунки
- Кнопки deep-link «Відкрити в Monobank» і «Відкрити в Privat24»
- Кнопки копіювання для IBAN, суми та призначення платежу
- Листи «Утримується» / рахунок містять ті самі реквізити, тож покупці можуть завершити оплату, не повертаючись на сторінку подяки
- Сумісність із HPOS (окремі таблиці замовлень)
- Підтримка блокового чекаута WooCommerce (Blocks Checkout)
- Повний український переклад у комплекті
Як це працює
- Покупець обирає спосіб «Оплата на IBAN / картку» під час оформлення замовлення.
- На сторінці подяки покупець бачить QR-код, кнопки deep-link і платіжні реквізити.
- Покупець сканує QR у своєму банківському застосунку — реквізити переказу підставляються автоматично.
- Покупець підтверджує переказ у банку.
- Побачивши зарахування в застосунку свого банку, ви переводите замовлення в статус «Обробляється» в WooCommerce Замовлення.
Крок 5 можна автоматизувати за допомогою окремого доповнення “IBAN Smart Invoice — Pro” (вебхук Monobank Personal API + автоматичне зіставлення за призначенням платежу та сумою). Доповнення Pro розповсюджується автором і не входить до цього плагіна.
Вимоги
- WooCommerce 10.0+
- PHP 8.0+
- Дійсний IBAN (формат UA)
Зовнішні сервіси
Цей плагін не звертається до жодних зовнішніх сервісів із боку сервера. Код плагіна не надсилає HTTP-запитів до сторонніх API: сканування QR, перехід за deep-link і банківський переказ відбуваються на пристрої покупця, а не на сайті продавця.
Що плагін вбудовує (але не викликає):
- Універсальне QR-посилання НБУ — QR-код на сторінці подяки кодує URL вигляду
https://bank.gov.ua/qr/<base64-payload>(стандарт NBU v002, Постанова 97 від 19.08.2025). Цей URL лише малюється в зображенні QR; плагін ніколи його не відкриває. Банківський застосунок покупця розшифровує QR офлайн і обробляє дані локально.- Оператор сервісу: Національний банк України (bank.gov.ua); QR — офіційний український платіжний стандарт.
- Умови використання: https://bank.gov.ua/ua/legislation
- Плагін не надсилає жодних даних на bank.gov.ua.
- Deep-link Monobank «поповнити банку» (необов’язково, лише якщо продавець вказав URL банки в налаштуваннях) — кнопка «Відкрити в Monobank» на сторінці подяки є звичайним посиланням
<a href="https://send.monobank.ua/jar/...">. Коли покупець натискає її, переходом займається браузер/застосунок Monobank; плагін не виконує запитів до send.monobank.ua.- Оператор сервісу: АТ «Універсал Банк» (Monobank).
- Умови надання послуг: https://www.monobank.ua/terms
- Політика конфіденційності: https://www.monobank.ua/privacy
- Плагін не надсилає жодних даних на send.monobank.ua.
- Deep-link Privat24 (необов’язково, лише якщо продавець вказав номер картки в налаштуваннях) — кнопка «Відкрити в Privat24» використовує схему
next://.../https://link.privat24.ua/...; та сама модель офлайн-переходу, що й у кнопки Monobank.- Оператор сервісу: АТ КБ «ПриватБанк» (Privat24).
- Умови надання послуг: https://privatbank.ua/terms
- Політика конфіденційності: https://privatbank.ua/personal-information
- Плагін не надсилає жодних даних на link.privat24.ua.
Серверне автовизначення оплат через Monobank Personal API (єдиний зовнішній HTTP-запит, пов’язаний із цією функцією) реалізовано в окремому платному доповненні “IBAN Smart Invoice — Pro”, яке розповсюджується поза WordPress.org. Доповнення Pro описує цю інтеграцію у власному readme.
Скріншоти



Встановлення
- Завантажте архів плагіна до
wp-content/plugins/. - Активуйте його на сторінці «Плагіни».
- Налаштуйте в WooCommerce Налаштування Платежі IBAN Smart Invoice.
- Заповніть IBAN, назву отримувача та шаблон призначення платежу.
Часті питання
-
Чи потрібен покупцеві застосунок Monobank для оплати?
-
Ні. QR-код на сторінці подяки має офіційний формат NBU v002 і розпізнається застосунками Monobank, Privat24, ПУМБ, Sense, Raiffeisen, Ощад та понад 20 інших українських банків. Кнопки «Відкрити в Monobank» / «Відкрити в Privat24» — це просто зручні ярлики для користувачів цих двох застосунків.
-
Чи потрібен рахунок у Monobank на боці отримувача?
-
Ні. Підійде будь-який український IBAN. Посилання на банку Monobank потрібне лише для необов’язкової кнопки «Відкрити в Monobank» — якщо банки немає, залиште поле порожнім, і кнопка не показуватиметься.
-
Як підтвердити, що замовлення оплачено?
-
Відкрийте WooCommerce Замовлення, знайдіть замовлення в статусі «Утримується», переконайтеся, що кошти надійшли на ваш банківський рахунок, і змініть статус на «Обробляється» або «Виконано». Призначення платежу (напр. “Order #42”) — це той самий рядок, який покупець ввів у своєму банку, тому їх легко зіставити.
-
Чи можна автоматизувати підтвердження оплати?
-
Так, за допомогою окремого доповнення “IBAN Smart Invoice — Pro”. Воно приймає вебхук Monobank Personal API, зіставляє вхідні зарахування з неоплаченими замовленнями за призначенням платежу та сумою і автоматично переводить замовлення в статус «Обробляється». Доповнення продається автором плагіна і не входить до цієї публікації на .org.
-
Який формат у QR-коду?
-
NBU v002 (Постанова 97 від 19.08.2025) — стандарт, визнаний НБУ як універсальний український платіжний QR. Дані кодуються у форматі Universal Link
https://bank.gov.ua/qr/..., тож один QR відкривається в будь-якому банківському застосунку, встановленому в покупця.
Відгуки
Для цього плагіна немає відгуків.
Учасники та розробники
“CatCode IBAN Smart Invoice” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:
Учасники“CatCode IBAN Smart Invoice” було перекладено на 1 локалізацію. Дякуємо перекладачам за їх роботу.
Перекладіть “CatCode IBAN Smart Invoice” на вашу мову.
Цікавитесь розробкою?
Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.
Журнал змін
0.2.3
- Internationalisation fix: every user-facing string is now written in English in the source, as required for a WordPress.org plugin. Ukrainian is shipped as a proper translation (bundled uk .po/.mo, and available on translate.wordpress.org), so the plugin now reads correctly in English and in Ukrainian instead of being Ukrainian-only.
- The default payment reference (“Payment for order #{order_id}”) and the EDRPOU / tax number labels in the order emails are translatable too — previously they were hardcoded Ukrainian and ignored the site language.
0.2.2
- Додано повний український переклад (114 рядків, файли .po/.mo локалі uk у теці /languages). Без змін у коді.
0.2.1
- Плагін перейменовано відповідно до призначеного слага каталогу
catcode-iban-smart-invoice: оновлено відображувану назву на “CatCode IBAN Smart Invoice”, текстовий домен наcatcode-iban-smart-invoice, головний файл плагіна та вбудовані файли перекладу, а всі префікси констант/опцій/хуків/мета переведено наcatcode_iban_smart_invoice_/CATCODE_IBAN_SMART_INVOICE_. Класи зберігають простір іменCatCode\IbanSmartInvoice.
0.2.0
- Відповідність вимогам перевірки плагінів: усі процедурні ідентифікатори зведено до власного префікса плагіна
iban_smart_invoice_. Префіксisipay_, що використовувався для ключів опцій, назв хуків action/filter, мета-ключа замовлення, хендла скрипту WooCommerce Blocks і глобальної змінної JS на сторінці подяки, перейменовано. Це зміна приватного API для авторів тем/розширень — перезберіть після оновлення. Класи зберігають простір іменCatCode\IbanSmartInvoice; публічні BEM-класи CSS (.isi-pay__*) не змінилися. - Плагін більше не перезаписує власну опцію WooCommerce
woocommerce_{id}_settingsпри введенні некоректного IBAN — останній валідний IBAN тепер зберігається лише у власних налаштуваннях плагіна, не зачіпаючи сховище опцій ядра WooCommerce.
0.1.9
- Видалено внутрішню нотатку розробника (
_dev/), яка випадково потрапила до дистрибутива. Змін у коді немає.
0.1.8
- Виправлено некоректне посилання на політику конфіденційності в розділі «External services» (лінк ПриватБанку оновлено на робочу сторінку).
- Виправлено ім’я користувача в Contributors на
catcodestudio. - Функціональних змін у коді з версії 0.1.6 немає.
0.1.6
- Приведення у відповідність до вимог черги перевірки плагінів WordPress.org:
- Трилітерний префікс
isi_перейменовано наisipay_(4+ літер) у всіх ключах опцій, хуках action / filter, AJAX-обробниках, хендлах ресурсів і глобальних змінних JS. Це зміна приватного API для авторів тем / розширень — перезберіть після оновлення. Публічні BEM-класи CSS (.isi-pay__*) не змінилися. - Зафіксовано
chillerlan/php-qrcodeна останньому релізі 6.x уcomposer.lock(збірка 0.1.4 усе ще містила 5.x уvendor/, попри твердження в журналі змін). - До readme додано окремий розділ
== External services ==, який документує, що безкоштовний плагін не робить вихідних HTTP-запитів, а також описує адресати deep-link даних НБУ / Monobank / Privat24. - Розширено
.distignore, щоб vendor-файлиLICENSE-ASL-2.0,NOTICE,CHANGELOG.mdта інші допоміжні файли більше не потрапляли до продакшн-ZIP.
- Трилітерний префікс
0.1.4
- Поділ на Free / Pro: автоматичне визначення оплат (вебхук Monobank Personal API + зіставлення замовлень + адмін-журнал «IBAN Payments» + опитування на сторінці подяки) винесено в окреме доповнення “IBAN Smart Invoice — Pro”, що розповсюджується поза репозиторієм .org. Безкоштовна версія залишається повнофункціональною — QR + IBAN + кнопки deep-link + інструкції в листах + ручне підтвердження в WooCommerce Замовлення.
- Оновлено
chillerlan/php-qrcodeдо ^6.0 (було ^5.0). API виводу переведено на новий стильoutputInterface(QRGdImagePNG::class); для власників магазинів видимих змін немає. - Гігієна збірки:
.distignoreрозширено, щоб виключити дублікати vendor LICENSE-ASL/NOTICE, CHANGELOG, приклади, тести та інші артефакти — опублікований архів містить лише код плагіна.
0.1.3
- Вебхук тепер відповідає Monobank у межах 5-секундного SLA, ставлячи зіставлення в чергу як асинхронне завдання (Action Scheduler за наявності, резервно WP-Cron). Пошук замовлень і CRUD більше не виконуються всередині HTTP-запиту від Mono, тож повільна база даних або сторонній плагін уже не змусять Mono вимкнути вебхук.
- Додано статус
queuedдля вхідних платежів, щоб асинхронний конвеєр був видимим в адмін-журналі «IBAN Payments».
0.1.2
- Аудит на відповідність стандартам WC 10.7 + Plugin Check 2026: задокументовано модель авторизації вебхука (заголовок
X-ISI-Tokenпоряд із?token=), явне обґрунтуванняpermission_callbackдля REST-маршрутів, іменування Blocks-хендлаwc-payment-method-isiприведено до конвенції ядра, константа версії синхронізована із заголовком плагіна.
0.1.1
- QR переведено на офіційний стандарт NBU v002 (Постанова 97 від 19.08.2025). Сканування тепер працює в Monobank, Privat24, ПУМБ, Sense, Raiffeisen, Ощад і понад 20 інших українських банках через Universal Link
https://bank.gov.ua/qr/. - Налаштування плагіна об’єднано в єдиному редакторі платіжного шлюзу WooCommerce (окремої сторінки налаштувань більше немає).
- Підтримка блоків кошика/чекаута WooCommerce (
AbstractPaymentMethodType). - Часткові оплати: повідомлення для покупця + динамічний QR із залишком суми; механізм зіставлення накопичує кілька часткових переказів в одне замовлення.
- Переплати: повідомлення для покупця на сторінці подяки + позначка для адміністратора для ручного повернення коштів.
- Українські мітки статусів в адмін-журналі з колірним кодуванням.
- Заголовок
Requires Plugins: woocommerce. - Інтервал опитування зменшено до 10 секунд.
0.1.0
- Перший реліз: платіжний шлюз, налаштування, UX сторінки подяки, вебхук, зіставлення замовлень, адмін-журнал.
