Úvod
Tato dokumentace je určena obchodníkům využívajícím open source platformu Magento ve verzi 1.x. Dokumentace není kompatibilní s Magento Enterprise Edition.
Instalace
Obsah adresáře app z magento1.zip je nutné nahrát do adresáře app na server pomocí libovolného FTP klienta. Následně je doporučováno vymazat cache v Magento Admin Panelu v sekci System – Cache Management pomocí tlačítka Flush Magento Cache.
Po kliknutí na tlačítko Flush Magento Cache se zobrazí oznámení „The Magento cache storage has been flushed“.
Instalace modulu je tímto dokončena a následuje konfigurace platební metody GP webpay.
Konfigurace
Nastavení platebních metod se nachází v sekci System – Configuration v Magento Admin Panelu:
Nainstalovaný GP webpay modul se nachází v sekci SALES – Payment Methods v levém sloupci:
Po zvolení GP webpay jsou zobrazena 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
- Stav nové objednávky – název stavu, kdy dojde k vytvoření objednávky, ale zatím nedojde k zaplacení
- 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, které se nachází v e-mailu o založení platební brány nebo v 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 portálu GP webpay 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í klíč 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 – akceptované měny dle smlouvy obchodníka s bankou
- Mód – možnost Živě pro odeslání požadavku na platební bránu GP webpay, možnost "Test" pro interní Magento test bez přesměrování na platební bránu
- Informační e-mail – e-mail pro zasílání chybových hlášení z Magenta
- Platby z aplikovatelných zemí – určují, 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 Platby ze specifikovaných zemí
- Pořadí – určení 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 správně nakonfigurována a pole Stav zobrazí „Platební brána je připravena k použití“, lze přejít na vytvoření objednávky a zaplacení pomocí platební brány GP webpay.
Pokud i po nakonfigurování není metoda GP webpay v e-shopu nabízena, je třeba zkontrolovat, zda je pole Povoleno nastaveno na hodnotu Yes a zda je měna u produktu rovněž vybrána v poli Povolené měny.
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.
