Skip to content

Payment Gateways

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

Payment gateways at checkout

GatewayIDDescription
ThePaythepayMain gateway — displays all enabled payment methods on a single ThePay payment page
ThePay – Cardthepay-cardDirect card payments (supports preauthorization)
ThePay – Apple Paythepay-applepayApple Pay payments (supports preauthorization)
ThePay – Google Paythepay-googlepayGoogle Pay payments (supports preauthorization)
ThePay – Bitcointhepay-bitcoinBitcoin payments
ThePay – Pay in 30 daysthepay-platimpakBuy now, pay later (PlatimPak)

Each gateway has the following common settings:

FieldDescription
Enable/DisableEnable or disable this payment method
TitleName displayed to customers during checkout
DescriptionDescription shown below the payment method name
Successful payment statusWooCommerce order status after successful payment (default: Processing)
Display logoShow the payment method logo in checkout

The main ThePay gateway has an additional setting:

FieldDescription
Enabled Payment methodsSelect 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.

ThePay payment page

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.

FieldDescription
Enable preauthorizationEnable the hold & capture flow
Authorized payment statusOrder status when payment is preauthorized (default: On hold)
Capture preauthorization on statusesOrder statuses that trigger the final charge (default: Processing)
Cancel preauthorization on statusesOrder statuses that cancel the held amount (default: Cancelled, Refunded, Failed)
  1. Customer places an order and pays with a card
  2. The amount is blocked on the customer’s card (not charged)
  3. The order receives the Authorized payment status (e.g., On hold)
  4. When the order status changes to one of the Capture statuses (e.g., Processing), the amount is charged
  5. If the order status changes to one of the Cancel statuses (e.g., Cancelled), the held amount is released

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.

SituationOrder statusWooCommerce emails (default settings)
Order created, customer has not paid yetPending paymentnone
Payment successfulSuccessful payment status (default: Processing)“Processing order” to the customer, “New order” to the store
Card payment preauthorizedAuthorized 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 cancelledstays Pending paymentnone

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.

The plugin supports full refunds through WooCommerce:

  1. Open the order in WooCommerce → Orders
  2. Click Refund
  3. Enter the refund amount
  4. 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.

Payment confirmation

Transactions overview