Gopay - Integrační test

Vytvořil(a) Jan Záruba, Změněno dne Pá, 2 Srpen v 1:48 ODPOLEDNE dle Jakub Jirsa

☝️ Tato nápověda je určena pouze pro e-shopové řešení JZ SHOP. Více informací na www.jzshop.cz.

Příprava a nastavení integrace

Tento návod je pouze pro starší implementaci GoPay vyžadující notifikační URL. Novější implementace je pomocí REST API, která notifikační URL nepotřebuje.

V případě nové integrace je třeba zadat přístupové údaje GoID, Client secret a Client ID, které obdržíte od platební brány.

Zaslání notifikační adresy integračnímu oddělení GoPay

Pro zahájení integrace Vás integrační oddělení GoPay vyzve k zaslání URL adresy skriptu, jenž přijímá a zpracovává http notifikace o změnách stavu plateb na Vašem e-shopu - tzv. notifikační adresy. Jedná se o dvě URL - pro testovací prostředí a pro produkční prostředí.

Testovací notifikační adresa: http://<url-dema>/payments/gopay/notify.php
Produkční notifikační adresa: http://<vase-domena>/payments/gopay/notify.php

Notifikační adresy najdete v administraci e-shopu, v sekci "Nastavení-> Platební brány", záložka "GoPay".

Po nastavení notifikační adresy pro testovací (http://<demo>.jzshop.cz/payments/gopay/notify.php) a pro produkční prostředí (http://<www.domena.tld>/payments/gopay/notify.php) zašle GoPay e-mail s žádostí provedení integračního testu (Test integrační soupis).

Nastavení v administraci e-shopu:

Nastavte přihlašovací údaje do platební brány v administraci e-shopu, sekce "Nastavení-> Platební brány", záložka "GoPay" - položky GoID a Secure Key
Vytvořte požadované možnosti platby kartou v sekci "Marketing-> Platby". V nastavení platby přiřaďte platební modul např. GoPay.cz -> CS 3DSecure.
Vytvořte požadované možnosti platby SuperCASH v sekci "Marketing-> Platby". V nastavení platby přiřaďte platební modul GoPay.cz -> superCASH.
Spárujte tyto platby s některou dopravou ve Vašem e-shopu. Spárování provedete v sekci "Marketing-> Doprava a Platba", v nastavení dopravy záložka "Platby".
Musí být vytvořeny stavy objednávek přiřazené k typu: platba zrušena, čekání na platbu, platba přijata, chyba při platbě, platbě vypršela platnost (ve výchozím demo obchodě je již nastaveno - pokud jste nezměnili stavy objednávek, můžete pokračovat.)

Testování integrace plateb

POZOR: Následující testování provádějte až po vyzvání ze strany GoPay - tedy v okamžiku, kdy je vše nastaveno. Testy provedené před vyzváním GoPay nebudou funkční!

Provedení testů platby kartou:

V následujících krocích je nutné otestovat funkčnost platební brány ve všech možných situacích, ve kterých se může Váš zákazník ocitnout

Vytvořte objednávku s platbou kartou, po dokončení objednávky klikněte na tlačítko "Zaplatit", po přesměrování na platební bránu klikněte "Zaplatit" v testovacím prostředí.
Poté ověřte v administraci, zda-li byla objednávka změněna do stavu "Zaplaceno".
Vytvořte objednávku s platbou kartou, po dokončení objednávky klikněte na tlačítko "Zaplatit", po přesměrování na platební bránu klikněte "Zrušit" v testovacím prostředí.
Poté ověřte v administraci, zda-li byla objednávka nastavena do stavu "Platba zrušena"
Vytvořte objednávku s platbou kartou, po dokončení objednávky klikněte na tlačítko "Zaplatit", po přesměrování na platební bránu zavřete okno prohlížeče (platba neproběhla).
Po určité době zkontrolujte, zda stav objednávky byl změněn na "Platbě vypršela platnost"

Provedení testů superCASH:

Vytvořte objednávku s platbou typu superCASH, po dokončení objednávky klikněte na tlačítko "Zaplatit", po přesměrování na platební bránu klikněte na "Vygenerovat" a následně "Otevřít PDF" a poté "E-shop"
Nyní přejděte do administrace e-shopu a zkontrolujte stav objednávky, zda byl změněn na "Čekání na platbu".
Přejděte zpět na stránky, kde lze zaplatit v testovacím režimu platbu https://testgw.GoPay.cz/gp-gateways/supercash/gateway.action
Zde zadejte číslo z otevřeného PDF a nyní klikněte "Zaplatit".
V administraci e-shopu zkontrolujte, zda se stav objednávky změnil na "Zaplaceno".

Další testování:

Dále je nutné otestovat veškeré typy platby, které budete na e-shopu využívat (platební metody bank, platby převodem, platby v cizí měně či jiném jazyku).

Ukončení tetování:

Před spuštěním e-shopu do produkčního prostředí (na vlastní doméně) je nutné informovat GoPay o provedení testů a překlopení platební brány do produkčního prostředí. Poté Vám GoPay zašle nové přihlašovací údaje (SMS zprávou), které je nutné zadat do administrace a odškrtnout "Testovací režim". ("Nastavení-> Platební brány", záložka "GoPay" - položky GoID a Secure Key)

Blahopřejeme, Váš e-shop je nyní připraven na přijímání všech online plateb GoPay.