---
site_name: Toret dokumentace
site_url: https://documentation.toret.cz
contact_email: info@toret.cz

title: Toret ThePay 2.0 plugin documentation
url: https://documentation.toret.cz/en/toret-thepay-2-0-plugin-documentation/
date: 2026-02-05
modified: 2026-03-02
author: tcirkl
type: page
---

# Toret The Pay 2.0 plugin documentation

You are on the documentation page for the The Pay 2.0 plugin, which **integrates the The Pay 2.0 payment gateway** into WooCommerce.

*To implement the payment gateway, you need to have completed **[ThePay 2.0 registration](https://admin.thepay.cz/registration?token=G2W9GGrJIrHjtxKGzuS4)**.*

You can purchase the The Pay 2.0 plugin here: [Toret ThePay 2.0 for WooCommerce](https://toret.cz/produkt/thepay-2-0/)

Table Of Contents

1. Plugin Installation
2. Plugin Activation
3. The Pay 2.0 Implementation Data
4. Allowing IP Address for API Communication
5. Setting Implementation Data in the Plugin
6. Payment Gateway Language Settings
7. Payment Link Validity
8. Loading Payment Methods
9. Payment Method Settings
 - Grouped Payment Method Settings
 -
 - Separate Payment Methods Settings
10. Other Settings
11. FAQ
 - Customer is not redirected to The Pay payment gateway after completing the order
 -
 - Adjusting Paid Order Status
12. Plugin testing

## Plugin Installation

Upon purchasing the plugin, you will receive a license key and a download link for the plugin zip file via email. You can find detailed instructions on how to install the plugin from your computer into WordPress [here](https://documentation.toret.cz/instalace-pluginu/).

## Plugin Activation

After installing the plugin, open the The Pay 2.0 plugin *(Toret Plugins > The Pay 2.0)*, insert the license key into the appropriate field, and click the button to activate.

![Toret ThePay 2.0 Plugin - activation](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-aktivace.png "Toret ThePay 2.0 Plugin - activation")

## The Pay 2.0 Implementation Data

After concluding the contract with the The Pay payment gateway provider, you will find the implementation data in your The Pay account under the Implementace (Implementation) tab.

![Toret ThePay 2.0 Plugin - implementation data](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-implementacni-udaje-1024x482-1.png "Toret ThePay 2.0 Plugin - implementation data")

Copy these data and then paste them into the identically named fields in the plugin settings (see below).

## Allowing IP Address for API Communication

The next step is to allow IP addresses in the The Pay account administration. This setting can be found under the Implementace (Implementation) tab.

These are the IP addresses of the server where you host your website. Contact your hosting provider to obtain these IP addresses.

If you need to specify a subnet, you can use the asterisk convention.

For example, 19.2.168.* for subnet 192.168.00 -192.168.255.255

To allow all IP addresses, use a single *.

![Toret ThePay 2.0 Plugin - allowing IP address for API communication](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-povoleni-ip-adresy-1024x778-1.png "Toret ThePay 2.0 Plugin - allowing IP address for API communication")

## Setting Implementation Data in the Plugin

After installing and activating the plugin, you need to insert the implementation data from your The Pay account (see above) into the plugin. You can find the relevant fields in the section *Toret plugins > The Pay 2.0*.

![Toret ThePay 2.0 Plugin - Setting implementation data in plugin](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-napojeni-1024x486.png "Toret ThePay 2.0 Plugin - Setting implementation data in plugin")

**Testovací mód (Test mode) –** activate/deactivate the test environment in this checkbox

**ID obchodníka a ID projektu (Merchant ID and Project ID)** – enter the IDs assigned to you here

**Heslo (Password)** – enter the password you generated in your account here

## Payment Gateway Language Settings

In the plugin settings (Toret plugins > The Pay 2.0), you can also set the default language of the payment gateway and the method how the language is determined – by billing country or by WordPress language.

![Toret ThePay 2.0 Plugin - payment gateway language settings](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-jazyk-1024x444.png "Toret ThePay 2.0 Plugin - payment gateway language settings")

## Payment Link Validity

Here you can set how long the payment link will remain valid. The validity can be specified in days and hours.

![plugin thePay - Payment Link Validity](https://documentation.toret.cz/wp-content/uploads/2026/03/plugin-thepay-platnost-odkazu-pro-zaplaceni-1024x347.png "plugin thePay - Payment Link Validity")

## Loading Payment Methods

The plugin loads available payment methods directly from the The Pay system. Start loading by clicking the “Načíst platební metody” (Load payment methods) button in the plugin settings *(Toret Plugins > The Pay 2.0 > Platební metody)*

![Toret ThePay 2.0 Plugin - loading payment methods](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-nacteni-platebnich-metod-1024x490.png "Toret ThePay 2.0 Plugin - loading payment methods")

## Payment Method Settings

Set the payment method in *WooCommerce > Settings > Payments*. The payment method *The Pay* is a grouped payment method through which you can set all payment methods available for your payment gateway. This method is compatible only with the default WooCommerce checkout.

**If you use a checkout with blocks**(Gutenberg checkout) in your e-shop, you need to set up separate payment methods (e.g., *The Pay: Platební karta (Payment Card)*, *The Pay: Moneta Bank*, etc.)

### Grouped Payment Method Settings

This is the payment method *The Pay*. This payment method is compatible only with the default WooCommerce checkout, and you can set all available payment methods for this payment gateway through it.

![Toret ThePay 2.0 Plugin - grouped payment method settings overview](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-woocommerce-1-1024x312-1.png "Toret ThePay 2.0 Plugin - grouped payment method settings overview")

After clicking on the detail of the The Pay 2.0 payment method, you can start configuring.

![Toret ThePay 2.0 Plugin - grouped payment method settings](https://documentation.toret.cz/wp-content/uploads/2024/12/thepay-sdruzena-platebni-metoda.png "Toret ThePay 2.0 Plugin - grouped payment method settings")

The plugin settings contain the following items:

- Povolit/Zakázat (Enable/Disable): Checking enables the payment method.
- Titulek (Title): Enter the name of the payment method that will be displayed in the checkout and cart.
- Popis (Description): Here you can add a note to the The Pay payment method, which will be displayed in the checkout.
- Ikona platební metody (Payment Method Icon): If you want to display a custom icon for the The Pay payment method on the checkout page, enter the full image URL here.
- Povolit způsob dopravy (Enable Shipping Method): Select for which shipping methods you want to have this payment gateway available. Leave the field empty to enable all shipping methods.
- Povolit The Pay platební metody (Enable The Pay Payment Methods): Select which The Pay payment methods you want to have available in the checkout.
- Povolit The Pay pro země (Enable The Pay for Countries): Select for which countries the payment gateway will be used.
- Instrukce (Instructions): Here you can write additional information about the payment method for the user. Displayed in the email to the customer.

After filling in the details, don’t forget to click the **Uložit změny (Save Changes)** button.

### Separate Payment Methods Settings

Separate payment methods (e.g., The Pay: Payment Card, The Pay: Moneta, etc.) need to be set if you use a checkout with blocks (Gutenberg checkout). Perform the settings similarly for all methods you want to offer in the checkout.

![Toret ThePay 2.0 Plugin - separate payment methods settings](https://documentation.toret.cz/wp-content/uploads/2024/12/thepay-oddelena-platebni-metoda-1024x483.png "Toret ThePay 2.0 Plugin - separate payment methods settings")

1. **Titulek (Title)** –  here you can edit the payment method name as it will be displayed when selecting the payment method at checkout

2. **Povolit/Zakázat (Enable/Disable)** – by checking this box, you determine whether customers will have this payment method available on the Checkout page or not

3. **Popis (Description)** – in this field, you can describe the payment instructions for the customer

4. **Povolit způsob dopravy (Enable Shipping Method)** –  if you want to enable all shipping methods, leave this field empty. Alternatively, you can define only certain shipping methods for the payment gateway.

5. **Dostupné země (Available Countries)** – specify for which countries the gateway will be available

6. **Ikona platební metody (Payment Method Icon)** – if you want a custom payment method icon, enter its URL here. Otherwise, the default icon from the plugin is set.

Do not forget to save the changes made. Perform this setting for all methods you want to offer in the checkout.

## Other Settings

In the plugin settings *(Toret Plugins > The Pay 2.0 > Ostatní (Other))* you can:

Enable the **Nepropisovat adresu (Do not overwrite address)** function: Use this function if you do not have the customer’s address available (e.g., if your checkout does not have these fields)

**Zapnout detailní log (Enable detailed log):** Use in case of functionality issues.

![Toret ThePay 2.0 Plugin - other settings](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-ostatni-nastaveni-1024x490.png "Toret ThePay 2.0 Plugin - other settings")

## Plugin testing

For testing purposes, you can use:

- the subdomain “dev.domainlicense” (with the same license as for the production website)
- localhost (127.0.0.1)

Purchased plugins will also work in these locations, and you can test their implementation and compatibility here before deploying them to the website and during its use.

## FAQ

### Customer is not redirected to The Pay payment gateway after completing the order

If a customer selects the The Pay payment method, completes the order, **the order is created in WooCommerce, but the customer is not redirected to the payment gateway, **it may be due to the following issues:

1. Incorrectly entered implementation data in the plugin from The Pay administration.
2. Time desynchronization. Contact The Pay support and have the failed payment checked. Their support will confirm any time desynchronization with the server where you host the website. In this case, it will be necessary to synchronize the server time.

### Adjusting Paid Order Status

After payment via the The Pay plugin, its status changes from “Pending payment” to “Processing” if the order contains physical products, or the plugin changes the order to “Completed” if it consists only of virtual products.

In case the order status after payment does not suit you, you can modify it using a filter.

Order of virtual products:

```
add_filter(‚toret_thepay20_virual_paied_product_status‘,’cutom_toret_thepay20_virual_paied_product_status‘,10,2);
function cutom_toret_thepay20_virual_paied_product_status($status,$order_id){
return ‚processing‘;
}
```

Order of physical products:

```
add_filter(‚toret_thepay20_paied_product_status‘,’custom_toret_thepay20_paied_product_status‘,10,2);function custom_toret_thepay20_paied_product_status($status,$order_id){return ‚processing‘;}
```

Example is given for changing order status to “Processing”.

Insert the filter into the child theme’s functions.php or into an empty plugin e.g.: [https://toret.cz/produkt/boilerplate/](https://toret.cz/produkt/boilerplate/)