--- site_name: Toret dokumentace site_url: https://documentation.toret.cz contact_email: info@toret.cz title: Dokumentace pluginu Toret GoPay Inline url: https://documentation.toret.cz/gopay-inline/ date: 2024-06-20 modified: 2026-07-06 author: tcirkl type: page --- # Dokumentace pluginu Toret Go Pay Inline Nacházíte se na stránkách dokumentace pluginu Go Pay Inline, který integruje platební bránu Go Pay. Plugin Go Pay Inline zakoupíte zde: [Toret GoPay Inline pro WooCommerce](https://toret.cz/produkt/woo-gopay-inline-platebni-brana/) Obsah 1. Instalace pluginu 2. Aktivace pluginu 3. Videonávod 4. Nastavení přístupových údajů 5. Nastavení daňových sazeb 6. Aktivace platebních metod - Nastavení pro WooCommerce shortcode pokladnu - - Nastavení pro blokovou pokladnu 7. Nastavení oddělených platebních metod - Povolení doprav a zemí - - Apple Pay 8. Nastavení hromadné platební metody Go Pay 9. Testování plateb 10. Opakované platby (předplatné) 11. Refundace 12. Kompatibilita s WPML 13. Omezení platebních metod pomocí filtru 14. Výchozí jazyk platební brány 15. Doplňující nastavení pro případ selhání platby - Přidání odkazu na platbu do e-mailu - - Skrytí platební metody při opakovaném pokusu o platbu 16. Filtry - Jazyk platební brány - Ovlivnění jazyka pomocí vlastní funkce - Filtr pro změnu čísla objednávky v Go Pay - - Filtr pro jazyk platební brány - - Změna jazyka brány pomocí filtru - - Změna klientských údajů pomocí filtru - - Změna stavu objednávky u zaplacené transakce - - Změna stavu objednávky pro zrušenou nebo neplatnou platbu - - Filtr pro přidání popisku k jednotlivé platební metodě - - Filtry pro data odesílaná do Go Pay 17. Časté dotazy - Debugování chyb - - Bohužel vaše objednávka nemůže být zpracována, protože vaše banka/obchodník odmítl transakci. Zkuste platbu provést později, nebo vyberte jinou platební metodu. - - Jak získat GOID a secure key - - Co je testovací provoz - - Chyba: IOException: Read timed out – Potíže doručovat HTTP notifikace o změně stavu platby - - Kde je nastavení plateb pomocí Go Pay - - Kam vložit licenční klíč - - Co znamená výběr platební metody - - Chyba Go Pay platby: Scope je prázdné, kontaktujte podporu pluginu - - Po kliknutí na objednat se neotevře okno pro platbu, ale rovnou se zobrazí děkovná stránka - - Nezobrazuje se výběr platebních metod - - SCOPE je prázdné - - Zdvojené faktury a zdvojené odečítání ze skladu - - V pokladně se nezobrazují loga a checkboxy platebních metod - - Úprava zobrazení log v blokové pokladně 18. 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 Go Pay Inline, do příslušného pole vložíte licenční klíč a tlačítkem aktivujte. ![Plugin Toret GoPay Inline - aktivace](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-aktivace-1024x462.png "Plugin Toret GoPay Inline - aktivace") ## Videonávod [Propojení pluginu Toret GoPay Inline a služby GoPay](https://www.youtube.com/embed/yqDIDXVcBC8?feature=oembed) ## Nastavení přístupových údajů V nastavení pluginu Go Pay *(Toret plugins > Go Pay Inline > Přístupové údaje)* je nutné zadat následující údaje, které získáte od společnosti Go Pay: - Go ID – id eshopu, které jste obdrželi od Go Pay - Client ID – vaše přidělené klientské číslo - Client secret – kód, pro spojení s api Go Pay **!Pozor:** Před ostrým spuštěním provozu, je třeba platební bránu otestovat. Proto nejprve od Go Pay obdržíte testovací údaje a používáte testovací mód. Teprve po úspěšném otestování získáte údaje provozní, kterými je nahradíte. ![Plugin Toret GoPay Inline - nastavení přístupových údajů](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-nastaveni-pristupovych-udaju-1024x479.png "Plugin Toret GoPay Inline - nastavení přístupových údajů") **Testovací mód** – nastavení určuje, zda provádíte testovací platby, či již nastavujete ostrý provoz. Zapněte jej, pokud vkládáte testovací údaje. Při komunikaci s Go Pay po Vás bude vyžadována **notifikační URL**. Je potřeba jim sdělit, že plugin Go Pay Inline používá technologii Rest API, což znamená, že si tuto notifikační URL vygeneruje a pošle sám. ## Nastavení daňových sazeb Daňové sazby k příplatkům, dopravě a kupónům nastavíte v nastavení pluginu (Toret plugins > Go Pay Inline > Daňové sazby). ![Plugin Toret GoPay Inline - nastavení daňových sazeb](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-nastaveni-danovych-sazeb-1024x453.png "Plugin Toret GoPay Inline - nastavení daňových sazeb") ## Aktivace platebních metod Po aktivaci licence, je třeba aktivovat platební metody Go Pay Inline. To provedete ve *WooCommerce > Nastavení > Pokladna.* Zde ze seznamu vyberete a povolíte platební metody, které chcete využívat. ![Plugin Toret GoPay Inline - aktivace platebních metod](https://documentation.toret.cz/wp-content/uploads/2024/09/gopay-aktivace-platebnich-metod.png "Plugin Toret GoPay Inline - aktivace platebních metod") ### Nastavení pro WooCommerce shortcode pokladnu Pro shortcode pokladnu můžete využít hromadnou metodu Go Pay nebo nastavit samostatné metody. ![Plugin Toret GoPay Inline - nastavení platebních metod](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-platebni-metody-1024x449.png "Plugin Toret GoPay Inline - nastavení platebních metod") Přes metodu „Go Pay“ (hromadná metoda) lze nastavit všechny způsoby platby, které se v pokladně objeví podřazené pod jednou platební metodou. ![Plugin Toret GoPay Inline - hromadná metoda v pokladně](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-platebni-metody-hromadna-1-1024x525.png "Plugin Toret GoPay Inline - hromadná metoda v pokladně") Nebo lze využít oddělené metody platby – např. Go Pay: mplatba, Go Pay: Platební karty atd. ![Plugin Toret GoPay Inline - samostatné metody](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-platebni-metody-samostatna-1024x492.png "Plugin Toret GoPay Inline - samostatné metody") Jakmile metodu aktivujete přepínačem, budete mít tuto platbu k dispozici. Klikněte na *Spravovat*a pokračujte s nastavením platební metody (viz níže) > TIP: Pokud chcete, aby si vaši zákazníci vybrali způsob platby až v platební bráně, použijte metodu *Go Pay: Výběr v platební bráně.* ### Nastavení pro blokovou pokladnu V blokové pokladně je nutné: Mít aktivní metodu „Go Pay“ (hromadná) – zde slouží pouze jako metoda pro platbu kartou (bez podřazených položek). Pokud nebude aktivní, ostatní metody nebudou fungovat. --- Další metody platby nastavit pomocí oddělených metod. --- ![Plugin Toret GoPay Inline - nastavení platebních metod](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-platebni-metody-1024x449.png "Plugin Toret GoPay Inline - nastavení platebních metod") **Pozor!** Vždy je třeba mít aktivní platební metodu „Go Pay“ (hromadná metoda). Bez její aktivace nebudou funkční ani žádné další Go Pay metody platby (např. Go Pay: m Platba). ## Nastavení oddělených platebních metod Po rozkliknutí platební metody lze nastavit: - titulek a popis metody, které se zobrazí v pokladně - způsoby dopravy zásilky, pro které bude tato platební metoda dostupná - země, pro které bude tato platební metoda dostupná - ikonu platební metody, která se zobrazí v pokladně ![Plugin Toret GoPay Inline - nastavení oddělených platebních metod](https://documentation.toret.cz/wp-content/uploads/2024/09/gopay-nastaveni-platebni-metody-1024x555.png "Plugin Toret GoPay Inline - nastavení oddělených platebních metod") Provedené změny nezapomeňte uložit. ### Povolení doprav a zemí Pro správné fungování platebního procesu je často nutné omezit platební bránu jen na určité země nebo dopravní metody. Např. Pro osobní vyzvednutí můžete chtít zakázat platbu kartou. V nastavení platební metody najdete pole pro způsoby dopravy a země, kterých se omezení bude týkat. Pokud necháte pole prázdné, bude metoda aktivní pro všechny země / způsoby dopravy povolené v e-shopu. ![Plugin Toret GoPay Inline - nastavení doprav a zemí](https://documentation.toret.cz/wp-content/uploads/2024/06/gopay-povolit-zpusob-dopravy.png "Plugin Toret GoPay Inline - nastavení doprav a zemí")![Plugin Toret GoPay Inline - nastavení doprav a zemí](https://documentation.toret.cz/wp-content/uploads/2024/06/GoPay-povolit-zeme.png "Plugin Toret GoPay Inline - nastavení doprav a zemí") ### Apple Pay Pokud chcete v pokladně nabízet metodu platby Apple Pay, je třeba ji nejprve aktivovat v Go Pay účtu na gopay.cz ![Plugin Toret GoPay Inline - nastavení Apple Pay](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gopay-inline-nastaveni-apple-pay.png "Plugin Toret GoPay Inline - nastavení Apple Pay") Po aktivaci v účtu můžete metodu platby Go Pay: Apple Pay aktivovat v nastavení WooCommerce pokladny (viz výše). Nyní se Vám v pokladně zobrazí platební metoda Apple Pay. **!Pozor:**V testovacím režimu nelze úspěšně uhradit platbu Apple Pay, protože neumožňuje využít testovací platební karty. Všechny platby se tedy budou jevit zamítnuté ze strany banky. TIP: Plugin obsahuje kontrolu dostupnosti Apple Pay. To znamená, že se tato metoda platby se může zobrazovat pouze uživatelům zařízení Apple (ostatním zůstane v pokladně skrytá). Tuto kontrolu lze vypnout v nastavení pluginu a zobrazovat metodu všem bez rozdílu (Toret plugins > Go Pay Inline > Apple pay) ![Plugin GoPay Inline nastaveni zobrazeni Apple pay 1024x169](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-GoPay-Inline-nastaveni-zobrazeni-Apple-pay-1024x169.png "Plugin GoPay Inline nastaveni zobrazeni Apple pay 1024x169") ## Nastavení hromadné platební metody Go Pay Jedná se o nastavení platební metody, ve které jsou všechny způsoby platby Go Pay v jedné platební metodě WooCommerce – platební metoda „Go Pay“. Pozor! Způsoby platby nastavené v této metodě **se nezobrazují v případě použití blokového editoru v pokladně** (Gutenberg pokladna), ale i tak je při použití blokové pokladny **nutné mít tuto metodu aktivní**. Pro zobrazení jednotlivých metod v Gutenberg pokladně využijte oddělené platební metody Go Pay. Toto nastavení provedete přes metodu platby *Go Pay (WooCommerce >Nastavení > Pokladna > Go Pay)*. Zde lze nastavit: - titulek a popis metody, které se zobrazí v pokladně - způsoby dopravy zásilky, pro které bude tato platební metoda dostupná - země, pro které bude tato platební metoda dostupná - ikonu platební metody - povolené platební metody a bankovní převody - výběr, předvýběr a řazení metod v pokladně ![Plugin Toret GoPay Inline - nastavení hromadné platební metody](https://documentation.toret.cz/wp-content/uploads/2024/09/gopay-nastaveni-platebni-metody-puvodni-1024x560.png "Plugin Toret GoPay Inline - nastavení hromadné platební metody") Pole *Povolit Go Pay platební metody* slouží k výběru metod, které se zobrazí v pokladně. Po kliknutí do pole se zobrazí dostupné platební metody, ze kterých vyberete požadované. Pokud necháte pole prázdné, bude metoda aktivní pro všechny země / způsoby dopravy povolené v e-shopu. Provedené změny nezapomeňte uložit ve spodní části stránky. ![Plugin Toret GoPay Inline - nastavení povolených platebních metod](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gopay-inline-nastaveni-apple-pay-na-webu.png "Plugin Toret GoPay Inline - nastavení povolených platebních metod") ## Testování plateb Všechny údaje i postup plateb pro otestování platební brány najdete v **testovacím integračním soupisu**, který jste obdrželi od společnosti Go Pay po schválení vaší registrace. Pro vyzkoušení funkčnosti pluginu se používají tyto testovací karty: | Typ karty | Číslo karty | **Country kód vydavatele platební karty** | | --- | --- | --- | | Master Card | 5447380000000006 | CZE | | VISA | 4444444444444448 | POL | *Jako CVV/CVC kód můžete uvést jakékoli 3 čísla, např. 123 a jako datum expirace můžete uvést jakýkoli datum, pokud je v budoucnu, např. 03/28. * Výsledek autorizace záleží na použité částce. | **Částka končí na** | **Příklad** | **Výsledek** | | --- | --- | --- | | *00 | 10,00 CZK | Autorizace úspěšná – platba uhrazena | | *04 | 15,04 EUR | Autorizace neúspěšná – platba zamítnuta | Podmínkou testování je **[zapnutý testovací mód](https://documentation.toret.cz/#testovaci-mod)**v pluginu. Jakmile máte testování za sebou, napište e-mail na *integrace@gopay.cz*. Pracovníci Go Pay následně **zkontrolují**, jestli se vám podařilo **správně integrovat platební bránu Go Pay** na vašem e-shopu. Pokud je vše v pořádku, získáte provozní údaje pro ostrý provoz platební brány. Tyto údaje zadáte namísto testovacích a vypnete testovací mód. Nyní již můžete přijímat platby přes tuto platební bránu. ## Opakované platby (předplatné) Plugin Go Pay Inline je možné používat v kombinaci s pluginem WooCommerce Subscription pro opakované platby (předplatné). Aby bylo možné opakované platby využívat, je třeba kontaktovat podporu Go Pay Inline a **zažádat o povolení opakovaných plateb na vyžádání**. ## Refundace Plugin umožňuje přímé vrácení peněz přes platební bránu. Tuto funkci najdete v detailu objednávky > tlačítko Vrátit > Vrátit x Kč přes Go Pay Inline ![Plugin Toret GoPay Inline - refundace](https://documentation.toret.cz/wp-content/uploads/2025/04/comgate-refundace-1024x389.png "Plugin Toret GoPay Inline - refundace") ## Kompatibilita s WPML WPML je jeden z nejpoužívanějších pluginů pro vytváření jazykových verzí WordPress stránek. **Plugin pro platební bránu je plně přeložitelný, pomocí MO souborů, s kterými umí pracovat program Po Edit a plugin Loco Translate.** Plugin obsahuje detekci zvoleného jazyka a podle něj nastaví jazyk dialogu platební brány. **Akceptovány jsou tyto jazyky:** - Angličtina - Němčina - Ruština - Polština - Slovenština - Čeština Při jiném jazyce je automaticky nastavena čeština. ## Omezení platebních metod pomocí filtru Výběr platebních metod, které Go Pay nabízí, umožňuje select s ikonami každé platební metody. Protože má Go Pay nastavení, které umožňuje vybrat, pro které země se bude nabídka zobrazovat, můžete výběr povolit například pro Českou Republiku, ale pro Slovensko ne. To může být problematické, pokud potřebujete pro některé případy vypnout určité platební metody. Proto plugin obsahuje filter gopay_checkout_enabled_methods, který umožňuje upravovat pole platebních metod pro Go Pay. Jsou to: - PAYMENT_CARD - BANK_ACCOUNT - PRSMS - MPAYMENT - PAYSAFECARD - SUPERCASH - GOPAY - PAYPAL - BITCOIN Následující funkce umístěná do souboru functions.php zobrazí pro angličtinu a němčinu (při použití WPML) jen PayPal a platební kartu: ``` add_filter( 'gopay_checkout_enabled_methods', 'custom_en_payments' ); function custom_en_payments( $payment_methods ){ if( ICL_LANGUAGE_CODE == 'en' || ICL_LANGUAGE_CODE == 'de' ){ $new_array = array(); foreach( $payment_methods as $key => $item ){ if( $key == 'PAYMENT_CARD' ){ $new_array[$key] = $item; } elseif( $key == 'PAYPAL' ){ $new_array[$key] = $item; } } if( !empty( $new_array ) ){ return $new_array; } } return $payment_methods; } ``` ## Výchozí jazyk platební brány Platební brána Go Pay podporuje několik jazyků. Podle fakturační země, kterou zákazník zadá v pokladně, plugin určí, v jakém jazyce se bude brána zobrazovat. Např. při zadání slovenské fakturační adresy bude rozhraní ve slovenštině. Je ale možné, že zákazník bude z jiné země, než je nadefinováno v pluginu (GB, DE, PL, SK a CZ). Proto je možné v nastavení pluginu*Toret plugins > Go Pay Inline*, zvolit**výchozí jazyk pro všechny ostatní země.** ![Plugin Toret GoPay Inline - nastavení výchozího jazyka platební brány](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-nastaveni-vychoziho-jazyka-platebni-brany.png "Plugin Toret GoPay Inline - nastavení výchozího jazyka platební brány") Pro pokročilé nastavení obsahuje plugin i filtr, který umožňuje manipulovat s jazykem brány: ``` return apply_filters( ‚gopay_inline_default_lang‘, $lang, $order ); ``` ## Doplňující nastavení pro případ selhání platby Následující nastavení se uplatní v případě, že nedojde k zaplacení v platební bráně bezprostředně po odeslání objednávky. ### Přidání odkazu na platbu do e-mailu Do automatických e-mailů, které se odesílají ve stavu objednávky Čeká na platbu a Selhalo, lze přidat odkaz na zaplacení přes tuto platební bránu. Funkci zapnete v nastavení pluginu *(Toret plugins > Go Pay Inline > Obecné nastavení)*. Provedené změny nezapomeňte uložit. ![Plugin Toret GoPay Inline - Přidání odkazu na platbu do e-mailu](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-Pridani-odkazu-na-platbu-do-e-mailu-1024x469.png "Plugin Toret GoPay Inline - Přidání odkazu na platbu do e-mailu") ### Skrytí platební metody při opakovaném pokusu o platbu Při opakování pokusu o zaplacení lze tuto platební metodu skrýt a navést tak zákazníka k jinému způsobu platby. Funkci zapnete v nastavení pluginu *(Toret plugins > Go Pay Inline > Obecné nastavení)*. Provedené změny nezapomeňte uložit. ![Plugin Toret GoPay Inline - Skrytí platební metody při opakovaném pokusu o platbu](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-Skryti-platebni-metody-pri-opakovanem-pokusu-o-platbu-1024x469.png "Plugin Toret GoPay Inline - Skrytí platební metody při opakovaném pokusu o platbu") ## Filtry ### Jazyk platební brány Vyvolání dialogu platební brány lze provést v různých jazycích. Go Pay tak umožňuje používat platební bránu i pro zahraniční zákazníky. Bohužel, WordPress nemá v sobě zakomponovaný mechanismus pro změnu jazyka webu. Proto se na toto používají různé doplňkové pluginy. Ty sice umožňují mít vícejazyčný web a většinou spolupracují s WooCommerce, ale protože je jich více, není vždy možné zjistit, v jakém jazyce je přepnutý e-shop ve chvíli, kdy je uskutečněna objednávka. U většiny pluginů je možné zjistit aktuální jazyk a dle toho upravit i jazyk vyvolaného dialogu pro Go Pay. Pro tento případ je v pluginu připraven filtr, s názvem **gopay_inline_default_lang**. Ten přijímá argumenty $default_lang a $order. Defaultní jazyk platební brány je stanovován následovně: - Zkontroluje se nastavení pluginu a pokud není nastaven výchozí jazyk, je označen jako CS. - Následně se zkontroluje země zákazníka a pro GB, PL, SK, DE a RU se nastaví odpovídající jazyk. Pokud je země jiná, použije se v prvním kroku nastavený výchozí jazyk. - V posledním kroku se vrací nastavený jazyk, přes výše zmíněný filtr gopay_inline_default_lang Kód funkce pro stanovení jazyka: ``` function gopay_inline_get_lang( $order, $order_meta ){ $country = $order_meta[‚_billing_country‘][0]; $option = get_option( ‚woo_gopay_inline‘ ); if( !empty( $option[‚default-lang‘]) && $option[‚default-lang‘] != ‚-‚ ){ $default_lang = $option[‚default-lang‘]; }else{ $default_lang = ‚CS‘; } if( $country == ‚CZ‘ ){ $lang = ‚CS‘; } elseif( $country == ‚GB‘ ){ $lang = ‚EN‘; } elseif( $country == ‚SK‘ ){ $lang = ‚SK‘; } elseif( $country == ‚DE‘ ){ $lang = ‚DE‘; } elseif( $country == ‚RU‘ ){ $lang = ‚RU‘; } elseif( $country == ‚PL‘ ){ $lang = ‚PL‘; } else{ //Get default language $lang = $default_lang; } return apply_filters( ‚gopay_inline_default_lang‘, $lang, $order ); } ``` #### Ovlivnění jazyka pomocí vlastní funkce Jazyk platební brány můžete ovlivnit právě pomocí filtru v posledním kroku. Do pluginu, nebo do functions.php aktivní šablony vložte funkci: ``` // Custom filter from payment Gateway developers add_filter( 'gopay_inline_default_lang', 'gopay_create_payment_lang' ); function gopay_create_payment_lang(){ return 'EN'; } // End of custom filter from payment Gateway developers ``` Nyní bude vaše platební brána vždy v angličtině. V případě, že chcete zobrazovat dialog podle zvoleného jazyka, musíte kód funkce upravit tak, aby reflektovala aktuální jazyk. Což je ale již záležitost použitého pluginu. ### Filtr pro změnu čísla objednávky v Go Pay V případě, že potřebujete manipulovat s číslem objednávky, jež je odesláno do systému Go Pay, můžete využít filtr „gopay_inline_invoice_number“ ``` $gopay_invoice = apply_filters( ‚gopay_inline_invoice_number‘, $order_id ); ``` ### Filtr pro jazyk platební brány ``` apply_filters( ‚gopay_inline_default_lang‘, $lang, $order ); ``` ### Změna jazyka brány pomocí filtru Přestože se snažíme co nejvíce usnadnit používání pluginu, není možné být připraven na všechny možnosti, které WordPress nabízí. Proto plugin obsahuje filtr, pomocí kterého je možné změnit nastavení jazyka platební brány. Pomocí následující funkce, kterou můžete vložit do functions.php a změnit jazyk brány. Příklad je pro WPML. ``` add_filter( 'gopay_create_payment_lang', 'my_custom_gopay_function' ); function my_custom_gopay_function( $lang ){ //Získáme aktuální jazyk $current_lang = ICL_LANGUAGE_CODE; if( $current_lang == 'en' ){ return 'EN'; }else{ return 'CS'; } } ``` Tato funkce pro zvolenou angličtinu, nastaví dialog platební brány na angličtinu. Pro jiné jazyky bude brána v češtině. ### Změna klientských údajů pomocí filtru Klientskými údaji jsou myšleny Go ID, Client ID a Client secret. Tyto údaje slouží k navázání spojení s Go Pay. Pomocí filtrů můžete ovlivnit jejich volání a můžete je změnit. Je tak možné, mít několik účtů na Go Pay a podle předem definovaných podmínek tyto účty přepínat. My si ukážeme, jak změnit údaje podle toho, jaká dopravní metoda byla použita v objednávce. Samotná definice filtrů vypadá takto: ``` $client_id = apply_filters( ‚gopay_inline_client_id‘, $client_id, $order_id ); $client_secret = apply_filters( ‚gopay_inline_client_secret‘, $client_secret, $order_id ); $goid = apply_filters( ‚gopay_inline_goid‘, $goid, $order_id ); ``` Každý z filtrů kromě hodnoty, obsahuje i id objednávky. Pomoci id objednávky pak můžete získat objekt objednávky a řešit různé případy a podmínky. Příklad je psaný na zjištění id dopravní metody, avšak, pokud použijete stejnou dopravní metodu vícekrát, musíte zjistit i její instance, pomocí $shipping->get_instance_id(); ``` get_items( 'shipping' ); $shipping = array_shift( $shipping ); if( $shipping->get_method_id() == 'flat_rate' ){ return 'my_custom_client_id'; } return $client_id; } add_filter( 'gopay_inline_client_secret', 'toret_change_client_secret', 10, 2 ); function toret_change_client_secret( $client_secret, $order_id ){ $order = wc_get_order( $order_id ); $shipping = $order->get_items( 'shipping' ); $shipping = array_shift( $shipping ); if( $shipping->get_method_id() == 'flat_rate' ){ return 'my_custom_client_secret'; } return $client_secret; } add_filter( 'gopay_inline_goid', 'toret_change_goid', 10, 2 ); function toret_change_goid( $goid, $order_id ){ $order = wc_get_order( $order_id ); $shipping = $order->get_items( 'shipping' ); $shipping = array_shift( $shipping ); if( $shipping->get_method_id() == 'flat_rate' ){ return 'my_custom_goid'; } return $goid; } ``` ### Změna stavu objednávky u zaplacené transakce Plugin při zaplacení transakce uvede objednávku do stavu completed a nebo processing. To podle toho, zda se jedná o virtuální produkt ke stažení (completed), nebo ne (processing). Protože to není vždy žádoucí, obsahuje plugin filtry, které to dokáží ovlivnit. Defince filtrů vypadá takto: ``` $set_status = apply_filters( „gopay_notify_virtual_product_status“, $status, $order ); $set_status = apply_filters( „gopay_notify_normal_product_status“, $status, $order ); ``` Každý z filtrů kromě hodnoty, obsahuje i objekt objednávky. Pomocí objednávky pak můžete řešit různé případy a podmínky. Příklad filtru pro fyzické produkty: ``` add_filter("gopay_notify_normal_product_status", "toret_gopay_custom_paid_status", 10, 2 ); if ( !function_exists( "toret_gopay_custom_paid_status") ) { function toret_gopay_custom_paid_status( $status, $order ) { return "completed"; } } ``` Příklad filtru pro virtuální produkty: ``` add_filter("gopay_notify_virtual_product_status", "toret_gopay_custom_paid_status", 10, 2 ); if ( !function_exists( "toret_gopay_custom_paid_status") ) { function toret_gopay_custom_paid_status( $status, $order ) { return "processing"; } } ``` Filtr vložíte do child šablony, function PHP nebo do vlastního pluginu např. [Toret Boilerplate](https://toret.cz/produkt/boilerplate/). ### Změna stavu objednávky pro zrušenou nebo neplatnou platbu V případě, že nechcete u zrušené nebo neplatné platby používat výchozí stav Cancelled, můžete si pomocí filtru upravit stav na vlastní. ``` add_filter( 'gopay_notify_payment_canceled', 'toret_gopay_set_completed', 10, 2 ); function toret_gopay_set_completed( $status, $order ){ return ‚completed‘; } ``` Místo „completed“ si pak vložte jakýkoliv jiný stav objednávky. ### Filtr pro přidání popisku k jednotlivé platební metodě V případě, že chcete k jednotlivým platebním metodám z pluginu Go Pay přidat popisek, je možné jej přidat pomocí filtru. Příklad filtru: ``` add_filter('toret_gopay_select_description', 'toret_custom_description', 10, 3); if( !function_exists( 'toret_custom_description' ) ){ function toret_custom_description( $text, $Bank Id, $Item Name ){ if( $Bank Id == 'PAYMENT_CARD' ){ $text = 'Card Description'; } if( $Item Name == 'Platba 24' ){ $text = 'Platba 24 Description'; } return $text; } } ``` V příkladu je přidán popisek pro platební metodu Platební karty a Platba 24. Pokud chcete přidat popisek pro jiné platební metody, tak je nutné je ve filtru definovat. Popisek je nutné nastylovat. ### Filtry pro data odesílaná do Go Pay - gopay_inline_order_number - gopay_inline_order_descrition. ## 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 ### Debugování chyb Vzhledem k tomu, že se vždy může něco pokazit, má plugin vestavěný způsob zachytávání chyb. V detailu objednávky, kde se vyskytla chyba, najdete v pravém horním rohu **Go Pay Inline Log, **který se vztahuje pouze na konkrétní otevřenou objednávku. ![Plugin Toret GoPay Inline - debug ](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-debug-1024x217.png "Plugin Toret GoPay Inline - debug ") V přehledu pluginů od Toretu najdete Go Pay Inline log, který obsahuje všechny objednávky najednou. ![Plugin Toret GoPay Inline - debug](https://documentation.toret.cz/wp-content/uploads/2026/05/Plugin-Toret-GoPay-Inline-debug-2-1024x442.png "Plugin Toret GoPay Inline - debug") ### Bohužel vaše objednávka nemůže být zpracována, protože vaše banka/obchodník odmítl transakci. Zkuste platbu provést později, nebo vyberte jinou platební metodu. Hláška znamená, že Váš účet ještě nebyl schválen ze strany Go Pay po platbu kartou. Kontaktujte podporu Go Pay. ### Jak získat GOID a secure key Aby jste mohli využívat platební bránu Go Pay, musíte mít podepsanou smlouvu s poskytovatelem. Následně emailem obdržíte Go ID a Secure Key, které zadáte do příslušných polí nastavení Go Pay platby. ### Co je testovací provoz Po aktivaci platební brány, dostáváte od Go Pay přístup k testovacímu serveru. Před tím, než vám bude umožněno platit pomocí Go Pay, je nutné ověřit správnost implementace. K tomu se využívá testovací prostředí. ### Chyba: IOException: Read timed out – Potíže doručovat HTTP notifikace o změně stavu platby Notifikační url, je adresa, kam vám bude Go Pay zasílat změny stavu plateb. Url si plugin nastavuje sám, v případě nutnosti stačí podpoře Go Pay sdělit, že používáte plugin, jenž využívá Rest API a notifikační url není třeba zadávat. ### Kde je nastavení plateb pomocí Go Pay Nastavení platební brány najdete v administraci WordPressu -> Eshop WooCommerce -> Nastavení -> Pokladna -> Go Pay. Zde musíte správně vyplnit formulář s údaji pro platební bránu. ### Kam vložit licenční klíč Licenční klíč, který jste obdrželi při koupi pluginu, vložte do formuláře v administraci WordPressu-> Nastavení -> WooCommerce Go Pay. Po jeho ověření bude platební metoda přístupná v nastavení eshopu. ### Co znamená výběr platební metody Go Pay umožňuje platit více způsoby, než pouze kartou. Pro umožnění výběru dalších možností, si v administraci nadefinujete všechny způsoby, které chcete povolit. Například, když nepoužíváte Super Cash, v nastavení pluginu ho nepřidáte. ### Chyba Go Pay platby: Scope je prázdné, kontaktujte podporu pluginu Chyba Go Pay platby: Scope je prázdné, kontaktujte podporu pluginu je často doprovázena chybou O:19:“Go PayHttpResponse“:3:{s:28:“Go PayHttpResponseraw Body“;s:63:“SSL certificate problem: unable to get local issuer certificate“;s:10:“status Code“;i:500;s:4:“json“;a:0:{}} Problém je na straně hostingu, kde není na serveru nový kořenový certifikát. ### Po kliknutí na objednat se neotevře okno pro platbu, ale rovnou se zobrazí děkovná stránka Řešení 1 Na stránce pokladny není aktivní https, Go Pay Inline vyžaduje pro své fungování aktivní https. Pokud jej nepoužíváte, doporučujeme na něj přejít nejen na stránce pokladny, ale i na celém webu. Řešení 2 Nejsou zadány odpovídající údaje go Go Pay. Pokud jsou zadány s překlepem, nebo testovací údaje nemají zaškrtnutý test, nedojde k vyvolání platební brány. Zkontrolujte, zda máte vložené správné údaje. Řešení 3 Na e-hopu máte jen jednu sazbu daně, nebo žádnou a v nastavení pluginu je zaškrtnuto EET. V případě, že nepoužíváte více sazeb pro DPH, není třeba zasílat údaje o základech daňových sazeb na Go Pay. Celé nastavení zvládnete z účtu Go Pay a v pluginu tuto volbu vypněte. ### Nezobrazuje se výběr platebních metod Přestože máte v nastavení Go Pay povoleno více platebních metod, stále se zobrazuje jen hlavní, bez možnosti výběru, například PayPalu. Řešení: Zkontrolujte, zda máte vyplněný popis platby. Výběr platebních metodu používá rozšíření popisu platební metody. Pokud nebudete popis používat, je do něj nutné vložit minimálně mezeru. Pak se výběr platebních metod zobrazí. ### SCOPE je prázdné Ujistěte se prosím, že na serveru máte zakázaný open_basedir, se kterým není kompatibilní nastavení API CURLOPT_FOLLOWLOCATION. Pokud je open_basedir aktivní, je třeba ho deaktivovat, nebo upravit kód api. Pokud budete upravovat api, tak je nutné otevřít soubor vendor/mashape/unirest-php/src/Unirest/Request.php, vyhledat CURLOPT_FOLLOWLOCATION a změnit hodnotu na false. Na api v současné době nejsou žádné redirecty, proto by neměl být problém využívat SDK s deaktivovaným CURLOPT_FOLLOWLOCATION. ### Zdvojené faktury a zdvojené odečítání ze skladu Go Pay požaduje o nastavení limitu pro HTTP notifikace do 15 vteřin a tedy jsou v pluginu nastaveny hodnoty pro správné odeslání notifikací. Může se stát , že Go Pay odešle najednou dvě odpovědi, jedna se vrací se zákazníkem na e-shop a druhou odesílá Go Pay sám. Go Pay je schopný poslat notifikace najednou, tedy rozdílem jsou tisíciny vteřiny. Z tohoto důvodu se může stát, že se skript spustí 2x. Na tento problém nefungují žádné zámky, hlídáčky apod., a může dojít k duplicitním fakturám nebo dvojímu odečtení ze skladu. Pokud by plugin vystavoval faktury duplicitně, nebo více odečítal ze skladu, použijte následující filtr pro nastavení delší notifikace. ``` function gopay_sec_count_fce() { return 20; } add_filter( 'gopay_sec_count', 'gopay_sec_count_fce', 10, 0 ); ``` ### V pokladně se nezobrazují loga a checkboxy platebních metod Pokud v pokladně u jednotlivých platebních metod nejsou vidět loga a zaškrtávací checkboxy, tak je blokuje šablona. Problém má snadně řešení úpravou v CSS. Do vlastního CSS vložte níže uvedenou úpravu: ``` .gopay_select input[type=“radio“] {display:initial!important;} /zobrazí zaškrtávací kolečka/.gopay_select img {display:initial!important;} /zobrazí loga/ ``` ### Úprava zobrazení log v blokové pokladně Ve výchozím nastavení se zobrazuje logo nad názvem platební metody. V případě, že chcete mít logo vlevo od textu, můžete to udělat tak, že přidáte níže uvedené CSS. ``` .wc-block-components-checkout-step__content .wc-block-components-radio-control__label-group >span > span { display:flex; } .wc-block-components-checkout-step__content .wc-block-components-radio-control__label-group >span > span img { margin-right:5px; } ```