O tom, jak by měla vypadat správná integrace platební brány, jsme psali už loni na podzim.

Nestihli jsme ale do článku dát úplně všechno, a proto přicházíme s druhým dílem.

Ukážeme vám v něm, jak zvýšíte počet správně uhrazených plateb přes platební bránu a zároveň zodpovíme nejčastější dotazy, se kterými se na technické podpoře setkáváme.

1) Získání seznamu povolených platebních metod

Základem zvýšení úspěšnosti dokončených objednávek a tím i plateb, je správné rozvržení košíku, ve kterém zákazníkovi nabízíte možnosti pro platbu. Pro správné zobrazení seznamu platebních metod a získání jejich log můžete použít funkcionalitu našeho API, která je uvedena v naší online dokumentaci.

Touto funkcionalitou získáte aktuální seznam kategorií, názvů povolených platebních metod a odkazů na loga. Informace můžete využít při rozdělování platebních metod na vašem e-shopu.

2) Rozdělení platebních metod v košíku

V tomto článku jsme vám prezentovali, jakým způsobem je možné platební metody na vašem e-shopu prezentovat. Nyní se však na konkrétní varianty podíváme detailněji.

a) Přímá varianta

U přímé varianty dochází k výběru platební metody přímo na straně e-shopu, kde má obchodník vypsané veškeré platební metody, které si přeje zákazníkovi nabídnout. Pro snadnější vypsání všech aktivních platebních metod můžete použít výše uvedenou funkcionalitu “Získání seznamu povolených platebních metod pro daný e-shop“.

Po výběru konkrétní platební metody zákazníkem následuje přesměrování na platební bránu GoPay, kde zákazník pouze zadá případné údaje a platbu potvrdí. Jak takové přesměrování vypadá z pohledu vašeho programátora? Celý požadavek na založení platby je popsán v naší dokumentaci.

U přímé varianty dochází k omezení platebních metod na konkrétní založenou platbu a to v parametru "allowed_payment_instruments". Pokud do tohoto parametru váš programátor uvede pouze jednu konkrétní metodu, zákazník na ni bude přesměrován a nebude ji moci na platební bráně GoPay změnit. Příklad na přesměrování pouze s platební metodou platební kartou by tedy byl následovně:

"allowed_payment_instruments":”PAYMENT_CARD”

platební karta přímá varianta

Pro přímé přesměrování zákazníka do internetového bankovnictví (tedy bez interakce zákazníka na platební bráně GoPay), je nutné předat parametry:

"allowed_payment_instruments":”BANK_ACCOUNT”
"allowed_swifts" (tento parametr by obsahoval SWIFT kód jedné konkrétní banky)

Dále je nutné předat objekt “contact”, ve kterém uvedete minimálně parametr “e-mail” (který musí být při platbě vždy potvrzen), to umožní přesměrovat zákazníka do jeho internetového bankovnictví bez iterace na platební bráně.

b) Částečně agregovaná varianta​

U částečně agregované varianty dochází ke zjednodušení výpisu platebních metod. Za předpokladu využití platebních metod Platební karta a Bankovní převod bude požadavek založení platby vypadat následovně:

Platební karta

Dojde k založení platby s parametrem a hodnotou:

"allowed_payment_instruments":”PAYMENT_CARD”

Bankovní převod

Dojde k založení platby s parametrem a hodnotou:

"allowed_payment_instruments":”BANK_ACCOUNT”

Zákazníkovi budou v případě platby bankovním převodem zobrazeny agregované online i offline bankovní převody, viz nastavení platebních metod na e-shopu. Zákazník na platební bráně GoPay zvolí konkrétní banku a platbu dokončí.

gopay bankovní převod

c) Agregovaná varianta​

V případě plně agregované varianty je pro platbu k dispozici jediné tlačítko. Zákazník konkrétní platební metodu zvolí až na platební bráně GoPay, kde mu budou nabídnuty všechny aktivní platební metody e-shopu. Jak platební metody v e-shopu nastavit, najdete v tomto článku.

Pro založení takovéto platby nedochází ze strany e-shopu k upřesnění objektu "payer" v požadavku založení platby. Tím jsou zákazníkovi pro platbu nabídnuty veškeré dostupné platební metody.

gopay platební brána

Důvody, proč a jak správně předávat položky objednávky

U každé platby je nutné korektně předávat jednotlivé položky objednávky, za které je platba přes platební bránu GoPay prováděna. Tyto údaje nám předáváte u každé platby přes API přímo v objektu “items”. Tyto informace jsou následně zákazníkovi zobrazeny pro kontrolu přímo na platební bráně GoPay v záložce objednávka a dále jsou uvedeny v informačním e-mailu se stavem platby. Zákazník tak může provést závěrečnou kontrolu a platbu potvrdit.

3) Nezapomeňte předávat e-mail

Ačkoliv je předávání údajů o zákazníkovi (objekt “payer”) nepovinné, doporučujeme předávat alespoň e-mailovou adresu zákazníka. V případě, že nám e-mailovou adresu zákazníka předáte v požadavku založení platby, bude předvyplněna na platební bráně GoPay. E-mailová adresa je totiž povinný údaj pro dokončení platby a pokud nám jej v požadavku založení platby nepředáte, zákazník bude tento údaj muset zadat ručně na platební bráně GoPay. Pokud e-mailovou adresu zadával už na vašem e-shopu, je to pro něj zbytečný krok, kterému se dá snadno předejít.

4) Předávání jazyka zákazníka na platební bránu

Jazyková lokalizace prostředí je důležitá pro všechny zákazníky, dbejte tedy prosím na to, aby se zákazníkovi na platební bráně GoPay vždy zobrazil jazyk, u kterého je největší pravděpodobnost, že mu bude rozumět.

Logika jazyka platební brány GoPay je následovná:

  • Nejvyšší prioritu má jazyk, který zákazník měnil na platební bráně.
  • V případě, že zákazník nikdy žádnou změnu jazyka neprováděl, má následně přednost jazyk uvedený v požadavku založení platby (jedná se o parametr “lang”).
  • Pokud není jazyk upřesněný v požadavku na vytvoření platby, pak se jazyk nastavuje automaticky podle jazyka prohlížeče zákazníka.

Jestli si nejste jistí, jaký jazyk zákazníkovi upřesnit při platbě, doporučujeme parametr “langnepředávat, aby došlo k poslední uvedené variantě.

5) Zohlednění stavu platby po přesměrování zákazníka zpět na e-shop

Poté, co zákazník platbu dokončí, je přesměrován zpět na váš e-shop, kde by mu měla být zobrazena informace dle aktuálního stavu platby.

Můžete použít následující příklady transakčních textů:

Stav platby „PAID“ (platba uhrazena): „Vaše platba byla úspěšně uhrazena, děkujeme“.

Stav platby „PAYMENT_METHOD_CHOSEN“ (platební metoda vybrána – zatím nedošlo k uhrazení platby): „Čeká se na platbu, platba zatím nebyla uhrazena“.

Stav platby „CREATED“ (platba vytvořena, zákazník platbu zatím nedokončil): „Platba nebyla zatím uhrazena“. Zákazníkovi můžete v takovém případě nabídnout opětovné přesměrování na vytvořenou platbu v tomto stavu (na vygenerovanou "gw_url", kam zákazníka po vytvoření platby přesměrováváte).

Stav platby „CANCELLED“ (zrušena): „Platba byla zrušena“. Zároveň zákazníkovi můžete poskytnout na vašem e-shopu či e-mailem odkaz na novou platbu.

O čem jsme ještě psali

Jak jsme v GoPay vytvořili vlastní aplikaci na ověření identity Před nějakou dobu jsme si vytyčili nelehký cíl - postavit zbrusu nové, modernější a lepší GoPay. Pustili jsme se tedy do kompletního revývoje celého n...
Jak lépe pečovat o své zákazníky? Začátkem října jsme pro naše obchodníky opět pořádali další Online dílnu GoPay, celodenní školení online marketingu v Praze. Jako lektora jsme si p...
GoPay news #září Podzim je v plném proudu a s ním i vydatná porce novinek. Přečtěte si, jaké platební metody jsme byli nuceni zrušit, jakou soutěž jsme si pro vás p...
Máme povolení ČNB pro poskytování PSD2 služeb Trvalo to 20 měsíců, ale výsledek stojí za to. Prošli jsme náročným licenčním řízením České národní banky a získali jsme jako první česká platební ...
Tomáš Veselka

Tom je náš specialista na integraci platební brány a nadšený průzkumník nových technologií. Ve virtuálním životě hraje počítačové hry všeho druhu, v tom reálném rád chodí na procházky a věnuje se airsoftu.