Platební tlačítko ČSOB
Platební tlačítko umožňuje platbu převodem z účtu ČSOB, ke které ale na rozdíl od běžného převodu získává obchodník okamžitou garanci platby (bez ohledu na denní či noční dobu). Z pohledu zpracování platby e-shopem je tak platba tlačítkem velice podobná platbě kartou. V reálném čase získává obchodník informaci o tom, zda byla/nebyla platba autorizována a vypořádání platby na účet obchodníka probíhá následující bankovní den.
Oproti pouhému poskytnutí bankovních údajů k platbě objednávky zákazníkovi (typicky číslo účtu a variabilní symbol) má platební tlačítko ještě jednu nespornou výhodu - inicializace platby probíhá automaticky a zákazník nemá po celou dobu možnost změnit platební údaje (nemůže se tak splést a v platebních údajích udělat chybu).
Používáte-li již nyní eAPI platební brány ČSOB (v jakékoli verzi), je pro vás použití platebního tlačítka velice jednoduché:
- Životní cyklus platby je stejný jako při platbě kartou a tento životní cyklus platby se od verze eAPI 1.0 nezměnil. Veškerá logika e-shopu, odvozená z životního cyklu platby, není přidáním platebního tlačítka jakkoli dotčena. V případě, že jste dosud používali platební tlačítko ČSOB prostřednictvím systému PaySec, můžete PaySec API ze svého systému odebrat a platební tlačítka obsluhovat přes eAPI platební brány.
- Vypořádání transakcí je stejné jako v případě karet. Transakce platebním tlačítkem dostanete i na stejném výpisu.
- Nechcete-li přímo implementovat platební tlačítko do svých stránek, nemusíte technicky na e-shopu dělat nic. Stačí si nechat v bance aktivovat platbu platebním tlačítkem (kontaktujte akceptacekaret@csob.cz) a vaši zákazníci budou moci platbu tlačítkem vybrat na platební bráně.
- Platbu tlačítkem lze zahájit přímo z e-shopu, aniž by zákazník musel jít přes platební bránu. Máte-li již naimplementované eAPI, stačí doplnit implementaci o jedno nové volání (
button/init) dle API specifikace.
Po běžném přesměrování zákazníka z e-shopu na platební bránu si zákazník vybere platební tlačítko jako způsob, kterým chce zaplatit. Po kliku na tlačítko přesměruje platební brána zákazníka do Internetového bankovnictví ČSOB.
Zákazník se přihlásí do elektronického bankovnictví (pomocí uživatelského jména a hesla dle pravidel konkrétního systému s potvrzením SMS kódem nebo aplikací ČSOB Smart klíč. Po přihlášení se zákazníkovi přímo otevře předvyplněný příkaz, ve kterém může změnit jen nedůležité údaje (např. si může k platbě napsat poznámku). Platbu zákazník podepíše SMS kódem, čipovou kartou nebo aplikací ČSOB Smart klíč a následně je automaticky přesměrován zpět na platební bránu. Po vyhodnocení transakce, které trvá několik vteřin, je zákazník přesměrován zpět do e-shopu. Pokud se platba tlačítkem nepovede, zůstává zákazník na platební bráně, kde může zaplatit i jiným způsobem (platební kartou, Apple Pay, Google Pay).
Přímá integrace platebních tlačítek do e-shopu nabízí rychlejší a pohodlnější platbu pro zákazníka. Samotný proces platby v elektronickém bankovnictví je stejný jako v případě platby tlačítkem umístěným na bráně (přesměrování do elektronického bankovnictví, podpis platby a návrat). Samotná platební brána ale do platebního procesu vstupuje pouze na pozadí a zákazník vstupuje do elektronického bankovnictví přímo z e-shopu. Pro implementaci tlačítek přímo do e-shopu je použita nová API metoda button/init. Samotná platební tlačítka pro umístění do e-shopu naleznete společně s logy ostatních platebních metod zde.
Platbu tlačítkem na smartphonu nebo tabletu dokáže zjednodušit aplikace mobilního bankovnictví ČSOB Smart. Platí-li zákazník na mobilním zařízení, nabídne mu brána dokončení platby v běžném elektronickém bankovnictví nebo v aplikaci ČSOB Smart. Platební brána zajistí zpracování platby i přesměrování zákazníka z aplikace ČSOB Smart na návratovou URL, specifikovanou obchodníkem.
Transakce platebními tlačítky, které proběhly v rámci jednoho dne, budou na váš účet obchodníka připsány následující bankovní den. Platby tlačítkem jsou součástí stejných výpisů jako platby karetní. Způsob vypořádání je tedy stejný jako u karet a umožňuje provozovat v e-shopu jen jednu párovací logiku pro všechny platební metody nabízené ČSOB platební bránou.
Návraty plateb se provádějí na běžný účet klienta, ze kterého bylo placeno. Nemusíte je provádět ručně v bance - stejně jako v případě platebních karet se transakce vrací prostřednictvím platební brány a její funkce payment/refund. Vůči jedné transakci můžete poslat více vratek, nicméně vždy jen do výše původní transakce.
Platbu pomocí platebního tlačítka ČSOB přímo z e-shopu bez přesměrování na bránu označujeme dále jako pt@shop. Po kliknutí na platební tlačítko v e-shopu je zákazník přesměrován na Internetové bankovnictví ČSOB. Následně provede přihlášení do IB a potvrdí platbu. Poté je přesměrován na platební bránu ČSOB, kde je provedeno dokončení platby, zobrazení výsledku a následně přesměrování zpět na e-shop obchodníka.
Pro mobilní zařízení je výše popsané chování poněkud odlišné: zákazník je po kliknutí na platební tlačítko přesměrován nejprve na rozcestník na platební bráně, kde má možnost zvolit, zda chce pro provedení platby použít Internetové bankovnictví ČSOB, anebo zda se má otevřít mobilní aplikace ČSOB Smart.
Platební tlačítko se obsluhuje třemi API operacemi:
| operace | popis |
|---|---|
button/init |
získání parametrů pro přesměrování na IB ČSOB nebo na rozcestník pro výběr mezi aplikací ČSOB Smart nebo Internetovým bankovnictvím ČSOB |
Upozornění: autorizované transakce platebním tlačítkem jsou automaticky zaúčtované, nelze volat operaci payment/reverse, pro vrácení je možné použít pouze operaci payment/refund.
Do příslušné části html stránky e-shopu je potřeba vložit odkaz na platební tlačítko ČSOB. Níže uvedený příklad ukazuje linkování české verze tlačítka ČSOB v rozměrech 160x36. Podrobnější popis je uveden v článku věnovaném brandingu platebních metod.
<a href="/my-eshop/payment-button-handler-csob">
<img src="https://platebnibrana.csob.cz/images/pay-csob-cz-160x36.png" alt="Okamžitá platba ČSOB">
</a>
Obchodník si na straně e-shopu implementuje obsloužení kliknutí na příslušné platební tlačítko, ve výše uvedeném příkladu je to endpoint pro GET /my-eshop/payment-button-handler-csob a endpoint pro GET /my-eshop/payment-button-handler-era.
Obchodník zavolá ze serveru e-shopu operaci button/init - je odpovědný za seskládání potřebných parametrů, podpis požadavku, poslání požadavku na platební bránu, následné přijetí odpovědi, ověření podpisu a provedení redirectu přes prohlížeč zákazníka.