Title: CatCode IBAN Smart Invoice Author: catcodestudio Published: 15.07.2026 Last modified: 17.07.2026 --- Шукати плагіни ![](https://ps.w.org/catcode-iban-smart-invoice/assets/banner-772x250.png?rev=3609067) ![](https://ps.w.org/catcode-iban-smart-invoice/assets/icon-256x256.png?rev=3609067) # CatCode IBAN Smart Invoice Від автора [catcodestudio](https://profiles.wordpress.org/catcodestudio/) [Завантажити](https://downloads.wordpress.org/plugin/catcode-iban-smart-invoice.0.2.3.zip) * [Деталі](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/#description) * [Відгуки](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/#reviews) * [Встановлення](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/#installation) * [Розробка](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/#developers) [Підтримка](https://wordpress.org/support/plugin/catcode-iban-smart-invoice/) ## Опис Замість того щоб вводити IBAN вручну, покупець сканує QR-код у своєму банківському застосунку — IBAN, сума та призначення платежу підставляються автоматично. Власник магазину бачить переказ у застосунку свого банку і підтверджує замовлення в WooCommerce Замовлення. #### Основні можливості * QR-код NBU v002, який розпізнають Monobank, Privat24 та інші українські банківські застосунки * Кнопки deep-link «Відкрити в Monobank» і «Відкрити в Privat24» * Кнопки копіювання для IBAN, суми та призначення платежу * Листи «Утримується» / рахунок містять ті самі реквізити, тож покупці можуть завершити оплату, не повертаючись на сторінку подяки * Сумісність із HPOS (окремі таблиці замовлень) * Підтримка блокового чекаута WooCommerce (Blocks Checkout) * Повний український переклад у комплекті #### Як це працює 1. Покупець обирає спосіб «Оплата на IBAN / картку» під час оформлення замовлення. 2. На сторінці подяки покупець бачить QR-код, кнопки deep-link і платіжні реквізити. 3. Покупець сканує QR у своєму банківському застосунку — реквізити переказу підставляються автоматично. 4. Покупець підтверджує переказ у банку. 5. Побачивши зарахування в застосунку свого банку, ви переводите замовлення в статус« Обробляється» в 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/` (стандарт 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» на сторінці подяки є звичайним посиланням ``. Коли покупець натискає її, переходом займається браузер/застосунок 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. ## Скріншоти [⌊Сторінка подяки з QR-кодом і кнопками deep-link⌉⌊Сторінка подяки з QR-кодом і кнопками deep-link⌉[ Сторінка подяки з QR-кодом і кнопками deep-link [⌊Адмін-журнал «IBAN Payments»⌉⌊Адмін-журнал «IBAN Payments»⌉[ Адмін-журнал «IBAN Payments» [⌊Налаштування плагіна⌉⌊Налаштування плагіна⌉[ Налаштування плагіна ## Встановлення 1. Завантажте архів плагіна до `wp-content/plugins/`. 2. Активуйте його на сторінці «Плагіни». 3. Налаштуйте в WooCommerce Налаштування Платежі IBAN Smart Invoice. 4. Заповніть 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” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники: Учасники * [ catcodestudio ](https://profiles.wordpress.org/catcodestudio/) “CatCode IBAN Smart Invoice” було перекладено на 1 локалізацію. Дякуємо [перекладачам](https://translate.wordpress.org/projects/wp-plugins/catcode-iban-smart-invoice/contributors) за їх роботу. [Перекладіть “CatCode IBAN Smart Invoice” на вашу мову.](https://translate.wordpress.org/projects/wp-plugins/catcode-iban-smart-invoice) ### Цікавитесь розробкою? [Перегляньте код](https://plugins.trac.wordpress.org/browser/catcode-iban-smart-invoice/), перегляньте [сховище SVN](https://plugins.svn.wordpress.org/catcode-iban-smart-invoice/) або підпишіться на [журнал розробки](https://plugins.trac.wordpress.org/log/catcode-iban-smart-invoice/) за допомогою [RSS](https://plugins.trac.wordpress.org/log/catcode-iban-smart-invoice/?limit=100&mode=stop_on_copy&format=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 сторінки подяки, вебхук, зіставлення замовлень, адмін-журнал. ## Мета * Версія **0.2.3** * Останнє оновлення **6 днів тому** * Активних встановлень **Менше 10** * Версія WordPress ** 6.5 або вище ** * Tested up to **7.0.2** * Версія PHP ** 8.0 або вище ** * Мови * [English (US)](https://wordpress.org/plugins/catcode-iban-smart-invoice/) і [Ukrainian](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/). * [Перекладіть на свою мову](https://translate.wordpress.org/projects/wp-plugins/catcode-iban-smart-invoice) * Позначки * [iban](https://uk.wordpress.org/plugins/tags/iban/)[monobank](https://uk.wordpress.org/plugins/tags/monobank/) [payment gateway](https://uk.wordpress.org/plugins/tags/payment-gateway/)[privat24](https://uk.wordpress.org/plugins/tags/privat24/) [woocommerce](https://uk.wordpress.org/plugins/tags/woocommerce/) * [Розширений перегляд](https://uk.wordpress.org/plugins/catcode-iban-smart-invoice/advanced/) ## Оцінки No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/catcode-iban-smart-invoice/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/catcode-iban-smart-invoice/reviews/) ## Учасники * [ catcodestudio ](https://profiles.wordpress.org/catcodestudio/) ## Підтримка Є що сказати? Потрібна допомога? [Перейти в форум підтримки](https://wordpress.org/support/plugin/catcode-iban-smart-invoice/)