
ThePay for OpenCart — card and bank transfer payments (Czech Republic)
ThePay for OpenCart 4.x, 3.x, 2.3 (Czech Republic): card and bank transfer payments on the ThePay page; Pro adds all methods, all currencies, partial refunds, a payment watchdog and a journal. Lifetime licence.
- Compatibility
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · module languages: English, Čeština
- PHP
- 7.0 or newer
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- 15.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 the buyer and the shop get
At the checkout the buyer chooses “Online payment (ThePay)”, sees the payment methods of your project with logos (card, bank buttons) and presses “Continue to payment”.
What is in the admin
Extensions → Extensions → Payments → ThePay Payments (CatCode): the tabs “General”, “Checkout”, “Order statuses” and “Pro”.

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
OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
A contract with ThePay is required: Merchant ID, Project ID and the API password from the ThePay admin.
ThePay accepts requests only from IP addresses added to the allowed list in its admin: without that every request gets 403. “Check connection” shows the server address to add; behind NAT or a proxy the outgoing address may differ from it.
The free version accepts CZK and EUR; other shop currencies are converted to CZK (or EUR, if that is the shop currency) at the OpenCart rate, or the method is hidden. All the currencies of the project are in Pro.
The free version shows the methods tagged “card” and “bank transfer”; Apple Pay, Google Pay, Bitcoin, deferred payments and other methods without those tags are in Pro.
The list of methods is cached for 10 minutes: a method switched off in the ThePay admin may still be shown at the checkout for up to 10 minutes; an attempt to pay with it ends with a message and the buyer chooses another.
ThePay notifications arrive without a signature, so the module always re-reads the payment through the API before it changes an order: a forged request changes nothing.
The payment validity defaults to 1440 minutes (1 day, within 15–10080), so that a bank transfer has time to arrive; it can be changed in the settings.
On OpenCart 4 the payment watchdog runs from the built-in scheduler once an hour; on 3.x and 2.3, or instead of the scheduler, call the cron URL from the settings on your hosting, for example every 15 minutes.
Version history
For OpenCart 4.x, 3.x and 2.3: card and bank transfer payments on the ThePay page, a check of every payment at ThePay before an order changes, pay again, amount matching, the demo and live…
Frequently bought with ThePay


Cart Discounts (Amount-Based and N+1) for OpenCart

Fakturoid for OpenCart 4.x — invoices from the order page

Vyfakturuj Invoices for OpenCart — Vyfakturuj.cz invoices from orders
Full module description
ThePay Payments for OpenCart 4.x, 3.x and 2.3 takes card and bank transfer payments through the Czech ThePay payment gateway with your own merchant contract: the buyer pays on the secure ThePay page, and the card never passes through your site. An order changes its status only after the module has read the payment back from ThePay.
What the buyer and the shop get
At the checkout the buyer chooses “Online payment (ThePay)”, sees the payment methods of your project with logos (card, bank buttons) and presses “Continue to payment”. The module creates a payment at ThePay and sends the buyer to the secure page, where they pay with the chosen method. After paying, ThePay returns them to the site.
The order status changes only after the module has asked ThePay for the state of this payment; both the ThePay notification and the buyer’s return trigger that. If the buyer cancelled or the payment did not go through, they see a plain message with the buttons “Pay again” and “Back to checkout”, and the cart stays. “Pay again” reuses the same ThePay payment while it can still be paid, so no second payment appears.
The payment amount, currency, order number and project are matched with the order. If the cart changed after the payment was created or ThePay returned a different amount, the order gets the status “Needs review” with an explanation. A second payment of the same order is marked in the order, so a double payment is not lost, and a late or older payment state does not roll back an order that is already paid.
When the shop currency is neither koruna nor euro, the free version converts the amount to CZK (or to EUR, if that is the shop currency) at the OpenCart rate or hides the payment method. Pro accepts all the currencies your ThePay project supports.
What is in the admin
Extensions → Extensions → Payments → ThePay Payments (CatCode): the tabs “General”, “Checkout”, “Order statuses” and “Pro”. Copy the Merchant ID, Project ID and API password from the ThePay admin, paste them on the “General” tab, choose the demo or live environment and press “Check connection”: the module checks the project, loads its methods and tells you what is wrong if ThePay rejected the password (401), the server IP address (403) or the project. The API password is stored encrypted and is not shown again.
On the “Checkout” tab you set the method name and the description under it for every shop language, the minimum total, the geo zone and the sort order; on “Order statuses” you choose the statuses for “Paid”, “Needs review” and “Refunded”. The buyer-facing texts are in English and Czech, amounts are shown in the shop format (for example 1,300.00 Kč), and the ThePay page opens in the buyer’s language.
The Pro tab opens all methods of the project, the choice of where the buyer picks the method (at the shop checkout with the method already chosen, or freely on the ThePay page), the conversion currency, a separate ThePay project for each OpenCart shop, the ThePay notification address, the payment watchdog state with a manual check button and the URL for the hosting cron. The order page shows the payment, amount, method, identifier and payment attempts; the “Refund” button returns everything left, and in Pro you can enter the amount of a partial refund, and several partial refunds add up. “Check at ThePay” re-reads the payment, and refunds made in the ThePay admin are picked up and set the order to “Refunded”. The payment journal opens from the settings page.
Without a licence the Pro fields are shown disabled with an explanation, and stored Pro values do not reach the requests to ThePay. The “Try Pro” button starts a 7-day trial.
How it works, step by step
- Install the archive for your OpenCart version and install the method under “Payments”.
- In the ThePay admin take the Merchant ID, Project ID and API password, and add your server IP address to the allowed list.
- Paste them on the “General” tab, choose the demo or live environment and press “Check connection”.
- Set the method name, the minimum total and the geo zone on the “Checkout” tab.
- Place an order in koruna and pay on the ThePay page: after the return the order gets the status “Paid”.
- In Pro switch on all methods, the method choice, partial refunds and the payment watchdog.
Under the hood
- ThePay API v1 as specified in OpenAPI: the payment gateway, the project methods, the payment state, cancelling (invalidate) and refunds, and state-change notifications.
- Each request is signed (sha256 of the Merchant ID, the password and the date), the API password is encrypted, and no card data touches your site.
- Every payment has its own unique identifier: if the reply to a create call is lost, a retry with the same identifier does not create a duplicate; an open payment is reused, and the old one is cancelled when the cart or the method changed.
- The notification, the buyer’s return, the payment page and the watchdog all go through one handler: parallel clicks, a notification together with the buyer’s return, and retries produce a single record.
- All calls to ThePay have a time limit for the buyer’s action; if ThePay does not answer, the buyer sees a plain message and the cart stays. During ThePay maintenance (503) notifications are retried and accepted later.
- The payment watchdog finds open payments (the buyer paid and closed the page) and settles the orders, the oldest first.
- After the trial ends the Pro features switch off and the free payment keeps working.
- The interface is in English and Czech, and the debug log (without the password, card numbers or buyer data) is switched on in the settings.
Installation
- OpenCart 4: Extensions → Installer, upload cc_thepay.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_thepay-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, upload cc_thepay-oc23.ocmod.zip (FTP settings are needed in System → Settings → FTP; otherwise unpack the archive and upload the contents of the upload/ folder to the shop root by hand), then Extensions → Modifications → Refresh.
- Extensions → Payments → ThePay Payments (CatCode): install and open the settings.
- Paste the Merchant ID, Project ID and API password, choose the environment and press “Check connection”.
- For Pro: paste the licence key or start the trial on the “Pro” tab.
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 module?
No, it is an independent integration through the public API. ThePay is a trademark of its owner.
Where do I get the Merchant ID, Project ID and API password?
In the ThePay admin 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 list in your ThePay admin (otherwise 403) and only with the right API password (otherwise 401). Add the server address that "Check connection" shows.
Do cards pass through my site?
No. The buyer pays on the secure ThePay page, and only the result comes back to the site.
When does an order become paid?
After the module has asked ThePay for the payment state and received "paid". The buyer's return without ThePay's confirmation does not pay the order.
What if the buyer paid and closed the page?
The ThePay notification settles the order without the buyer's return; in Pro the payment watchdog also picks up the ones whose notification did not arrive.
Which payment methods are available?
In the free version, the methods of your project tagged "card" and "bank transfer". Apple Pay, Google Pay and others are in Pro.
Can I refund money?
Yes: a full refund with one button on the order page is in the free version, partial refunds are in Pro.
Which currencies are supported?
The free version supports CZK and EUR (others are converted at the OpenCart rate, or the method is hidden); Pro supports all the currencies your ThePay project accepts.
Which OpenCart versions are supported?
OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence lifetime?
Yes, for OpenCart it is a single payment and a lifetime licence, for two sites.
What happens after the trial?
Pro switches off and the free part keeps working.
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.




















