Get in touch
Mono Acquiring — monobank card payments for WooCommerce
Mono Acquiring gateway settings in WooCommerce: tokens, payment type, statuses, Pro options Pro payment log: Paid / Not paid / Refunded statuses, masked card, RRN
  • WordPress
  • Payments
  • v1.1.6

Mono Acquiring — monobank card payments for WooCommerce

A monobank acquiring plugin for WooCommerce: Visa/Mastercard payment on the bank's page, a webhook with an ECDSA signature updates the status itself. Pro — hold, refunds, log.

Download Free
Pro · one-year licence The more sites, the less each one costs
PHP
7.4 or newer
Version
Pro v1.1.6
Free v1.0.6 (wordpress.org)
Licence
two sites, annual
Trial
7 days, no card, one per site
Updated
26 October 2026
Video overview · 0:42
Or all 173 Pro modules with All Access — 4 990 ₴ / year

The module in action — 42 sec

Clear even without sound: Ukrainian subtitles

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Visa/Mastercard payments on the monobank page ✔ ✔
Automatic order confirmation by a webhook with ECDSA signature verification ✔ ✔
Fallback status request when the customer returns ✔ ✔
Test mode — a free test token, no bank agreement needed ✔ ✔
Classic and block checkout (Checkout Blocks), HPOS compatible ✔ ✔
Cart contents (basketOrder) passed through for receipts ✔ ✔
Request logging in WooCommerce ✔ ✔
A payment log — amount, statuses, invoice, masked card, RRN, bank reconciliation — ✔
Two-stage payment (hold) — holding funds and charging on order fulfilment — ✔
Refunds — full, partial and repeated, right from the order — ✔
Saved card — one-click repeat payments via a monobank wallet token — ✔
An auto-fiscalisation hook — fires an event for PRRO plugins (Checkbox, Vchasno.Kasa, Cashalot, etc.) after payment — ✔

What it looks like

Mono Acquiring gateway settings in WooCommerce: tokens, payment type, statuses, Pro options
A single settings page under WooCommerce → Payments: live and test tokens, payment type (charge immediately or hold), order statuses, logging and Pro options. The webhook URL is set automatically with every payment — nothing to copy into the bank’s dashboard.
Pro payment log: Paid / Not paid / Refunded statuses, masked card, RRN
The payment log (Pro): every transaction with its amount, monobank and WooCommerce status, invoice number, masked card and RRN. The reconciliation button pulls the current status from the bank, and refunds are done right from the log row.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — two sites

Moving the store? Unbind the licence on the old domain and activate it on the new one yourself. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • WordPress 6.2+
  • WooCommerce 6.0+ (tested up to 10.7)
  • PHP 7.4+
  • A monobank token: a live one is issued in the merchant dashboard after signing an agreement; a test one is created free at api.monobank.ua — no agreement needed for testing

Version history

v1.1.6 Current 26 October 2026

When monobank cannot create the invoice (wrong token, outage, timeout), the buyer reads a plain “We could not open the card payment…” instead of “forbidden; FORBIDDEN”; the technical answer…

v1.1.5 13 October 2026

Sites where every language has a URL prefix (Polylang): after paying, the buyer comes back to the thank-you page instead of “Page not found”.

v1.1.4 24 September 2026

The Pro version activated next to the free copy from WordPress.org no longer loads the free copy’s code with PHP warnings on every request.

All versions (6)
v1.1.3 23 September 2026

The basket monobank shows on the payment page (and passes on for fiscalisation) did not add up to the amount charged.

v1.1.0 August 2026

Free is really free: a fresh install no longer switches Pro on by itself, the trial only starts with the “Try Pro for 7 days” button.

v1.0.0 First release July 2026

Creating an invoice and redirecting to monobank’s payment page, a webhook with ECDSA signature verification, a fallback status request, refunds, two-stage payment (hold), Checkout Blocks…

Frequently bought with Mono Acquiring

4 modules in one order — 40% cheaper than separately

“Store starter” bundle Mono Acquiring Nova Poshta Premium Telegram notifications and Viber/SMS for customers Abandoned Cart Recovery Need more — all 173 modules in All Access for 4 990 ₴.
2 490 ₴ / year instead of 4 160 UAH bought separately
Buy the bundle →

Full module description

Mono Acquiring for WooCommerce is a payment plugin that connects monobank acquiring to your store. The customer pays for the order by Visa or Mastercard on monobank’s secure page, and the plugin confirms payment itself: the bank sends a webhook, the plugin verifies its ECDSA signature and moves the order to the right status. No manual payment reconciliation — the status in WooCommerce always matches the status at the bank.

How it works, step by step

  1. At checkout, the customer chooses “Card payment (monobank)” and confirms the order.
  2. The plugin creates an invoice via the monobank API and redirects the customer to the bank’s secure payment page. The cart contents (basketOrder) are sent along with the invoice, for receipts and fiscalisation.
  3. After payment, monobank sends a webhook with an ECDSA signature (X-Sign). The plugin checks the signature against the merchant’s public key and moves the order to “Processing” or “Completed”.
  4. If the webhook is delayed, when the customer returns to the store the plugin makes a fallback status request itself — the order won’t get stuck waiting.
  5. If payment fails, the customer returns to the store and the cart is kept — they can try again.

Under the hood

  • ECDSA webhook signature verification — every callback from the bank is validated via the X-Sign header (base64 ECDSA-SHA256) against the merchant’s public key. Faking a payment confirmation is impossible.
  • PSR-4 autoloading — the CatCodeMonoAcquiringWC namespace, no global clutter in WordPress.
  • Declared HPOS and Checkout Blocks compatibility via WooCommerce’s FeaturesUtil — the plugin won’t block enabling the new order tables.
  • Fallback status reconciliation — if the webhook doesn’t arrive (firewall, delay), the status is pulled by a direct API request when the customer returns.
  • The 7-day trial is issued by the licence server at your click: once it ends, Pro features simply switch off — the store keeps accepting payments.

How to install

  1. Download mono-acquiring-for-woocommerce-1.1.6.zip via Plugins → Add New → Upload Plugin and activate it.
  2. Open WooCommerce → Settings → Payments → Mono Acquiring.
  3. Enable the method and enter a token — a test one for checking, or a live one for real payments.
  4. Save. There is no need to enter the webhook URL — the plugin passes it to monobank with every invoice.
  5. For Pro features, after purchase paste the licence key from the email into the “Pro licence” field.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Do I need an agreement with monobank?

For real payments, yes — a live token is issued in the merchant dashboard. For testing, a free test token from api.monobank.ua is enough.

Which currencies are supported?

The main one is hryvnia (UAH). USD and EUR are also handled if they're enabled for your merchant.

Does the plugin break my checkout or theme?

No. It's a standard WooCommerce payment gateway: it only adds a payment method to the list. It works with both the classic checkout and Checkout Blocks.

What about "Payment in instalments"?

It's enabled in the monobank merchant dashboard and needs no changes in the code or plugin settings.

Can I move the licence to another domain?

Yes. The licence works on one active domain, and you can move it yourself: in the module's settings on the old domain click "Deactivate" — the slot frees up instantly, then activate the same key on the new domain. No extra charge; if you no longer have access to the old site, contact us and we'll free the slot manually.

What happens when the licence ends?

Pro features, accepting payments and confirming orders keep working, settings and data stay in place — only updates and support stop. Renewing with the same key brings updates and support back. We'll remind you by email 14, 7, 3 and 1 day before it ends.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module