Опис

Замість того щоб вводити 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)

Ukrainian

The plugin interface is fully translated into Ukrainian. / Інтерфейс плагіна повністю перекладено українською.

Free and Pro

This version is fully functional — no time limit and no ads in the admin.
Pro is a separate product with extra features and support: https://catcode.com.ua/modules/iban-smart-invoice/

Other CatCode plugins for Ukrainian stores

Nova Poshta for WooCommerce — branch and parcel-locker picker in the cart, rates and waybills from the Nova Poshta account.
PRRO fiscal receipts — a tax-service receipt for every order through Vchasno.Kasa or Checkbox, with shift control.
Card payments with LiqPay — LiqPay and Privat24 acquiring with Apple Pay, Google Pay and status reconciliation.
Order notifications in Telegram — a Telegram bot reports new orders, status changes and failed payments.
Order sync with KeyCRM — automatic export of orders to the CRM right after checkout, with retries and a log.

Скріншоти

Gateway settings: recipient details, QR and bank buttons.

Thank You page: payment QR code, IBAN, amount and reference with copy buttons. — Gateway settings: recipient details, QR and bank buttons.

Встановлення

Завантажте архів плагіна до 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

“CatCode IBAN Smart Invoice” було перекладено на 1 локалізацію. Дякуємо перекладачам за їх роботу.

Перекладіть “CatCode IBAN Smart Invoice” на вашу мову.

Цікавитесь розробкою?

Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.

Журнал змін

0.2.5

The “no IBAN set” warning never appeared on a fresh install — the check read WooCommerce’s gateway option, which does not exist until the settings are saved once, and treated its absence as “gateway disabled”. A new install therefore showed nothing at all: no notice, and no payment method at checkout, because the method hides itself until an IBAN is entered.
Ukrainian settings screen now addresses the shop owner formally.

0.2.4

readme: Ukrainian description and keywords.

0.2.3

Виправлення інтернаціоналізації: усі рядки інтерфейсу тепер написані в коді англійською, як того вимагають правила WordPress.org. Українська постачається повноцінним перекладом (вбудовані uk .po/.mo, а також доступний на translate.wordpress.org), тож плагін коректно читається і англійською, і українською, а не лише українською.
Призначення платежу за замовчуванням («Оплата замовлення #{order_id}») і підписи ЄДРПОУ / податкового номера в листах про замовлення теж стали перекладними — раніше вони були жорстко зашиті українською й ігнорували мову сайту.

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 сторінки подяки, вебхук, зіставлення замовлень, адмін-журнал.