OsCommerce: Instalace a konfigurace GP webpay

Úvod

Tato dokumentace je určena obchodníkům využívajícím platformu Oscommerce pro implementaci platební brány GP webpay.

Instalace

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

Instalace se provádí v administraci Oscommerce na stránce Modules – Payment pomocí tlačítka Install Module: 

V seznamu modulů k instalaci vyberte GP webpay – Pay online by credit card a klikněte na Install module.  

Následně je třeba vrátit se zpět do Modules – Payment, kde se zobrazí nově nainstalovaný modul GP webpay – Pay online by credit card. V seznamu nainstalovaných modulů vyberte nainstalovaný modul a klikněte na Edit.

Konfigurace

V nabídce konfigurace se nachází následující pole:

• Enable GP webpay Module – zapnutí či vypnutí modulu
• Payment Zone – zóna, ve které modul operuje (pokud není zóna vybraná, funguje modul bez omezení)
• Set Order Status – stav objednávek s úspěšnou platbou
• Merchant number – číslo e-shopu, které se nachází v e-mailu o založení platební brány nebo v portálu GP webpay
• Deposit flag – určuje, zda se má objednávka uhradit (1), nebo zda se pouze autorizuje a k uhrazení dojde později na požadavek obchodníka (0)
• Private key file – jméno soukromého klíče (*.key) v adresáři includes/modules/payment/gpwebpay/cert/ (např. gpwebpay-pvk.key)
• Private key password – heslo k soukromému klíči
• Public key file – jméno veřejného klíče GPE (*.pem) v adresáři includes/modules/payment/gpwebpay/cert/ (gpe.signing_test.pem pro testovací prostředí, gpe.signing_prod.pem pro produkční prostředí)
• GP webpay URL – URL adresa platební brány (https://test.3dsecure.gpwebpay.com/pgw/order.do pro testovací prostředí, https://3dsecure.gpwebpay.com/pgw/order.do pro produkční prostředí)
• Order number offset – čí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, lze přejít k otestování objednávky v e-shopu. Jako platební metodu vyberte GP webpay - platba online kreditní nebo debetní kartou a po potvrzení objednávky dojde k přesměrování na platební bránu.

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.