Úvod
Tato dokumentace je určena obchodníkům využívajícím platformu Magento ve verzi 2.x k nainstalování pluginu pro platební bránu GP webpay. Plugin není kompatibilní s Magento Enterprise Edition.
Instalace
Obsah adresáře Magento2 je třeba zkopírovat na server pomocí ftp klienta do adresáře /app/code/Gpe/GPWebPay/ (chybějící adresáře je nutné vytvořit). Na serveru v adresáři GPWebPay tedy budou složky Block, Controller atp.
Následně je nutné spustit příkaz k updatu modulů v konzoli v kořenovém adresáři Magenta:
php bin/magento setup:upgrade
Pro spuštění příkazu je nutné se přihlásit na server pod uživatele s dostatečnými oprávněními, nebo kontaktovat správce serveru pro spuštění daného příkazu.
Pokud v odpovědi na příkaz obdržíte hlášení „Magento supports PHP 7.1.3 or later“, je nutné příkaz spustit s podporovanou verzí PHP (např. php7.2 bin/magento setup:upgrade).
Modul pro GP webpay je tímto nainstalován.
Konfigurace
Veškerá nastavení se provádí v sekci Stores – Configuration v hlavním admin panelu.
Konfigurace platebních metod se nachází v sekci Sales – Payment Methods:
GP webpay modul naleznete v sekci OTHER PAYMENT METHODS:
Po vybrání platební metody GP webpay se zobrazí následující pole:
- Stav – zobrazuje, zda je platební metoda správně nakonfigurovaná
- Povoleno – určuje, za bude daná platební metoda dostupná na webu e-shopu
- Nadpis – název platební metody, který se bude na e-shopu zobrazovat
- Metoda odeslání – určuje, zda dojde k úhradě (Platba) nebo zda se transakce pouze autorizuje bez stržení prostředků (Autorizace)
- Číslo obchodníka – číslo e-shopu z e-mailu o založení platební brány nebo z portálu GP webpay
- Url – testovací prostředí: https://test.3dsecure.gpwebpay.com/pgw/order.do, produkční prostředí: https://3dsecure.gpwebpay.com/pgw/order.do
- Soukromý klíč obchodníka – soukromý klíč *.key vygenerovaný v administraci platební brány v sekci Správa klíčů, klíč musí být uložený v adresáři var/gpwebpay na FTP serveru
- Heslo k soukromému klíči obchodníka – heslo k soukromému klíči *.key zadané při jeho vytváření v sekci Správa klíčů
- Veřejný klíč GP webpay – veřejný klíč GPE dostupný v sekci Ke stažení v portálu GP webpay, pro testovací prostředí: gpe.signing_test.pem, pro produkční prostředí: gpe.signing_prod.pem, oba klíče musí být uloženy v adresáři var/gpwebpay na FTP serveru
- Povolené měny – požadované měny dle smlouvy obchodníka s bankou
- Informační e-mail – e-mail pro zasílání chybových hlášení z Magenta
- Payment From Applicable Countries – určuje, zda obchodník přijímá platby z celého světa, nebo pouze ze specifických zemí, které lze následně vybrat v poli Payment From Specific Countries.
- Sort Order – v tomto poli lze určit pořadí platebních metod, jak se mají zobrazovat v e-shopu, možno nechat prázdné
Otestování funkčnosti
Jakmile jsou všechna pole vyplněna, stav se změní na „Platební metoda je připravena k použití“ a 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.
