Integrace platební brány je jedním z nejdůležitějších kroků, který před spuštěním brány není radno podcenit.

Správně vyladěná integrace vám zajistí nejen hladký průběh objednávek, ale hlavně vám ušetří čas se správou platební brány.

Bohužel se dnes a denně setkáváme s chybami, které vás o objednávky zbytečně připravují. Není totiž nic horšího, než když nesprávně provedená integrace platební brány a celého procesu platby odvede vaše zákazníky nenávratně pryč.

Na co si při integraci dávat pozor a jak nejčastějším chybám předcházet?

1) Řádně testujte

Testování je nedílnou součástí procesu integrace platební brány. To, že na tuto část klademe možná až velký důraz, má své opodstatnění.

Pro účely testování je zřízeno testovací prostředí (sandbox), které nabízí široké možnosti testování – nachází se zde dokonce více funkcionalit, než v provozním (tedy ostrém) prostředí. To vám dává možnost si svůj e-shop vyladit už v beta verzi, než jej spustíte naostro.

Využijte proto tuto možnost a celou integraci perfektně odlaďte již ve fázi vývoje e-shopu.

2) Předávejte nám všechny důležité informace

Používáte pro svůj e-shop už předpřipravené (tzv. krabicové) řešení? Sdělte nám prosím tuto informaci už na začátku spolupráce, abychom věděli, že integraci máte vyřešenou přes konkrétního dodavatele e-shopového řešení. Ušetříte si tak spoustu cenného času při komunikaci s námi.

certifikovaný dodavatel gopay

Naši certifikovaní dodavatelé e-shopového řešení splňují všechna námi doporučená best practices – můžete si tak být jisti, že integrace bude otestována a odladěna za vás. Seznam dodavatelů, se kterými spolupracujeme, najdete tady.

3) Používejte správné údaje platební brány

Na začátku spolupráce vám vždy poskytneme potřebné testovací údaje pro testování. Poté, co úspěšně testování provedete, pošleme vám provozní údaje pro reálné prostředí platební brány.

testovací integrační soupis

Testovací integrační soupis obsahuje průvodce testováním včetně testovacích údajů

Nezapomeňte, že testovací a provozní údaje se vždy liší!

provozní údaje

Ukázka provozních údajů

Nesprávně použité, či špatně opsané údaje (roli hraje i jediný chybný znak), způsobí kompletní nefunkčnost platební brány ve vašem e-shopu.

Odlišujte tedy pečlivě mezi údaji platební brány, které jsou hlavním klíčem k funkčnosti.

4) Dbejte na správná URL adres našeho API

Stejně jako s testovacími a provozními údaji, je nutné odlišovat mezi testovacími a provozními URL API platební brány, na které jsou requesty posílány.

Testovací údaje je tak možné použít pouze ve spojení s testovací URL platební brány GoPay. Obdobně je to s provozními údaji – jejich funkčnost je zaručena pouze ve spojení s provozní URL API platební brány.

API URL

Typická vrácená chybová hláška při nesprávném použití údajů je:

[{„scope“:“G“,“error_code“:202,“error_name“:“AUTH_WRONG_CREDENTIALS“,“message“:“Wrong credentials. Try sign in again.“}]

Dbejte tedy pečlivě na zadané údaje platební brány a stejně tak na URL, kam request odesíláte.

Vyznat se v potřebných parametrech vám pomůže naše dokumentace.

5) Hlídejte si aktuálnost SSL certifikátu

Aby byly platby co nejvíce bezpečné, používá naše platební brána pro komunikaci vždy HTTPS protokol. Ten je provozován díky SSL certifikátům, které jsou vydány důvěryhodnými certifikačními autoritami a splňují ty nejpřísnější bezpečnostní kritéria.

Každý certifikát je však vydán pouze na dobu určitou a po skončení jeho platnosti je nutné jej obnovit.

SSL certifikát

Pokud váš e-shop (potažmo webserver, webhosting) nebude akceptovat náš SSL certifikát, nebude možné se s API platební brány spojit, a zákazník kvůli tomu nebude moci dokončit platbu za svou objednávku.

Obecně doporučujeme ze strany vaší implementace akceptovat celou certifikační autoritu, která daný SSL certifikát vydala, než se upínat na koncový certifikát dané URL, který má platnost výrazně nižší (typicky v řádu 1 roku). Předejdete tím tak komplikacím spojených s pravidelnou obměnou našich SSL certifikátů.

Nepodceňte proto správu SSL certifikátů na vašem řešení.

6) Vyhněte se špatným stavům plateb

Nejeden obchodník již řešil problém, kdy zákazník tvrdí, že platbu dokončil, ale e-shop říká “NEZAPLACENO”. Opačným extrémem je pak objednávka označena jako “ZAPLACENA” a to bez provedení platby zákazníkem. Ano, i tyto situace se bohužel vyskytují a je nepříjemné je řešit.

Automatizované propisování stavů plateb do databáze e-shopu probíhá na základě námi zasílaných HTTP notifikací o změnách stavů plateb. To zajišťuje, že se stavy platby aktualizují bez nutného manuálního zásahu. Vy tak vidíte, kterou objednávku již můžete expedovat a kterou ještě nikoliv.

Problémy se stavem platby je tak vhodné ověřit několika způsoby. Pokud zákazník tvrdí, že platbu provedl, je vhodné si vyžádat potvrzení o zaplacení přímo od jeho banky. Toto je možné provést na kliknutí v internet bankingu, případně postačí screenshot stržené transakce.

Dále je možné stavy plateb kontrolovat v rozhraní vašeho GoPay obchodního účtu. Stane se, že zákazník vytvoří více plateb ke shodnému ID objednávky. E-shop si s takovou situací nemusí poradit. V GoPay obchodním účtu však máte k dispozici všechny platby a stejně tak jejich aktuální stavy.

Závěr

V článku jsme vypsali ty nejčastější chyby, se kterými se denně setkáváme. Chybám v integraci dále můžete předcházet také tím, že si pozorně projdete dokumentaci k našemu API a budete dbát na správný zápis všech povinných parametrů a itemů.

Abyste měli co nejvyšší počet objednávek, je třeba kromě správné integrace platební brány vyladit i proces košíku. Co se týče uživatelské přívětivosti košíku, dobře funguje i taková zdánlivá maličkost, jako je přehledné a logické seřazení platebních metod ve výběru platby v e-shopu. Jak na to se můžete dočíst v tomto článku.

V případě jakýchkoliv nejasností či potíží při integraci jsme vám k dispozici každý všední den od 8 do 17 hodin na e-mailu integrace@gopay.cz.

Důležité odkazy

Online dokumentacehttps://doc.gopay.com/cs/

SDKhttps://github.com/gopaycommunity

Domovská stránka integracehttps://www.gopay.com/cs/integrace.html

Nápověda pro integraci: https://help.gopay.com/cs/s/hy

O čem jsme ještě psali

Roman Valenta

Roman je mistr přes integraci platební brány. Radí a pomáhá programátorům a kontroluje, jak GoPay integrovali. Když má čas, rád se projede na kole. Jeho vášní i slabostí zároveň jsou sportovní kombi Ford.