Payment Gateways
The plugin provides multiple payment gateways that can be individually enabled in WooCommerce → Settings → Payments.

Available Gateways
Section titled “Available Gateways”| Gateway | ID | Description |
|---|---|---|
| ThePay | thepay | Main gateway — displays all enabled payment methods on a single ThePay payment page |
| ThePay – Card | thepay-card | Direct card payments (supports preauthorization) |
| ThePay – Apple Pay | thepay-applepay | Apple Pay payments (supports preauthorization) |
| ThePay – Google Pay | thepay-googlepay | Google Pay payments (supports preauthorization) |
| ThePay – Bitcoin | thepay-bitcoin | Bitcoin payments |
| ThePay – Pay in 30 days | thepay-platimpak | Buy now, pay later (PlatimPak) |
Gateway Settings
Section titled “Gateway Settings”Each gateway has the following common settings:
| Field | Description |
|---|---|
| Enable/Disable | Enable or disable this payment method |
| Title | Name displayed to customers during checkout |
| Description | Description shown below the payment method name |
| Successful payment status | WooCommerce order status after successful payment (default: Processing) |
| Display logo | Show the payment method logo in checkout |
Main Gateway (ThePay)
Section titled “Main Gateway (ThePay)”The main ThePay gateway has an additional setting:
| Field | Description |
|---|---|
| Enabled Payment methods | Select which payment methods to display on the ThePay payment page (bank transfers, card payments, etc.) |
When using the main gateway, customers are redirected to a ThePay payment page where they choose from the enabled payment methods. Available methods include card payments, bank transfers (Platba 24, mBank, Fio, ČSOB, EQUA bank, MONETA, Poštovní spořitelna, E-platby, etc.), Bitcoin and more — depending on your ThePay merchant account configuration.

Preauthorization
Section titled “Preauthorization”Card, Apple Pay, and Google Pay gateways support preauthorization — the payment amount is blocked on the customer’s card but not charged immediately. This is useful for orders that need to be verified before final charge.
Preauthorization Settings
Section titled “Preauthorization Settings”| Field | Description |
|---|---|
| Enable preauthorization | Enable the hold & capture flow |
| Authorized payment status | Order status when payment is preauthorized (default: On hold) |
| Capture preauthorization on statuses | Order statuses that trigger the final charge (default: Processing) |
| Cancel preauthorization on statuses | Order statuses that cancel the held amount (default: Cancelled, Refunded, Failed) |
How Preauthorization Works
Section titled “How Preauthorization Works”- Customer places an order and pays with a card
- The amount is blocked on the customer’s card (not charged)
- The order receives the Authorized payment status (e.g., On hold)
- When the order status changes to one of the Capture statuses (e.g., Processing), the amount is charged
- If the order status changes to one of the Cancel statuses (e.g., Cancelled), the held amount is released
Order Statuses and Emails
Section titled “Order Statuses and Emails”The plugin changes the order status according to the payment state in ThePay. Emails to the customer and to the store are sent by WooCommerce when the order status changes – the plugin itself does not send any emails.
| Situation | Order status | WooCommerce emails (default settings) |
|---|---|---|
| Order created, customer has not paid yet | Pending payment | none |
| Payment successful | Successful payment status (default: Processing) | “Processing order” to the customer, “New order” to the store |
| Card payment preauthorized | Authorized payment status (default: On hold) | “On hold” to the customer, “New order” to the store |
| Preauthorized amount captured (by switching to a capture status) | Processing | ”Processing order” to the customer |
| Payment expired or cancelled | stays Pending payment | none |
On the thank-you page the plugin shows the payment status to the customer: Received, Payment authorized (preauthorization) or Waiting for payment.
When ThePay does not report the payment (the notification does not arrive and the customer does not return to the store), the plugin checks the payment state of unpaid orders on its own – when the customer opens the order and automatically every few minutes for 30 days.
Emails are also not sent when they are disabled in WooCommerce → Settings → Emails or when your hosting does not send emails. In that case, contact your hosting support.
Refunds
Section titled “Refunds”The plugin supports full refunds through WooCommerce:
- Open the order in WooCommerce → Orders
- Click Refund
- Enter the refund amount
- Click Refund via ThePay
The refund is processed through the ThePay API and the customer receives the refunded amount back to their original payment method.

