Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

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.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
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
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

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
Card and bank transfer payments on the ThePay page, classic and block checkout, HPOS ✔ ✔
The order is paid after the payment is read back: amount, currency, project, ownership of the payment ✔ ✔
Failed payment, cancellation, waiting for the bank: plain statuses, the cart stays ✔ ✔
Paying again without duplicates, a lock on the order against parallel notifications ✔ ✔
Demo and live environments, connection check, the API password encrypted ✔ ✔
A full refund of the remaining amount of a payment from the order screen ✔ ✔
Payment methods card and bank transfer all methods of the project (Apple Pay, Google Pay, Bitcoin and more)
Payment currencies CZK and EUR all ThePay currencies
The method choice at the shop checkout or on the ThePay page — ✔
Partial refunds — ✔
Refunds made in the ThePay administration recorded on the order — ✔
A separate ThePay project for each currency — ✔
The "Check the payment in ThePay" button in the order — ✔
Hourly background check of unpaid orders and a bulk action — ✔
Log (the last 200 events) — ✔
Updates from catcode.com.ua and the Czech storefront translation — ✔

What it looks like

ThePay at the classic checkout
The classic WooCommerce checkout in Czech: the method “Kartou nebo bankovním převodem (ThePay)” with the methods of the project and their logos.
ThePay at the block checkout
The WooCommerce block checkout: the ThePay method is picked, with the payment methods of the project and their logos below it.
The ThePay box in the order
An order in the admin: the ThePay box with the payment ID, the environment, the project, the method and the “Check the payment in ThePay” button.

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

v1.0.0 Current 16.11.2026

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

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

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

  1. Install the plugin and activate it (WooCommerce must be active).
  2. 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.
  3. In WooCommerce → ThePay choose demo or live, paste the credentials, press “Check connection” and save.
  4. Enable “ThePay” in WooCommerce → Settings → Payments.
  5. 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.
  6. 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

  1. Plugins → Add New → Upload Plugin: choose the zip and activate.
  2. WooCommerce → ThePay: choose the environment, paste the Merchant ID, the Project ID and the API password, check the connection, save.
  3. WooCommerce → Settings → Payments: enable “ThePay”.
  4. 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.

@catcode_support Setup, compatibility, activation
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.

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