Úvod
Tato dokumentace je určena obchodníkům využívajícím open source platformu WordPress s pluginem WooCommerce a popisuje instalaci a konfiguraci rozšíření pro platební bránu GP webpay.
Instalace
Rozšíření pro GP webpay lze nainstalovat po přihlášení do WordPressu přes záložku Pluginy – Instalace pluginů v hlavním postranním panelu. Na stránce Instalace pluginů je nutné vložit archiv gp-webpay-for-woocommerce.zip pomocí tlačítka Nahrát plugin v horní části obrazovky:
Zobrazí se pole pro vybrání požadovaného souboru. Po jeho vyhledání a kliknutí na Instalovat se zahájí instalace pluginu.
Před samotnou instalací může být uživatel vyzván k zadání hesla k FTP serveru. Toto heslo lze získat u správce serveru.
Konfigurace
Konfigurace se nachází v sekci Pluginy – Přehled pluginů pod GP webpay. Pomocí tlačítka Configure se uživatel dostane k nastavení pluginu.
V nastavení pluginu jsou následující pole:
- Povolit/Zakázat – zapíná a vypíná zobrazování platební metody v e-shopu
- Titulek – název platební metody, který se bude na e-shopu zobrazovat
- Popis – popis platební metody na stránce výběru platebních metod v e-shopu
- GP webpay URL – pro testovací prostředí: https://test.3dsecure.gpwebpay.com/pgw/order.do, pro produkční prostředí: https://3dsecure.gpwebpay.com/pgw/order.do
- Merchant number – číslo e-shopu z e-mailu o založení platební brány nebo z portálu GP webpay
- Soukromý klíč – soukromý klíč *.key vygenerovaný v portálu GP webpay v sekci Správa klíčů, klíč musí být uložený v adresáři /wp-content/plugins/gp-webpay-for-woocommerce/key na FTP serveru
- Heslo k soukromému klíči – heslo k soukromému klíči *.key zadané při jeho vytváření v portálu platební brány v sekci Správa klíčů
- Veřejný klíč – veřejný klíč GPE dostupný v sekci Ke stažení v portálu GP webpay, pro testovací
- prostředí klíč gpe.signing_test.pem, pro produkční prostředí gpe.signing_prod.pem, oba klíče musí být nahrány v adresáři /wp-content/plugins/gp-webpay-for-woocommerce/key na FTP serveru
- Posun čísla objednávky – hodnota, která se přidá za číslo objednávky, aby nedocházelo k duplicitám
Otestování funkčnosti
Jakmile jsou všechna pole vyplněna, lze přejít na vytvoření objednávky a zaplacení pomocí platební brány GP webpay.
Seznam možných chybových scénářů
Po přesměrování na platební bránu mohou být při nesprávné konfiguraci modulu vráceny následující chybové hodnoty:
- PRCODE=3, SRCODE=7 – nepodporovaná měna, nutno zkontrolovat zasílanou měnu u daného produktu a případně změnit, nebo požádat banku o povolení nové měny na platební bráně
- PRCODE=11, SRCODE=0 – obchodník nenalezen, jedná se o chybně zadané číslo obchodníka, nebo není obchodní místo aktivní v systémech GPE
- PRCODE=14, SRCODE=0 – duplicitní číslo objednávky
- PRCODE=31, SRCODE=0 – chybně nakonfigurovaný soukromý klíč v e-shopu nebo chybný klíč na serveru GPE (nutno vložit stejný klíč na server GPE i do e-shopu)
Při testování platební brány na testovacím prostředí je možné použít pouze testovací kartu, při použití reálné produkční karty dojde k chybám níže:
Při nesprávné konfiguraci veřejného klíče může e-shop chybně vyhodnocovat stavy objednávek. Pokud e-shop vyhodnotí úspěšnou platbu jako neúspěšnou, překontrolujte použitý veřejný klíč. Vždy je třeba používat klíč poplatný danému prostředí (pro testovací prostředí klíč gpe.signing_test.pem, pro produkční prostředí gpe.signing_prod.pem).
Právní doložka
Tento dokument včetně všech případných příloh a odkazů je určen výhradně pro potřeby poskytovatele služeb e-shopu (dále jen „Zákazník“).
Informace v tomto dokumentu obsažené (dále jen „Informace“) jsou předmětem duševního vlastnictví a ochrany autorských práv společnosti Global Payments Europe, s.r.o. (dále jen „GPE“) a mají povahu obchodního tajemství v souladu s ust. § 504 zák. č. 89/2012 Sb., Občanský zákoník. Zákazník si je vědom právních povinností ve vztahu k nakládání s Informacemi.
Informace nebo kterákoliv její část nesmí být bez předchozího výslovného písemného souhlasu GPE poskytnuty nebo jakýmkoliv způsobem zpřístupněny třetí straně. Informace nesmí být zároveň využity Zákazníkem pro jiné účely, než pro účely ke kterému slouží. Pro vyloučení všech pochybností nesmí být Informace nebo kterákoliv část bez předchozího výslovného písemného souhlasu GPE poskytnuty nebo jakýmkoliv způsobem zpřístupněny ani společnostem poskytujícím služby zpracování plateb v prostředí internetu.
GPE si v rozsahu dovoleném platným právem, vyhrazuje veškerá práva k této dokumentaci a k Informacím v ní obsažených. Jakékoliv rozmnožování, použití, vystavení či jiné zveřejnění nebo šíření Informací nebo její části metodami známými i dosud neobjevenými je bez předchozího písemného souhlasu společnosti GPE přísně zakázáno. GPE není jakkoliv odpovědná za jakékoliv chyby nebo opomenutí v Informacích. GPE si vyhrazuje právo, a to i bez uvedení důvodu, jakoukoliv Informaci změnit nebo zrušit.
