Oxid: Instalace a konfigurace GP webpay

Úvod

Tato dokumentace je určena obchodníkům využívajícím platformu Oxid k instalaci modulu platební brány GP webpay. 

Instalace

Obsah archivu je nutné rozbalit na server do adresáře source/modules pomocí libovolného FTP klienta a do adresáře source/modules/gpwebpay/cert/ vložit privátní klíč obchodníka (*.key) vygenerovaný v portálu GP webpay v sekci Správa klíčů a veřejný klíč GPE (*.pem) ze sekce Ke stažení z portálu GP webpay.

Po kliknutí na Extensions – Modules v Oxid eshopu se ve výpisu nainstalovaných modulů objeví GP webpay:

Aktivace se provádí na záložce Overview pomocí tlačítka Activate:

Následně je nutné modul nakonfigurovat na záložce Settings – GP webpay config

Konfigurace

V menu GP webpay config jsou následující pole:

• GP webpay URL – pro testovací prostředí použijte https://test.3dsecure.gpwebpay.com/pgw/order.do, pro produkční prostředí: použijte https://3dsecure.gpwebpay.com/pgw/order.do
• Merchant number – číslo e-shopu, které se nachází v e-mailu o založení platební brány nebo v portálu GP webpay
• Public key filename – jméno souboru s veřejným klíčem GPE (gpe.signing_test.pem pro testovací prostředí, nebo gpe.signing_prod.pem pro produkční prostředí), klíč musí být uložený v adresáři source/modules/gpewebpay/cert/
• Private key filename – jméno souboru se soukromým klíčem (*.key), klíč musí být uložený v adresáři source/modules/gpewebpay/cert/
• Private key password – heslo k soukromému klíči (*.key)
• Transfer type – určuje, zda se má objednávka uhradit (Pay), nebo zda se pouze autorizuje a k uhrazení dojde později (Only authorize)
• First order number (from) – číslo, od kterého se začínají počítat objednávky. Nelze měnit směrem dolů, jelikož by mohlo dojít k duplicitním číslům objednávek.

Otestování funkčnosti

Jakmile jsou všechna pole správně nakonfigurována a uložena tlačítkem Save, lze přejít k otestování objednávky v e-shopu, kde se mezi platebními metodami objeví volba GP webpay. 

OXID e-shop vyžaduje správně nakonfigurované nastavení párování objednávek, aby vše korektně fungovalo. Pokud přesměrování na platební bránu skončí chybou, doporučujeme provést následující úkony.

Zkontrolovat, zda je modul aktivní v Shop Settings – Payment Methods – Main. 

Zkontrolovat zemi doručení v přidělených zemích v Shop Settings – Payment Methods. Na stránce vybrat GP webpay a v záložce Country pomocí tlačítka Assign Countries prověřit vybrané země. 

Zkontrolovat párování plateb k doručování v Shop Settings – Shipping Methods – "volba doručení" – Payment – Assign Payment Methods.

Zkontrolovat akceptované měny v Master Settings – Core Settings. Seznam měn se nachází na záložce Settings – Other settings v poli Add or remove currencies.

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.