Nacházíte se na stránkách dokumentace pluginu GP webpay, který integruje platební bránu GP webpay do WooCommerce.
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.
Aktivace pluginu
Po instalaci pluginu si otevřete plugin GP webpay, do příslušného pole vložte licenční klíč a ověřte licenci.
![](https://documentation.toret.cz/wp-content/uploads/2024/07/gp-webpay-licence-2.png)
Propojení s GP webpay
Po instalaci a aktivaci pluginu je možné pokračovat s napojením na GP webpay. Pro správnou implementaci GP webpay na váš e-shop budete potřebovat uzavřenou smlouvu s provozovatelem platební brány. V případě, že máte již vše vyřízené, obdržíte od poskytovatele platební brány přístupy do testovacího rozhraní.
Nastavení platební brány najdete v nastavení WooCommerce → Pokladna → GP webpay.
Propojení pluginu s platební bránou
Níže najdete popsané kroky, které potřebujete pro vytvoření, stažení a nahrání klíčů do GP webpay prostředí a do WordPressu.
Nejprve je nutné zprovoznit platební bránu v testovacím módu a provést testovací platby. Po provedení testovacích plateb (číslo testovací karty budete mít v e-mailu nebo ji najdete zde) a úspěšné kontrole za strany GP webpay obdržíte provozní přístupové údaje. Teprve s nimi je možné zahájit ostrý provoz platební brány.
Podrobný návod níže ↓
1. Přihlášení do testovacího prostředí.
Přihlášení najdete na adrese https://test.portal.gpwebpay.com/. Přístupové údaje získáte e-mailem přímo od GP webpay při uzavření smlouvy.
Po přihlášení budete vyzváni k potvrzení údajů a změně vygenerovaného hesla. Na e-mail vám bude zaslán kód pro potvrzení změny.
2. Vytvoření a uložení testovacího klíče
Znovu se přihlaste. Nyní je třeba vygenerovat soukromý klíč.
Soukromý klíč
Vytvoření a nahrání soukromého klíče se skládá z více kroků. Nejprve přejděte do sekce Správa klíčů a klikněte na Vytvořit.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-soukromy-klic-980x265-1-1.png)
V dalším kroku si ke klíči vytvořte libovolné heslo, které si poznamenejte. Budete jej dále potřebovat v účtu GP webpay a při nastavení pluginu viz. Nastavení pluginu.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-1024x436-1-1.png)
Po vytvoření se klíč stáhne do počítače.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-2-1-1.png)
Nyní klíč uložíme do paměti prohlížeče: Vraťte se do sekce Správa klíčů a rozklikněte si e-shop.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-3-980x292-1-1.png)
Poté vložte klíč, který se stáhl do počítače.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vytvoreni-soukromeho-klice-5-1024x450-1-1.png)
Při vkládání soukromého klíče do paměti prohlížeče vyberte možnost Trvale → přes tlačítko Vybrat soubor vložte stažený klíč → vyplňte heslo, které jste si v předchozím kroku vytvořili → vložte klíč tlačítkem.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-woocommerce-gp-webpay-vlozeni-soukromeho-klice-1.png)
Následně je nutné nahrát klíč do adresáře WordPressu. K tomu použijte funkci v nastavení pluginu „Nahrát privátní klíč“ (viz 3. Nastavení pluginu)
3. Nastavení pluginu
![](https://documentation.toret.cz/wp-content/uploads/2024/07/gp-webpay-propojeni-1024x458.png)
Po vytvoření klíče v administraci GP webpay přejděte do nastavení pluginu GP webpay, které najdete ve WooCommerce → Nastavení → Pokladna → GP webpay.
![](https://documentation.toret.cz/wp-content/uploads/2024/07/gp-webpay-nastaveni-1024x511.png)
![](https://documentation.toret.cz/wp-content/uploads/2024/07/gp-webpay-nastaveni-2-1024x407.png)
Pojďme si podrobněji popsat jednotlivé kroky:
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
Titulek – zde si můžete upravit název platební metody tak, jak se bude zobrazovat při výběru platební metody v pokladně
Popis – v tomto poli můžete pro zákazníka popsat instrukce k platbě
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.
Test mód – v tomto checkboxu aktivujete/deaktivuje testovací prostředí
Číslo obchodníka – do tohoto pole zadejte číslo obchodníka, které vám bylo přiděleno společností GP webpay.
Heslo privátního klíče – zde zadáte heslo ke klíči
Nahrát privátní klíč – Přes tlačítko „vybrat soubor“ nahrajete vytvořený soukromý klíč. Cesta k vybranému souboru se zobrazí o řádek níže.
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.
Povolit GP webpay pro země – specifikujte, pro které země bude brána dostupná
Povolit platební metody – nastavte platební metody, které chcete zákazníkovi zobrazit v pokladně
Instrukce – zde napište instrukce k platbě, které se budou zobrazovat na Děkovné stránce a v potvrzovacím e-mailu
Po vyplnění údajů nezapomeňte kliknout na tlačítko Uložit změny.
4. Testovací platby
Po nastavení integrace a nastavení pluginu proveďte testovací platby s testovací platební kartou:
Testovací platba bez autentifikace:
4056070000000016, Exp. 12/33, CVV2 442
5213000000000028, Exp. 12/33, CVV2 365
Testovací platba s autentifikací:
4056070000000008, Exp. 12/33, CVV2 992
5434021016824014, Exp. 12/33, CVC2 277
5. Přechod na produkční prostředí
Po provedení testovacích plateb kontaktujte poskytovatele platební brány na e-mailu gpwebpay@gpe.cz. Po kontrole integrace vám ze strany platební brány bude zaslán e-mail s přístupem do produkčního prostředí. Zde si vytvoříte nový produkční privátní klíč (obdobně jako v kroku 2 pro testovací prostředí).
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-heslo-produkcniho-soukromeho-klice-1024x367-1-1.png)
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-generovani-produkcniho-soukromeho-klice-980x213-1-1.png)
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-vlozeni-produkcniho-soukromeho-klice-1024x447-1-1.png)
Nový privátní klíč budete muset opět nahrát přes nastavení pluginu GP webpay do adresáře WordPressu. V případě, že jste u soukromého klíče zvolili nové heslo, tak do pluginu uložte také nové heslo a poté vypněte checkbox Test v nastavení pluginu. (viz krok 3 Nastavení pluginu)
Automatické načítání stavu plateb
V případě dokončení platby je zákazník přesměrován na děkovnou stránku. Zároveň je předána notifikace o tom, že je objednávka uhrazena a dojde ke změně stavu objednávky na Zpracovává se (u fyzických produktů) nebo na Dokončeno (u virtuálních produktů).
Může se však stát, že zákazník z nějakého důvodu nebyl po uhrazení objednávky přesměrován na děkovnou stránku. V tom případě plugin nemá žádnou informaci od platební brány o tom, že je objednávka uhrazena. Aby nedošlo k tomu, že uhrazené objednávky bez notifikace budou funkcí WooCommerce zrušeny, je nutné nastavit funkci automatického načítání plateb.
Nastavení automatického načítání stavu platby najdete po kartou Toret Plugin → GP webpay.
![Toret GP WebPay – Automatické načítání stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-automaticke-nacitani-stavu-platby-1024x588-1.png)
1) Nastavte počet dní pro zpětnou kontrolu stavů plateb u objednávek, tedy v jakém zpětném časovém horizontu se budou objednávky kontrolovat.
![Toret GP WebPay – nastavení počtu dní pro zpětnou kontrolu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-poctu-dni-pro-zpetnou-kontrolu.png)
2) Pokud nechcete kontrolovat stav platby u všech objednávek, je možné vybrat jednotlivé stavy objednávek, které se z kontroly vyřadí. Rozhodně nedoporučujeme vylučovat stav Čeká na platbu, Selhalo a Zrušeno.
![Toret GP WebPay – nastavení stavů objednávky, které se nebudou kontrolovat](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-stavu-objednavky-ktere-se-nebudou-kontrolovat.png)
3) Nastavení změny stavu objednávky podle stavu platby.
Funkci změny stavu objednávky na základě stavu platby je nutné povolit aktivací checkboxu a uložením.
![Toret GP WebPay – aktivace změny stavu objednávky na základě stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-aktivace-zmeny-stavu-oabjednavky-na-ziklade-stavu-platby.png)
V případě, že chcete po potvrzení úhrady změnit stav objednávky např. na „Zpracovává se“, je třeba jej nastavit u stavu platby „Požadavek na stržení“. Ve stavu platby „Požadavek na stržení“ se bere objednávka jako uhrazená.
![Toret GP WebPay – změna stavu objednávky podle stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-zmena-stavu-objednavky-podle-stavu-platby-1024x407-1.png)
4) Aby se stav plateb aktualizoval podle nastavení z předchozích tří bodů, je nutné na hostingu nastavit URL CRONu, která je uvedená v nastavení u vás na webu. CRON doporučujeme pravidelně spouštět, minimálně 1x za hodinu.
![Toret GP WebPay – nastavení CRONu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-webpay-nastaveni-cronu.png)
Testovací platební karta
Testovací platba bez autentifikace:
- 4056070000000016, Exp. 12/33, CVV2 442
- 5213000000000028, Exp. 12/33, CVV2 365
Testovací platba s autentifikací:
- 4056070000000008, Exp. 12/33, CVV2 992
- 5434021016824014, Exp. 12/33, CVC2 277
Časté dotazy
Chci mít číslování objednávek po sobě jdoucí
Plugin je kompatibilní s Custom Order Numbers for WooCommerce.
Nejde mi propojení, i když jsem zadal vše správně
Zkontrolujte, zda vaše heslo neobsahuje speciální znaky (například < nebo >). WordPress tyto znaky ošetřuje rozložením, což může způsobit neplatné ověření hesla.
V případě hesla se speciálním znakem doporučujeme jeho přegenerování.
PRCODE=3, SRCODE=7: Nepodporovaná měna
Tato chyba vznikne po přesměrování na platební bránu, pokud u GP webpay nemáte aktivní měnu, ve které byla provedena objednávka.
Kontaktujte podporu GP webpay, aby Vám použitou měnu u vašeho účtu povolila.