--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret ThePay 2.0 url: https://documentation.toret.cz/thepay20/ date: 2024-06-21 modified: 2026-03-02 author: tcirkl type: page --- # Dokumentace pluginu Toret The Pay 2.0 Nacházíte se na stránkách dokumentace pluginu The Pay 2.0, který do WooCommerce **integruje platební bránu The Pay 2.0.** *Pro implementaci platební brány potřebuje mít dokončenou **[registraci ThePay 2.0](https://admin.thepay.cz/registration?token=G2W9GGrJIrHjtxKGzuS4)**.* Plugin The Pay 2.0 zakoupíte zde: [Toret ThePay 2.0 pro WooCommerce](https://toret.cz/produkt/thepay-2-0/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Implementační údaje The Pay 2.0 4. Povolení IP adresy pro komunikaci s API 5. Nastavení implementačních údajů v pluginu 6. Nastavení jazyka platební brány 7. Platnost odkazu pro uhrazení 8. Načtení platebních metod 9. Nastavení platební metody - Nastavení sdružené platební metody - - Nastavení oddělených platebních metod 10. Ostatní nastavení 11. Časté dotazy - Po dokončení objednávky není zákazník přesměrován na platební bránu The Pay - - Úprava stavu zaplacené objednávky 12. Testování pluginu ## Instalace pluginu Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete [zde](https://documentation.toret.cz/instalace-pluginu/). ## Aktivace pluginu Po instalaci pluginu si otevřete plugin The Pay 2.0 *(Toret Plugins > The Pay 2.0)*, do příslušného pole vložte licenční klíč a tlačítkem aktivujte. ![Plugin Toret ThePay2.0 - aktivace](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-aktivace.png "Plugin Toret ThePay2.0 - aktivace") ## Implementační údaje The Pay 2.0 Po uzavření smlouvy s poskytovatelem platební brány The Pay najdete implementační údaje ve svém The Pay účtu pod kartou Implementace. ![Plugin Toret ThePay2.0 - implementační údaje](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-implementacni-udaje-1024x482-1.png "Plugin Toret ThePay2.0 - implementační údaje") Tyto údaje si zkopírujte a následně vložíte do stejnojmenných polí v nastavení pluginu (viz dále). ## Povolení IP adresy pro komunikaci s API Dalším krokem je povolení IP adres v administraci účtu The Pay. Toto nastavení najdete pod kartou Implementace. Jedná se o IP adresy serveru, kde hostujete web. Pro získání těchto IP adres se obraťte na svůj hosting. V případě potřeby specifikace subnetu je možné využít hvězdičkovou konvenci. Například. 19.2.168.* pro subnet 192.168.00 -192.168.255.255 Po povolení všech IP adres použijte samotnou *. ![Plugin Toret ThePay2.0 - povolení IP adresy pro komunikaci s API](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-povoleni-ip-adresy-1024x778-1.png "Plugin Toret ThePay2.0 - povolení IP adresy pro komunikaci s API") ## Nastavení implementačních údajů v pluginu Po nainstalovaní a aktivaci pluginu je třeba implementační údaje z účtu The Pay (viz výše) vložit do pluginu. Příslušná pole najdete v sekci *Toret plugins > The Pay 2.0*. ![Plugin Toret ThePay2.0 - Nastavení implementačních údajů v pluginu](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-napojeni-1024x486.png "Plugin Toret ThePay2.0 - Nastavení implementačních údajů v pluginu") **Testovací mód –** v tomto checkboxu aktivujete/deaktivuje testovací prostředí **ID obchodníka a ID projektu** – zde zadejte ID, která vám bylo přidělena **Heslo** – zde zadejte heslo, které jste si v účtu vygenerovali ## Nastavení jazyka platební brány V nastavení pluginu (Toret plugins > The Pay 2.0) lze nastavit také výchozí jazyk platební brány a způsob, jakým se jazyk určí – podle fakturační země či podle jazyka WordPress. ![Plugin Toret ThePay2.0 - nastavení jazyka platební brány](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-jazyk-1024x444.png "Plugin Toret ThePay2.0 - nastavení jazyka platební brány") ## Platnost odkazu pro uhrazení Zde nastavíte, jak dlouho bude odkaz pro zaplacení platný. Platnost lze nastavit ve dnech a hodinách. ![plugin thepay - platnost odkazu pro zaplacení](https://documentation.toret.cz/wp-content/uploads/2026/03/plugin-thepay-platnost-odkazu-pro-zaplaceni-1024x347.png "plugin thepay - platnost odkazu pro zaplacení") ## Načtení platebních metod Dostupné platební metody plugin načítá přímo ze systému The Pay. Načtení spusťte kliknutím na tlačítko Načíst platební metody v nastavení pluginu *(Toret Plugins > The Pay 2.0 > Platební metody)* ![Plugin Toret ThePay2.0 - načtení platebních metod](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-nacteni-platebnich-metod-1024x490.png "Plugin Toret ThePay2.0 - načtení platebních metod") ## Nastavení platební metody Platební metodu nastavíte ve *WooCommerce > Nastavení > Pokladna*. Platební metoda *The Pay* je sdružená metoda platby, přes kterou lze nastavit všechny platební metody dostupné pro vaši platební bránu. Tato metoda je kompatibilní pouze s výchozí WooCommerce pokladnou. **Pokud v e-shopu používáte pokladnu s využitím bloků **(Gutenberg pokladna), je třeba nastavit oddělené platební metody (např. *The Pay: Platební karta*, *The Pay: Moneta Bank* atd.) ### Nastavení sdružené platební metody Jedná se o platební metodu *The Pay*. Tato metoda platby je kompatibilní pouze s výchozí WooCommerce pokladnou a lze přes ni nastavit všechny dostupné metody platby pro tuto platební bránu. ![Plugin Toret ThePay2.0 - nastavení sdružené platební metody](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-thepay-2.0-woocommerce-1-1024x312-1.png "Plugin Toret ThePay2.0 - nastavení sdružené platební metody") Po rozkliknutí detailu platební metody The Pay 2.0 můžete začít s nastavováním. ![Plugin Toret ThePay2.0 - nastavení sdružené platební metody](https://documentation.toret.cz/wp-content/uploads/2024/12/thepay-sdruzena-platebni-metoda.png "Plugin Toret ThePay2.0 - nastavení sdružené platební metody") Nastavení pluginu obsahuje následující položky: - Povolit/Zakázat: Zaškrtnutím aktivujete platební metodu. - Titulek: Zadejte název platební metody, který se bude zobrazovat v pokladně a košíku. - Popis: Zde je možné přidat poznámku k platební metodě The Pay, která se zobrazí v pokladně. - Ikona platební metody: Pokud chcete na stránce pokladny zobrazovat vlastní ikonu pro platební metodu The Pay, zadejte sem celou URL obrázku. - Povolit způsob dopravy: Vyberte pro jaké dopravy chcete mít tuto platební bránu dostupnou. Pro povolení všech způsobů dopravy nechte pole prázdné. - Povolit The Pay platební metody: Vyberte jaké The Pay platební metody chcete mít v pokladně dostupné. - Povolit The Pay pro země: Vyberte pro jaké země se bude platební brána používat. - Instrukce: Zde lze napsat dodatečné informace o platební metodě pro uživatele. Zobrazí se v e-mailu zákazníkovi. Po vyplnění údajů nezapomeňte kliknout na tlačítko **Uložit změny.** ### Nastavení oddělených platebních metod Oddělené platební metody (např. The Pay: Plateba kartou, The Pay: Moneta ap.) je nutné nastavit, pokud používáte pokladnu s využitím bloků (Gutenberg pokladnu). Nastavení proveďte obdobně pro všechny metody, které chcete v pokladně nabízet. ![Plugin Toret ThePay2.0 - nastavení oddělení platebních metod](https://documentation.toret.cz/wp-content/uploads/2024/12/thepay-oddelena-platebni-metoda-1024x483.png "Plugin Toret ThePay2.0 - nastavení oddělení platebních metod") 1. **Titulek** – zde si můžete upravit název platební metody tak, jak se bude zobrazovat při výběru platební metody na pokladně 2. **Povolit/Zakázat** – zaškrtnutím tohoto políčka, určíte, zda budou mít zákazníci tuto platební metodu na stránce Pokladna k dispozici či ne 3. **Popis** – v tomto poli můžete pro zákazníka popsat instrukce k platbě 4. **Povolit způsob dopravy** – pokud chcete povolit všechny způsoby dopravy, ponechejte toto pole prázdné. Případně si můžete definovat pro platební bránu jen některé způsoby dopravy. 5. **Dostupné země** – specifikujte, pro které země bude brána dostupná 6. **Ikona platební metody** – pokud chcete vlastní ikonu platební metody, zadejte její URL zde. V opačném případě je nastavena defaultní ikona z pluginu. Provedené změny nezapomeňte uložit. Toto nastavení proveďte pro všechny metody, které chcete v pokladně nabízet. ## Ostatní nastavení V nastavení pluginu *(Toret Plugins > The Pay 2.0 > Ostatní)* můžete: Povolit funkci **Nepropisovat adresu:** Tuto funkci využijte v případě, že nemáte k dispozici adresu zákazníka (např. pokud vaše pokladna nemá tato pole) **Zapnout detailní log:** Využijete v případě problémů s funkčností. ![Plugin Toret ThePay2.0 - ostatní nastavení ](https://documentation.toret.cz/wp-content/uploads/2025/12/thepay-ostatni-nastaveni-1024x490.png "Plugin Toret ThePay2.0 - ostatní nastavení ") ## Testování pluginu Pro účely testování můžete využít: - subdoménu “dev.doménalicence” (se stejnou licencí jako pro produkční web) - localhost (127.0.0.1) Na těchto umístěních budou zakoupené pluginy fungovat také a můžete zde otestovat implementaci a kompatibilitu před ostrým nasazením na web i v průběhu jeho užívání. ## Časté dotazy ### Po dokončení objednávky není zákazník přesměrován na platební bránu The Pay Pokud si zákazník vybere platební metodu The Pay, dokončí objednávku, **objednávka se vytvoří ve Woo Commerci, ale zákazník není přesměrován na platební bránu, **může se jednat o následující problémy: 1. Špatně zadané implementační údaje v pluginu z administrace The Pay. 2. Desynchronizaci času. Kontaktujte podporu The Pay a nechte si chybnou platbu prověřit. Jejich podpora Vám případně potvrdí desynchronizaci času se serverem, kde hostujete web. V tomto případě bude nutné synchronizovat čas serveru. ### Úprava stavu zaplacené objednávky Po uhrazení objednávky přes The Pay plugin změní její stav z „Čeká na platbu“ (Pending) na „Zpracovává se“ (Processing) v případě, že objednávka obsahuje fyzické produkty, nebo plugin změní objednávku na stav „Dokončeno“ (Completed), pokud je tvořená pouze z virtuálních produktů. V případě, že vám stav objednávky po uhrazení nevyhovuje, můžete jej upravit pomocí filtru. Objednávka virtuálních produktů: ``` 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‘; } ``` Objednávka fyzických produktů: ``` 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‘;} ``` Příklad je uveden pro změnu stavu objednávky na „Zpracovává se“. Filtr vložíte do child šablony functions.php nebo do prázdného pluginu např.: [https://toret.cz/produkt/boilerplate/](https://toret.cz/produkt/boilerplate/)