
ThePay for WooCommerce — card and bank transfer payments (Czech Republic)
ThePay for WooCommerce (Czech Republic): card and bank transfer payments on the ThePay page; Pro adds all methods, all currencies, partial refunds, a background check and a log.
- Compatibility
- WordPress 6.4+ · WooCommerce 8.6+ (HPOS, block checkout) · PHP 7.4+ · a ThePay contract · CZK and EUR (all currencies in Pro) · interface: English (storefront in Pro also Czech)
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 16.11.2026
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.
Key points
What happens to the order
At the checkout the buyer sees the method “Kartou nebo bankovním převodem (ThePay)” with your title and description and the list of the methods of your ThePay project for the cart currency and the buyer’s language (Czech, German or English), with logos.
What Pro adds
All methods of the project. Apple Pay, Google Pay, Bitcoin, deferred payments and every method active in your ThePay project are listed at the checkout with their logos.

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 — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
WordPress 6.4+, WooCommerce 8.6+ (HPOS and the block checkout are supported), PHP 7.4+.
A ThePay merchant contract: Merchant ID, Project ID and API password; the server IP address added to the allowed ones.
Currencies: CZK and EUR in the free version, all currencies of the project in Pro.
Version history
Card and bank transfer payments on the ThePay page, the payment read back before the order changes, paying again without duplicates, classic and block checkout, HPOS, demo and live…
Frequently bought with ThePay


GoSMS Notifications for WooCommerce — SMS about your orders

Klaviyo Connector for WooCommerce — store events, profiles and subscriptions in Klaviyo

Bank iD Login for WooCommerce — bank sign-in and checkout filling (Czech Republic)
Full module description
CatCode Payments with ThePay for WooCommerce adds card and bank transfer payments to WooCommerce through ThePay, a Czech payment gateway. The buyer picks a method at the checkout and finishes the payment on the secure ThePay page: card details never reach your shop. The module works with your own ThePay merchant contract. An order counts as paid only after the shop has read the payment back from ThePay.
What you need from ThePay. A merchant contract: the Merchant ID, the Project ID and the API password are in the ThePay administration under “Implementation”. The demo administration and the live one have different credentials. ThePay answers only requests from the IP addresses allowed in that section; the “Check connection” button shows the server address.
What happens to the order
At the checkout the buyer sees the method “Kartou nebo bankovním převodem (ThePay)” with your title and description and the list of the methods of your ThePay project for the cart currency and the buyer’s language (Czech, German or English), with logos. The picked method opens directly on the ThePay page, with no second choice.
The same on the block checkout: the method is available without extra setup, HPOS is supported.
The ThePay notification is only a signal “look at this payment”: the shop reads the payment from ThePay with its own credentials and marks the order paid when the amount paid equals the order total in the order’s currency and the payment belongs to this order. A different amount or another project puts the order on hold. A payment waiting for the bank keeps the order on hold until ThePay confirms it; a failed one gives a failed order; a buyer who cancels on the ThePay page comes back to the payment page of the order with a clear message, and the cart stays.
Notifications that come twice or late do not change the order a second time, and a paid order is never set back. Paying again for the same order reuses the open ThePay payment; if the cart or the method changed, the old payment is closed at ThePay before a new one starts. A second payment (two open tabs) is written on the order as a note. The requests to ThePay made for a buyer have a limit of 7.5 seconds: if ThePay does not answer, the buyer sees a message and the cart stays.
What Pro adds
All methods of the project. Apple Pay, Google Pay, Bitcoin, deferred payments and every method active in your ThePay project are listed at the checkout with their logos.
Where the buyer picks the method. At the checkout of the shop (all methods as a list) or on the ThePay page (one line at the checkout).
All ThePay currencies and a project per currency. PLN, HUF, GBP, USD, RON, BGN, CHF, SEK, NOK and DKK in the currency of the order; in the settings you can set a separate ThePay project for each currency (a line like EUR=12).
Refunds. A partial refund of any amount, several times. Refunds made in the ThePay administration are recorded on the WooCommerce order without paying out again.
Payment check. The “Check the payment in ThePay” button in the order reads the payment again. Every hour the module asks ThePay about the unpaid orders of the last 3 days (10 per run) and settles those whose notification never arrived; the order list gets the bulk action “Check ThePay payment status”.
Log. The last 200 payments, notifications, refunds and errors in the module settings.
Limits
- The module works only with your own ThePay merchant contract: ThePay issues the Merchant ID, the Project ID and the API password.
- ThePay accepts requests only from allowed IP addresses. Without that every call gets 403; behind NAT or a proxy the outgoing address of the server may differ from the one the module shows.
- The free version takes CZK and EUR and the methods tagged card and bank transfer; Apple Pay, Google Pay, Bitcoin, deferred payments and other currencies are in Pro.
- The method list is cached for 10 minutes: a method switched off in the ThePay administration may still show for a few minutes; paying with it ends with a message and the buyer picks another.
- If ThePay did not return the method list at the checkout, the method is still offered and the payment is created without a method: the ThePay page then lets a free-version buyer pick any method of the project.
- ThePay notifications carry no signature: the module always reads the payment again with its own credentials, so a forged request changes nothing.
- The default time to pay is 1 day (from 15 minutes to 7 days) so that a bank transfer can arrive; it can be changed in the settings.
- Subscriptions, saved cards, pre-authorisation and outgoing payments are not supported.
- The interface is in English; the Czech storefront translation is in the Pro build.
How it works, step by step
- Install the plugin and activate it (WooCommerce must be active).
- In the ThePay administration take the Merchant ID, the Project ID and the API password and add the server IP address to the allowed ones.
- In WooCommerce → ThePay choose demo or live, paste the credentials, press “Check connection” and save.
- Enable “ThePay” in WooCommerce → Settings → Payments.
- The buyer picks ThePay, pays on the ThePay page and comes back to the shop; the order becomes paid after the payment is read back.
- In Pro enable all methods, the method choice, a project per currency, the background check and the log.
Under the hood
- The module calls the ThePay API (api.thepay.cz for live, demo.api.thepay.cz for demo) only after you saved the Merchant ID, the Project ID and the API password. Card details are entered on the ThePay page.
- The request is signed (sha256 of the Merchant ID, the password and the date); the API password is stored encrypted in the database and never put back into HTML.
- ThePay receives the amount, the currency, the order number, a short description with the shop name, the buyer’s name, e-mail and addresses, the order lines (when they add up to the total), the picked method, the language, the time to pay and the return and notification addresses.
- Every payment has its own unique ID: repeating a request with the same ID does not create a duplicate. A lock on the order keeps parallel notifications and the buyer’s return from changing it twice.
How to install
- Plugins → Add New → Upload Plugin: choose the zip and activate.
- WooCommerce → ThePay: choose the environment, paste the Merchant ID, the Project ID and the API password, check the connection, save.
- WooCommerce → Settings → Payments: enable “ThePay”.
- For Pro: paste a licence key or start the trial in the “Licence” section of the ThePay page.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this the official ThePay plugin?
No, it is an independent integration made by CatCode. ThePay is a trademark of its owner; the plugin is not affiliated with or endorsed by ThePay.
Where do I get the Merchant ID, the Project ID and the API password?
In the ThePay administration after you sign the merchant contract. Without a contract the module cannot work.
Why does "Check connection" or a payment return a refusal?
ThePay accepts requests only from IP addresses added to the allowed ones in your ThePay administration (otherwise 403) and only with the right API password (otherwise 401). Add the server address that "Check connection" shows.
Do cards go through my shop?
No. The buyer pays on the secure ThePay page; only the result comes back to the shop.
When does an order become paid?
After the shop has read the payment from ThePay, the amount matches the order total and the payment belongs to this order. A buyer coming back without ThePay confirming does not pay the order.
Which methods are free?
The methods of your project tagged card and bank transfer. Apple Pay, Google Pay, Bitcoin and others are in Pro.
Can I refund?
Yes: a full refund of the remaining amount of a payment from the order screen is in the free version, partial refunds are in Pro.
Which currencies are supported?
The free version takes CZK and EUR, Pro takes every currency your ThePay project accepts.
How many sites does a key cover?
One key works on two sites: the shop and its development copy.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
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
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















