Get in touch
WordPress

LiqPay — Card Payments for WooCommerce

Приймання оплати карткою Visa/Mastercard, Apple Pay та Google Pay через LiqPay у WooCommerce. Автопідтвердження замовлення serviceUrl-вебхуком з перевіркою HMAC-MD5-підпису. Pro — журнал платежів, двоетапна оплата і повернення з адмінки.

Download for free
Version
v1.1.1
Compatibility
WooCommerce 7.0+ · WordPress 6.2+
Platform
WordPress
LiqPay — Card Payments for WooCommerce

What each licence includes

Feature Free Pro
Card payment via Visa/Mastercard, Apple Pay, Google Pay through the LiqPay page
Order auto-confirmation via a serviceUrl webhook with HMAC-MD5 signature verification
Transaction status reconciliation when the customer returns (Status API)
Test mode on sandbox keys — a full test payment before signing the contract
Classic and block checkout, HPOS-compatible
UAH, USD, EUR currencies
Logging to the standard WooCommerce log
Payment log — status, amount, masked card, transaction number; manual reconciliation from the log
Two-stage payment — AUTH hold and SETTLE capture when the order is fulfilled
Refunds — full and partial, straight from the order screen

LiqPay for WooCommerce is a payment plugin that accepts card payments (Visa/Mastercard, Apple Pay and Google Pay) through the secure LiqPay payment page. Once the customer pays, LiqPay sends a signed serviceUrl webhook, the plugin verifies the HMAC-MD5 signature and moves the order to the correct status itself. There’s no manual “paid or not” reconciliation — the order is only confirmed once the money has actually gone through.

The base version is free. Download: catcode-card-payments-with-liqpay-for-woocommerce.zip. Free covers card payment acceptance and webhook-based order auto-confirmation; Pro adds a payment log with status reconciliation, two-stage payment (AUTH + SETTLE), and full and partial refunds straight from the admin panel.

What the admin gets

LiqPay — gateway settings in WooCommerce
One settings page under WooCommerce → Payments: test mode, live and sandbox keys, payment type (single- or two-stage), order status after payment, a ready-made webhook URL.
LiqPay — payment log in WooCommerce
The payment log (Pro): status in LiqPay and in WooCommerce side by side, amount, masked card, transaction number. Status reconciliation — one button on the same screen.

How it works — step by step

  1. At checkout the customer chooses “Card payment (LiqPay)” and places the order. Works with both classic and block-based (Gutenberg) checkout.
  2. The plugin builds a signed request and redirects the customer to the secure LiqPay payment page — card, Apple Pay or Google Pay. Card details are entered on LiqPay’s side and never reach your site.
  3. After payment, LiqPay sends a serviceUrl webhook to the REST route catcode-liqpay/v1/webhook. The plugin verifies the HMAC-MD5 signature and sets the order to “Processing” or “Completed”.
  4. When the customer returns to the site, the status is additionally reconciled via the Status API — the order is only completed if the transaction genuinely succeeded.
  5. With Pro: under the two-stage scheme, funds are only held (AUTH), and captured (SETTLE) automatically once you move the order to “Completed”. Refunds — full or partial — are issued from the order screen.

Pricing

890 UAH — one-year licence. A year of updates, technical support and access to all Pro features. No auto-billing: renewal is always manual, and we don’t store card details.

You can take a longer term right away — the longer it is, the cheaper it works out per year:

  • 1 year — 890 UAH
  • 2 years — 1,690 UAH (−5%, 845 UAH per year)
  • 3 years — 2,350 UAH (−12%, 783 UAH per year)
  • 4 years — 2,920 UAH (−18%, 730 UAH per year)
  • 5 years — 3,340 UAH (−25%, 668 UAH per year)

When the term expires, only updates and new features stop — Pro features keep working, the free version keeps running, and your settings and data stay put. To unlock Pro again, just renew the licence in your account. We’ll email you 14, 7, 3 and 1 day before it ends.

One key covers one domain. If you move your store, deactivate the licence on the old domain and activate it on the new one yourself, without contacting support.

Trial first, payment after. A 7-day free Pro trial switches on right after installation: you can check the operations log, two-stage payment and refunds on your own store before buying. That’s exactly why refunds after purchase aren’t offered — you see the module in action before you pay.

Technical requirements

  • WooCommerce 7.0+ (classic and block checkout, HPOS)
  • WordPress 6.2+
  • PHP 7.4+
  • LiqPay public and private key — from your LiqPay account; testing requires a separate pair of keys with the sandbox_ prefix

Under the hood

  • The signature is verified before parsing the data — the webhook checks the HMAC-MD5 against the raw string, so a forged request never reaches the order.
  • Double payment verification: a signed serviceUrl webhook plus a Status API reconciliation when the customer returns — the status won’t change because of a forged request.
  • Idempotency — a repeated webhook for an already-paid order doesn’t create duplicates and doesn’t change the status a second time.
  • serviceUrl is passed automatically with every payment — there’s nothing to register manually in your LiqPay account.

LiqPay is a trademark of JSC CB “PrivatBank”. This plugin is an independent integration and is not affiliated with LiqPay or PrivatBank.

Version history

1.1.1 — the LiqPay webhook and the customer’s return no longer process a payment twice: previously they could arrive within the same millisecond, both see “not yet paid”, and the order would end up with two payments and a double deduction of the balance; on stores using HPOS, re-reading the order didn’t save this either. The customer’s return no longer shows “Payment not completed” on an order the webhook has just paid. The last licence check time is now recorded in UTC.

1.1.0 — a one-click 7-day Pro trial: the key arrives by email, no card is needed, and nothing else switches on by itself at install. The licence is now checked against the CatCode server (previously Pro was unlocked by any non-empty value in the key field), and if our server is unreachable, Pro keeps working for another 14 days. Pro features are now labelled where they appear: AUTH mode and the payment log are marked Pro with an explanation of what they offer; the log no longer disappears from the menu without a licence. The key is no longer wiped by a plain “Save changes”.

Frequently asked questions

What do I need to connect it?

The public and private keys from your LiqPay account. Enter them in the plugin settings, enable the payment method — and payment acceptance works.

Is the order confirmed automatically?

Yes. LiqPay sends a signed serviceUrl webhook, the plugin verifies the HMAC-MD5 signature and moves the order to the right status only once the payment has actually gone through.

Can I test without real money?

Yes, LiqPay has a sandbox mode with test keys. Note that LiqPay doesn't allow refunding sandbox transactions, so refunds are tested on the live merchant account.

How does Pro differ from the free version?

Free accepts payments and confirms orders automatically. Pro adds a payment log with reconciliation, two-stage payment (holding an amount, then capturing it), and refunds from the admin panel.

Does it work with block checkout?

Yes, both block and classic checkout are supported.

Are you affiliated with LiqPay or PrivatBank?

No. This is an independent CatCode plugin that uses the public LiqPay API. We are not affiliated with LiqPay or PrivatBank.

Questions about the module?

Message us on Telegram — we reply within the working day. We will help with setup, compatibility and key activation.

@catcode_support

Not quite what you are looking for?

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

Order a custom module