GoPay platební brána test: jak ověřit integraci v sandboxu

Test integrace GoPay proběhne v odděleném testovacím prostředí (sandboxu), kde se platí fiktivními penězi a testovacími kartami. Stačí v e-shopu nebo aplikaci přepnout adresy a přihlašovací údaje na sandbox, projít základní scénáře plateb a ověřit, že se stavy správně propisují k objednávkám. Článek je určen provozovatelům e-shopů a vývojářům, kteří GoPay napojují. Není to recenze služby.

Co potřebujete před zahájením testování GoPay

Pro přístup k API potřebujete tři údaje: GoID, ClientID a ClientSecret. GoPay je přiděluje zvlášť pro sandbox a zvlášť pro produkci, takže si je nesmíte splést. Postup, jak testovací přístupy získat, a jejich podmínky ověřte přímo u GoPay nebo v jeho dokumentaci, případně u dodavatele vašeho e-shopového řešení.

Dále si připravte:

• funkční e-shop nebo aplikaci s možností vytvořit objednávku a zaplatit ji,
• veřejně dostupnou adresu (notification_url), na kterou bude GoPay posílat oznámení o změně stavu platby,
• případně SDK pro váš jazyk. SDK jen volá API a prostředí se v něm určuje parametrem gateway_url.

Jak funguje testovací prostředí GoPay

Veškeré operace v testovacím prostředí se provádějí s fiktivními penězi. Obchodník ale musí zajistit, aby se na testovací rozhraní brány nedostali jeho skuteční zákazníci. Testování lze provádět z libovolné domény. Prostředí je standardně omezené, takže některé platební metody, například Apple Pay, v něm nelze simulovat.

Sandbox a produkce se liší adresami:

Pokud máte na serveru omezený odchozí provoz nebo firewall, ověřte si v aktuální dokumentaci GoPay, jaké IP adresy testovací prostředí používá. Starší návody je uvádějí, ale mohly se změnit.

Testovací platební karty a scénáře plateb

Testovací karty GoPay jsou uvedeny v tabulce na testovacím serveru GoPay. Najdete tam karty pro ověření 3DS v1 i EMV 3DS 2.2.0 s různým výsledkem ověření. Za příklady čísel, která se v souvislosti s testováním uvádějí, lze považovat 4570492345210000, 5555555555554444 nebo 4444444444444448. Která karta vede k jakému výsledku, si vždy ověřte v aktuální tabulce, protože ta je závazná.

Na dvě věci je dobré pamatovat:

• Výsledek autorizace závisí na použité částce. Stejná karta se může při různých částkách chovat různě, proto částky při testech měňte a zaznamenávejte si je.
• Jako CVV/CVC lze zadat jakékoli tři číslice.

Scénáře, které stojí za otestování

1. Úspěšná platba kartou: objednávka se po návratu na e-shop označí jako zaplacená.
2. Zamítnutá platba kartou: zákazník dostane srozumitelnou zprávu a může platbu zopakovat.
3. Zrušená platba: vyberte online bankovní tlačítko, po přesměrování na testovací formulář zvolte možnost zrušit.
4. Vypršená platba (TIMEOUTED): po přechodu na bránu okno prostě zavřete. Změna stavu nastane po 1 hodině a propíše se automatickou HTTP notifikací.
5. 3DS ověření s různým výsledkem, pokud to testovací karty umožňují.

Ověření notifikací a stavů platby ve vašem systému

GoPay posílá asynchronní HTTP GET notifikaci na vaši notification_url při každé změně stavu platby, s výjimkou stavů CREATED a PAYMENT_METHOD_CHOSEN. Notifikace obsahuje pouze parametr id platby. Samotný výsledek v ní není, takže musíte zavolat dotaz na stav platby přes API a podle odpovědi aktualizovat objednávku.

Co při testu zkontrolovat:

• e-shop notifikaci přijme a odpoví HTTP 200,
• při zpracování skutečně zavolá API pro zjištění stavu platby,
• stav objednávky odpovídá stavu platby u GoPay (zaplaceno, zrušeno, vypršelo),
• opakovaná notifikace stejné platby nevytvoří duplicitní akci, například druhé odeslání zboží,
• objednávka se správně aktualizuje i tehdy, když se zákazník po zaplacení nevrátí na váš web.

GoPay doporučuje zadat testovací údaje do e-shopového systému, provést testovací platby za objednávky z pohledu zákazníka a zkontrolovat, že se stavy plateb správně propisují k objednávkám. Tak to také dělejte: nespoléhejte jen na přesměrování zákazníka zpět, ale ověřujte i notifikace.

Typické chyby při testování a jak je řešit

Přechod z testovacího do ostrého provozu

Produkční režim je zpřístupněn po provedení nezbytných testů a podpisu smlouvy. Jaké konkrétní scénáře GoPay před schválením kontroluje, si ověřte u něj nebo v jeho aktuální dokumentaci. Při samotném přechodu:

1. vyměňte přístupové údaje za produkční (GoID, ClientID, ClientSecret),
2. změňte adresu API na
3. ve formulářích a ve skriptu embed.js nahraďte gw.sandbox.gopay.com za gate.gopay.cz,
4. zkontrolujte, že notification_url ukazuje na ostrý e-shop,
5. provedte ostrou platbu.

Testovací karty už v produkci použít nelze. Ostrou platbu proto ověřte vlastní kartou na nízkou částku, například 10 Kč. Pak zkontrolujte, že objednávka získala správný stav, notifikace dorazila a platba je vidět v administraci GoPay. Metody, které sandbox nepodporuje, jako Apple Pay, otestujte také až nyní.

Než e-shop pustíte do ostrého provozu, projděte v testovacím režimu každý scénář platby, včetně zrušené a neúspěšné, ne jen tu úspěšnou.

Vývojář e-shopů

Smluvní a technické podmínky se mohou lišit podle typu vašeho obchodu. Při nejasnostech se obraťte na podporu GoPay nebo na dodavatele svého e-shopu.