CatCode IBAN Smart Invoice

开发者	catcodestudio
更新时间	2026年7月15日 23:00
PHP版本:	8.0 及以上
WordPress版本:	7.0
版权:	GPLv2 or later
版权网址:	版权信息

下载

0.2.1

详情介绍:

Instead of typing IBAN by hand, the buyer scans a QR code in their banking app — the IBAN, amount and payment reference are filled automatically. The store owner sees the transfer in their bank app and confirms the order in WooCommerce → Orders. Key features

NBU v002 QR code recognised by Monobank, Privat24 and other Ukrainian banking apps
"Open in Monobank" and "Open in Privat24" deep-link buttons
Copy buttons for IBAN, amount and payment reference
On-hold / invoice emails include the same requisites so customers can finish paying without coming back to Thank You
HPOS-compatible (custom order tables)
WooCommerce Blocks Checkout support
Full Ukrainian translation included

How it works

The buyer picks the "Pay to IBAN / card" method on checkout.
On the Thank You page they see a QR code, deep-link buttons and the payment requisites.
They scan the QR in their banking app — the transfer is pre-filled automatically.
They confirm the transfer in the bank.
When you see the credit in your bank app, you mark the order as Processing in WooCommerce → Orders.

Step 5 can be automated with the separate "IBAN Smart Invoice — Pro" add-on (Monobank Personal API webhook + automatic matching by reference and amount). The Pro add-on is hosted by the author and is not part of this plugin. Requirements

WooCommerce 10.0+
PHP 8.0+
A valid IBAN (UA format)

安装:

Upload the plugin archive to wp-content/plugins/.
Activate it from the Plugins screen.
Configure under WooCommerce → Settings → Payments → IBAN Smart Invoice.
Fill in IBAN, beneficiary name, and the reference template.

屏幕截图:

升级注意事项:

0.2.1 Text domain and all internal prefixes renamed to catcode_iban_smart_invoice_ to match the plugin's directory slug. Update any custom theme/extension that hooks into our filters. CSS classes are unchanged. 0.2.0 Internal hook/option prefix renamed from isipay_ to iban_smart_invoice_. If you wrote a custom theme or extension that hooks into our filters, update the names. CSS classes are unchanged. 0.1.9 Packaging cleanup only. Non-breaking. 0.1.8 Readme metadata fixes (valid policy URL, contributor username). Non-breaking. 0.1.6 WordPress.org compliance pass: option / hook prefix changed from isi_ to isipay_. If you wrote a custom theme or extension that hooks into our filters, update the names. CSS classes are unchanged. 0.1.4 Auto-detection moved into a separate Pro add-on. The free version keeps QR + deep-links + manual reconciliation and is now fully .org-compliant. Recommended upgrade. 0.1.3 Webhook responds inside Mono's 5-second SLA. Recommended for live stores. 0.1.2 Audit hardening pass — non-breaking. Recommended. 0.1.1 NBU v002 QR + Blocks checkout + partial payment accumulation. Recommended upgrade. 0.1.0 First public release.

常见问题:

Does the customer need the Monobank app to pay?

No. The QR code on the Thank You page is the official NBU v002 format and is recognised by Monobank, Privat24, PUMB, Sense, Raiffeisen, Oschad and 20+ other Ukrainian banking apps. The "Open in Monobank" / "Open in Privat24" buttons are convenience shortcuts for users of those two apps.

Do I need a Monobank account on the receiving side?

No. Any Ukrainian IBAN works. The Monobank "send to jar" link is only used to power the optional "Open in Monobank" button — if you don't have a jar, leave the field empty and the button is hidden.

How do I confirm that an order has been paid?

Open WooCommerce → Orders, find the order in "On hold", check that the credit landed on your bank account, and switch the status to "Processing" or "Completed". The order's reference (e.g. "Order #42") is the same string the customer typed in their bank, so they're easy to match.

Can payment confirmation be automated?

Yes, via the separate "IBAN Smart Invoice — Pro" add-on. It consumes the Monobank Personal API webhook, matches incoming credits against pending orders by reference and amount, and flips the order to Processing automatically. The add-on is sold by the plugin author and is not part of this .org submission.

What format is the QR code?

NBU v002 (Resolution 97, 2025-08-19), the standard recognised by NBU as the universal Ukrainian payment QR. The payload uses Universal Link https://bank.gov.ua/qr/... so a single QR opens whichever banking app the customer has installed.

更新日志:

0.2.1

Renamed the plugin to match its assigned directory slug catcode-iban-smart-invoice: updated the display name to "CatCode IBAN Smart Invoice", the text domain to catcode-iban-smart-invoice, the main plugin file and the bundled language files, and moved every constant/option/hook/meta prefix to catcode_iban_smart_invoice_ / CATCODE_IBAN_SMART_INVOICE_. Classes keep the CatCode\IbanSmartInvoice namespace.

0.2.0

Plugin review compliance: consolidated all procedural identifiers onto the plugin's own iban_smart_invoice_ prefix. The isipay_ prefix used for option keys, action/filter hook names, the order meta key, the WooCommerce Blocks script handle and the Thank You JS global has been renamed. This is a private-API change for theme/extension authors — recompile after upgrade. Classes keep the CatCode\IbanSmartInvoice namespace; public BEM CSS class names (.isi-pay__*) are unchanged.
Stopped writing back to WooCommerce's own woocommerce_{id}_settings option when an invalid IBAN is entered — the last known-good IBAN is now kept only in the plugin's own settings, leaving WooCommerce core's option store untouched.

0.1.9

Removed an internal development note (_dev/) that was accidentally included in the distributed package. No code changes.

0.1.8

Fixed an invalid Privacy Policy URL in the External services section (PrivatBank link updated to a working page).
Corrected the Contributors username to catcodestudio.
No functional code changes since 0.1.6.

0.1.6

Compliance pass for the WordPress.org plugin review queue:
Renamed the three-letter isi_ prefix to the four-plus-letter isipay_ across every option key, action / filter hook, AJAX handler, asset handle and JS global. This is a private-API change for theme / extension authors — recompile after upgrade. Public BEM CSS class names (.isi-pay__*) are unchanged.
Pinned chillerlan/php-qrcode to the latest 6.x release in composer.lock (the 0.1.4 build still shipped 5.x in vendor/ despite the changelog claim).
Added an explicit == External services == section to the readme documenting that the free plugin makes no outbound HTTP calls, plus the NBU / Monobank / Privat24 deep-link payload destinations.
Extended .distignore so vendor LICENSE-ASL-2.0, NOTICE, CHANGELOG.md and other auxiliary files no longer ship inside the production ZIP.

0.1.4

Free / Pro split: automatic payment detection (Monobank Personal API webhook + Order Matcher + admin IBAN Payments journal + Thank-You polling) has been moved to a separate "IBAN Smart Invoice — Pro" add-on hosted off the .org repo. The free version stays fully functional — QR + IBAN + deep-link buttons + email instructions + manual confirmation in WooCommerce → Orders.
Upgraded chillerlan/php-qrcode to ^6.0 (was ^5.0). Output API switched to the new outputInterface style (QRGdImagePNG::class); no visible change for store owners.
Build hygiene: .distignore extended to drop vendor LICENSE-ASL/NOTICE duplicates, CHANGELOG, examples, tests and other artefacts so the published archive contains plugin code only.

0.1.3

Webhook now responds to Monobank within the 5-second SLA by queuing the matcher as an asynchronous job (Action Scheduler when available, WP-Cron fallback). Order detection and CRUD no longer run inside the HTTP request from Mono, so a slow database or third-party plugin can no longer make Mono disable the webhook.
Added a queued status for incoming payments to make the async pipeline visible in the IBAN Payments admin journal.

0.1.2

Audit hardening pass against WC 10.7 + Plugin Check 2026 standards: documented webhook auth model (X-ISI-Token header alongside ?token=), explicit permission_callback rationale on REST routes, wc-payment-method-isi Blocks handle naming aligned with core convention, version constant synced with plugin header.

0.1.1

Switch QR payload to official NBU v002 standard (Resolution 97, 2025-08-19). Scans now work across Monobank, Privat24, PUMB, Sense, Raiffeisen, Oschad and 20+ other Ukrainian banks via Universal Link https://bank.gov.ua/qr/.
Unified plugin settings into a single WooCommerce gateway editor (no more separate settings page).
WooCommerce Cart/Checkout Blocks support (AbstractPaymentMethodType).
Partial payments: customer-facing notice + dynamic QR with remaining amount; matcher accumulates multiple partial transfers into one order.
Overpayments: customer-facing thank-you note + admin flag for manual refund.
Ukrainian admin journal status labels with colour coding.
Requires Plugins: woocommerce header.
Reduced polling interval to 10 seconds.

0.1.0

First release: Gateway, Settings, Thank You UX, Webhook, Order Matcher, Admin journal.