Description
morkva IBAN Gateway adds a bank transfer payment method to WooCommerce. The buyer places the order, scans a QR code or taps the button of their bank, and the banking app opens with the IBAN, amount and payment purpose already filled in. You mark the order paid once the transfer arrives. No payment provider, no registration, no fees on top of your bank’s.
👉 Why shops choose it
- Payment QR code under the National Bank of Ukraine standard (format 003): any Ukrainian banking app reads it.
- Buttons for Privat24, monobank, PUMB and NovaPay open that bank’s app with the payment ready to confirm. You choose which buttons to show.
- You see in the order when the buyer opened the payment link, and in which bank.
- Works with both the classic checkout and the Checkout block.
- Compatible with High-Performance Order Storage (HPOS).
- The IBAN is checked when you save it: a likely typo is flagged before a buyer sees it.
- The method stays hidden until the IBAN is filled in: no orders without bank details.
- Bank details go into the standard WooCommerce emails, no extra email to configure.
- Ukrainian translation included; made and supported by a Ukrainian team.
🛒 What the buyer gets
- A QR code and bank buttons on the thank-you page: the amount and purpose are filled in, nothing to type.
- IBAN, recipient, company code (EDRPOU), amount and the payment purpose next to them.
- The name of your bank, if you fill it in: a hint for the buyer which bank is easier to pay from.
- A copy button next to each detail: paste it into the banking app without typos.
- The same QR code, bank buttons and details in the “Order on hold” email.
- Payment status on the thank-you page: “Awaiting payment” turns into “Order paid” without reloading the page once you mark the payment, and the QR code and buttons go away, so nobody pays twice.
📦 What the shop gets
- Orders paid by transfer go to “On hold” and stock is reserved, so nothing is sold twice while you wait for the money.
- The order box lists which banking apps the buyer opened, and when. Opening an app is not a payment: the status changes only when you see the money.
- A “morkva IBAN” box on the order screen: payment status and a “Payment received” button that marks the order paid, with the time it was confirmed.
- Settings on one screen: title, description, IBAN, bank name, recipient, company code, payment purpose.
- Your own payment purpose with the order number, e.g. “Payment for order {order_id}”. Left empty, it is “Payment for order #N”.
⭐ Free or Pro
The free version covers one bank account and a payment purpose with the order number, which is enough for most shops.
Pro adds the buyer’s name to the payment purpose, any order status after checkout, payment instructions, a separate customer email and the [morkva_iban] shortcode. Your settings carry over when you switch. See the Pro version.
🔗 External services
The plugin settings screen shows a list of other morkva plugins. To build it, the plugin requests https://morkva.co.ua/wp-json/pluginManagementPro/v2 when an administrator opens the gateway settings, at most once every 12 hours. The request sends no order, customer or payment data; like any WordPress HTTP request, it carries your site address in the User-Agent header. Nothing is requested on the storefront or at checkout.
Service provider: morkva, terms and privacy policy.
The QR code and the bank buttons hold a link with the payment details (recipient, IBAN, company code, amount, purpose, order number) in the format of the National Bank of Ukraine: https://qr.bank.gov.ua/, or the app address of Privat24 (https://www.privat24.ua/), monobank (https://mbnk.app/), PUMB (https://mobile-app.pumb.ua/) or NovaPay (https://mobile.novapay.ua/). Your site sends nothing to these services: the buyer’s phone or browser opens the link only when the buyer scans the code or taps a button, and the bank processes it under its own terms and privacy policy: National Bank of Ukraine, PrivatBank, monobank, PUMB, NovaPay. The QR code is drawn by your own site, with no external request; in the email it is an image loaded from your site.
🧩 Libraries
The QR code is drawn with the PHP version of qrcode-generator by Kazuhiko Arase (MIT), bundled in includes/vendor/qrcode-generator/ under its own namespace (changes are listed at the top of the file). The hryvnia sign outline comes from nbu-qr-code-swift (MIT).
Installation
- Install and activate WooCommerce.
- Install the plugin from Plugins → Add New, or upload the zip, and activate it.
- Go to WooCommerce → Settings → Payments → morkva IBAN.
- Tick “Enable”, enter the IBAN, recipient and company code, and save. The QR code and bank buttons appear for orders in hryvnias.
FAQ
What order status does a new order get?
“On hold”. When the money arrives, change the order to “Processing” or “Completed”. In Pro you can choose any status.
The method does not show at checkout. Why?
It is hidden until an IBAN is saved. Check the IBAN field in the gateway settings and that the method is enabled.
Does it work with the Checkout block?
Yes, with the Checkout block and the classic [woocommerce_checkout] shortcode.
Does it accept IBANs from outside Ukraine?
Yes. The check follows the international IBAN standard (ISO 13616), so it works for any country. If an IBAN does not pass the check, it is still saved and shown to buyers; you only get a warning in the settings.
I have the Pro version. Should I keep the free one?
No. When Pro is active, the free version deactivates itself. Your settings stay, because both versions use the same settings.
Why is there no QR code on the thank-you page?
The QR code needs a Ukrainian IBAN, the recipient, a company code (8 digits of EDRPOU or 10 digits of the tax ID) and an order in hryvnias. The gateway settings say what is missing. You can also turn the QR code and buttons off there.
Which banks does the QR code work with?
The QR code follows the National Bank of Ukraine standard, so the scanner of any Ukrainian banking app that supports it reads it. Privat24, monobank, PUMB and NovaPay get their own buttons; a buyer of any other bank scans the code from their banking app.
Does a tap on a bank button mean the order is paid?
No. It means the buyer opened the banking app with your details. The order stays “On hold” until you see the transfer on your account.
How does the buyer know the order is paid?
The thank-you page shows “Awaiting payment” with an orange dot. When you press “Payment received” on the order screen (or change the order to “Processing” or “Completed”), the page turns green and shows “Order paid” within about 15 seconds, without a reload, and the QR code and bank buttons disappear. WooCommerce also sends the buyer its usual “Processing order” email.
Changelog
0.2.0
- [new] NBU payment QR code (format 003) on the thank-you page, above the order overview so the buyer sees it first.
- [new] Your own payment purpose with {order_id}.
- [new] “morkva IBAN” box on the order screen: payment status and a “Payment received” button.
- [new] Privat24, monobank, PUMB and NovaPay buttons that open the banking app with the payment filled in; choose which ones to show. The order box shows when the buyer opened the link.
- [new] The QR code and bank buttons in the “Order on hold” email.
- [new] Amount added to the bank details, with a copy button.
- [new] Optional bank name in the bank details, without a copy button.
- [new] Payment status on the thank-you page that turns green when the order is paid, without a reload; the QR code and bank buttons are hidden for a paid order.
- [ui] Settings warnings are red; the IBAN, recipient and company code fields get a red frame when the QR code cannot be built from them.
- [ui] When Pro is active, the free version deactivates itself.
0.1.0
- First release: IBAN bank transfer method with bank details on the thank-you page and in customer emails, classic and block checkout.