Zahlo Payments for WooCommerce
Free WordPress plugin by zahloco
Zahlo lets your WooCommerce store take card and wallet payments. Paste your Zahlo API keys, choose how customers pay, and the plugin sets up the rest. Test mode and live mode — Keep a test key and a…
About Zahlo Payments for WooCommerce
Zahlo Payments for WooCommerce 2.2.0 is a free WordPress plugin by zahloco. It is active on 0 WordPress sites. The latest version is 2.2.0, last updated on 18 Nov 2026. You can download it free from WordPress.org — no account or payment needed.
Zahlo lets your WooCommerce store take card and wallet payments. Paste your Zahlo API keys, choose how customers pay, and the plugin sets up the rest.
- Test mode and live mode — Keep a test key and a live key side by side. With Test mode on, orders use the Zahlo sandbox and no real money moves; turn it off to take real payments. Each order remembers its mode, so refunds and webhooks for earlier test orders keep working after you go live.
- Hosted or embedded — Hosted sends the customer to Zahlo’s payment page. Embedded shows the payment fields on your store’s order-pay page. Both work with Classic checkout and Checkout Blocks.
- Automatic setup — Saving the settings registers this store’s webhook endpoint and checkout domain with Zahlo, for each mode that has a key.
- Signed webhooks — Orders move to Processing only on a signed Zahlo event (or a server-side check on return), never on the browser redirect alone. Each event is applied once, even if it is delivered twice or out of order.
- Refunds — Refund from the WooCommerce order screen, in full or in part. Refunds made in the Zahlo dashboard appear on the order automatically.
- Disputes — A dispute puts a paid order on hold and emails you. A won dispute restores the order’s status; a lost one marks it failed.
- Exact totals — Products, shipping and fees are sent as their own lines, tax included; WooCommerce stays the source of tax and shipping.
- WooCommerce Subscriptions — The first order saves the card; renewals charge it without the customer present. A declined renewal puts the subscription on hold, and customers can change their card from their account.
- Saved cards — Optionally, logged-in customers can save their card; they manage saved cards under My Account → Payment methods.
Requirements:
- A Zahlo merchant account (zahlo.eu)
- WooCommerce 8.0 or later (10.6 tested), PHP 8.0 or later, WordPress 6.2 or later
External services
This plugin connects to the Zahlo merchant API at https://merchant.zahlo.eu, for both test and live keys (the key selects the mode). Zahlo creates payment sessions, hosts the payment page and the embedded checkout script, and confirms payments. The plugin contacts it only as listed here:
- Settings save (server): verifies each key (
GET /api/v1/checkout-domains), then registers the webhook endpoint/?wc-api=zahlo_webhookand this store’s domain (POST /api/v1/webhook-endpoints,POST /api/v1/checkout-domains). When the store’s URL or key changed, it replaces the old endpoint (GET/DELETE /api/v1/webhook-endpoints), and after an update it adds new event types to it (PATCH /api/v1/webhook-endpoints/{id}). Sent: the store’s URL and domain. - Order placement (server):
POST /api/v1/checkout-sessionswith the order lines, amounts, currency, billing email, order number and ID, and return URLs. In Hosted mode the customer is then sent to Zahlo’s payment page athttps://payments.zahlo.eu(https://sandbox.payments.zahlo.euin Test mode). - Return page (server):
GET /api/v1/checkout-sessions/{id}to confirm the order’s payment. - Embedded checkout (browser): the order-pay page loads
/sdk/v1/zahlo.jsfrom Zahlo with a short-lived client token. That script loads Zahlo’s checkout script (/sdk/v1/checkout.js) from the same origin and shows the payment fields in a frame from Zahlo’s payment page (https://payments.zahlo.eu, orhttps://sandbox.payments.zahlo.euin Test mode). Card details are entered only in those fields and go to Zahlo and its card processor, never to the store. - Webhooks (server): Zahlo sends signed events (
Zahlo-Signature) to/?wc-api=zahlo_webhook. For a refund or dispute that names only a payment, the plugin looks the payment up (GET /api/v1/payments/{id}) to find its order. - Refunds (server):
POST /api/v1/refundsfrom the WooCommerce order screen, andGET /api/v1/refundsto confirm a refund whose outcome was not known yet. - Saved cards and renewals (server):
POST /api/v1/customers(the account’s email and name) when an account first saves a card,GET/DELETE /api/v1/customers/{id}/payment-methodsto link and remove saved cards, andPOST /api/v1/paymentsto charge a saved card for a subscription renewal.
This service is provided by Zahlo: Terms of use, Privacy policy.
Upgrade and removal
- 2.2.0 moves your existing key into the Test or Live key field that matches it and sets Test mode to match, so checkout keeps working. Add the other key when you have it.
- Deactivation keeps orders, settings and the event table.
- Deleting the plugin removes its settings (including the API keys), webhook secrets, checkout domains, saved Zahlo customer IDs, scheduled jobs and the event table. Orders and their notes stay in WooCommerce.
Troubleshooting
- Gateway missing at checkout: the active mode has no valid key, or the store currency is not enabled for your Zahlo account.
- “Payments are not available on this store yet”: new accounts wait for Zahlo’s domain approval; the Zahlo dashboard home shows the state. Save the plugin settings again if the store domain changed.
- Order stays Pending payment: check that security plugins or Cloudflare do not block
POST /?wc-api=zahlo_webhook, and look at the deliveries for the endpoint in the Zahlo dashboard (Developers → Webhooks). - Refund “is being confirmed”: Zahlo has not yet confirmed the refund with the payment provider. It appears on the order once confirmed; do not refund again.
- Live mode on localhost: live checkout needs a public HTTPS hostname. Use Test mode locally.
Questions about Zahlo Payments for WooCommerce
Is Zahlo Payments for WooCommerce free?
Yes. Zahlo Payments for WooCommerce is free to download and use from the official WordPress.org directory. There is no payment and no account needed — the download on this page goes straight to WordPress.org.
What is the latest version of Zahlo Payments for WooCommerce?
The latest version is 2.2.0, last updated on 18 Nov 2026.
How popular is Zahlo Payments for WooCommerce?
It is active on 0 WordPress sites.
How do I install Zahlo Payments for WooCommerce?
From your WordPress dashboard, go to Plugins → Add New, search for Zahlo Payments for WooCommerce, then Install and Activate. You can also download the ZIP from WordPress.org and upload it under Plugins → Add New → Upload Plugin.
Where do I download Zahlo Payments for WooCommerce?
Directly from WordPress.org. The Download button on this page goes straight to the official WordPress.org download, and GPLWPClub does not store the file.
Screenshots