OpenCart: Instalace a konfigurace GP webpay

Úvod

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

Instalace

Obsah archivu je nutné rozbalit do kořenového adresáře Opencartu a následně do adresáře /gpwebpay/certs/ vložit privátní klíč s příponou *.key vygenerovaný v portálu GP webpay v sekci Správa klíčů a veřejný klíč ze sekce Ke stažení z portálu GP webpay.

Přehled platebních metod naleznete v sekci Extensions – Extensions v levém menu po vybrání volby Payments v rozbalovacím menu Extension list. 

Mezi platebními metodami se zobrazí rozšíření GP webpay, které lze aktivovat pomocí zeleného tlačítka „+“ vpravo a následně konfigurovat modrým tlačítkem se symbolem tužky („Edit“).

Konfigurace

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

• GP webpay URL – adresa platební brány, 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 obchodníka přidělené bankou
• Public key file – veřejný klíč GPE (gpe.signing_test.pem pro testovací prostředí, gpe.signing_prod.pem pro produkční prostředí) uložený v adresáři /gpwebpay/certs/
• Merchant private key file – privátní klíč *.key vygenerovaný v portálu GP webpay a uložený v adresáři /gpwebpay/certs/
• Merchant private key password – heslo k vybranému privátnímu klíči
• Deposit flag – volba určující, zda se má objednávka uhradit (pay), nebo pouze autorizovat bez zaúčtování, ke kterému dojde později na požadavek obchodníka (authorize)
• Gateway 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
• Currency for conversion – pokud není měna produktu podporována na platební bráně, dojde k přepočítání kurzu přes tuto měnu, může zůstat prázdné
• Order state after successful payment – stav, do kterého se má objednávka přepnout po provedení platby
• Geo Zone – nastavení geografické zóny (výchozí hodnota All zones)
• Status – možnost vypnout (Disabled) nebo zapnout (Enabled) modul pro GP webpay
• Sort Order – určení pořadí platebních metod, jak se mají zobrazovat v e-shopu, možno nechat prázdné

Otestování funkčnosti

Po konfiguraci lze přejít k otestování platby. Mezi platebními metodami vyberte platbu kartou online. Po potvrzení dojde k přesměrování na platební bránu 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.