Home

Vítejte ve wiki platební brány ČSOB!

---

⚠️ Aktualita: Provoz platební metody MasterPass byl globálně ukončen dne 31.10.2020. Proto i platební brána ČSOB již platební metodu MasterPass nenabízí. Více informací o ukončení najdete zde.

---

➡️ Obsah a jednotlivé články ve wiki najdete v navigačním sloupci po pravé straně

Novinky ve verzi platební brány 1.8

img/assets/apple_pay_mark.png

Apple Pay je možné používat nejen jako NFC platbu telefonem nebo hodinkami, ale i online. Platební brána umožňuje integrovat Apple Pay přímo do vašeho e-shopu. Zákazník na iPhonu, iPadu nebo při nákupu z Macu v Safari neopouští při platbě e-shop, celá komunikace s Apple Pay a následně i platební bránou se odehraje na pozadí. Apple Pay funguje jak v nativních aplikacích na iOS, tak v browseru. Chcete-li zákazníkům Apple Pay nabídnout, přečtěte si prosím detailnější informace o funkci Apple Pay na webu a v aplikacích. Nové API funkce pro Apple Pay jsou pak technicky popsány zde.

---

img/assets/MallPay-logo-web.png

Chcete vašim zákazníkům dát možnost vyzkoušet si zboží a zaplatit za nákup až za dva týdny? Na platební bráně můžete nyní používat i odloženou platbu Mall Pay, která za vás vyřeší odloženou splatnost (úhradu dostanete za dva až tři dny od doručení zboží zákazníkovi, zatímco zákazník platí za dva týdny) a přebírá i riziko nezaplacení zákazníkem. Máte-li o Mall Pay zájem, přečtěte si více informací o platbě Mall Pay, technickou specifikaci nových API metod pro Mall Pay a kontaktujte obchodního zástupce, který vám připraví novou smlouvu na Mall Pay.

---

Platba na míru

Platba na míru umožňuje zaplatit na platební bráně i takové nákupy, při kterých zákazník neprochází typickým procesem nákupu na e-shopu. Obchodník platbu založí na platební bráně, získá platební odkaz, který pak doručí zákazníkovi tím způsobem, který je aktuálně nejlepší: e-mailem, smskou, nebo jako QR kód vytištěný na faktuře. Po otevření platebního linku může zákazník zaplatit všemi platebními metodami, které má obchodník na platební bráně aktivní.

---

SHA-256 podpis API požadavků a odpovědí brány

eAPI v1.8 nově používá pro podpis komunikace mezi obchodníkem a platební bránou algoritmus SHA-256 (na místo SHA-1 používaného v eAPI v1.0 až v1.7).

---

Detailní mikrostavy pro platební metodu Mall Pay

Pro novou platební metodu Mall Pay platební brána vrací detailnější stavy transakce, než jsou základní stavy v životním cyklu transakce. V následujících API releasech budou tyto mikrostavy rozšířeny i na všechny ostatní platební metody. Mikrostavy lze použít pro získání detailnější informace například o pohybu zákazníka v platebním procesu (u stavu 2 - platba probíhá) nebo o konkrétním důvodu zamítnutí platby (ve stavu 6 - platba zamítnuta). Seznam a význam aktuálně podporovaných mikrostavů najdete v přehledu mikrostavů.

---

Podporované verze eAPI

Nové eAPI je současnost a zároveň budoucnost komunikace mezi obchodníkem a platební bránou. Než začnete bránu do vašeho e-shopu nebo mobilní aplikace eAPI integrovat, podívejte se prosím na kompletní dokumentaci k eAPI mezi e-shopem a bránou a návod jak simulovat různé transakční stavy a jaké používat testovací karty.

V současné době jsou podporovány verze 1.0, 1.5, 1.6, 1.7 a 1.8 (podpora verze 1.0 bude v červnu 2020 ukončena). Novinky ve starších verzích eAPI a archiv dokumentace verzí starších než v1.8 najdete zde.

Verze eAPI	Uvedeno	Nedoporučeno	Ukončeno	Nové funkce a změny
v1.0	06/2015	10/2018	06/2020	Výchozí verze při spuštění nové platební brány do provozu.
v1.5	10/2015	08/2019	n/a	Přidává opakovanou platbu (registraci a její následné provedení), umožňuje provedení částečné vratky transakce.
v1.6	04/2016	08/2019	n/a	Přidává datum zaúčtování (extension), umožňuje nastavit životnost transakce na bráně a možnost multibrandingu na jednom Merchant ID (více barevných schémat, logotypů).
v1.7	01/2017	08/2019	n/a	Přidává podporu platebních tlačítek ČSOB a ERA (jako náhradu systému PaySec). Paralelně je spouštěna podpora EET, která je dostupná v eAPI 1.6 a vyšším.
v1.8	10/2019	n/a	n/a	Přidává podporu Apple Pay, Mall Pay, Platby na míru, mění algoritmus podpisu na SHA-256 a přidává povinnost předávat klientskou IP adresu při OneClick platbě. V rámci operace payment/init byl zrušen parametr description (mění se tím i výpočet podpisu).

Při nové implementaci doporučujeme vždy zvolit nejnovější dostupnou verzi API.

Funkce	Volání	v1.0	v1.5	v1.6	v1.7	v1.8
Založení platby	payment/init	✔️ 1	✔️ 1	✔️	✔️	✔️
Opakovaná platba	payment/recurrent	–	✔️	–	–	–
Platba na klik	oneclick/init	–	–	✔️2	✔️2	✔️
Apple Pay	applepay/init	–	–	–	–	✔️
Platba na míru	payment/init	–	–	–	–	✔️
Mall Pay	mallpay/init	–	–	–	–	✔️
Platební tlačítko ČSOB	button/init	–	–	–	✔️3	✔️
Platební tlačítko Poštovní spořitelny	button/init	–	–	–	✔️3	✔️
Zjištění stavu platby	payment/status	✔️	✔️	✔️	✔️	✔️
Odvolání transakce	payment/reverse	✔️	✔️	✔️	✔️	✔️
Zařazení transakce do zúčtování	payment/close	✔️ 4	✔️	✔️	✔️	✔️
Žádost o vrácení transakce	payment/refund	✔️ 5	✔️	✔️	✔️	✔️
Kontrola brány	echo	✔️	✔️	✔️	✔️	✔️
Kontrola zákazníka	echo/customer	✔️6	✔️6	✔️6	✔️6	✔️
Hlášení tržby EET	rozšíření	–	–	✔️	✔️	✔️

1) neumožňuje nastavit životnost transakce (pouze default 30 min), nepodporuje multibranding

2) od eAPI 1.8 byla operace payment/oneclick/init přejmenována na oneclick/init

3) od eAPI 1.8 byla operace payment/button přejmenována na button/init

4) eAPI 1.0 umožňuje zaúčtování jen v plné výši, eAPI 1.5, eAPI 1.6, eAPI 1.7 a v1.8 pak i zaúčtování na menší částku

5) eAPI 1.0 umožňuje návrat jen v plné výši, eAPI 1.5, eAPI 1.6, eAPI 1.7 a v1.8 pak i částečný refund

6) od eAPI 1.8 byla operace customer/info přejmenována na echo/customer

Chcete si jen zkusit, jak brána funguje?

Pro integraci a otestování napojení e-shopu na eAPI platební brány je pro obchodníka k dispozici integrační prostředí (tzv. iBrána) bežící na adrese https://iapi.iplatebnibrana.csob.cz. iBrána není nic jiného než pískoviště otevřené na hraní - bez smlouvy a komplikací. Dokumentaci i nástroj pro generování šifrovacích klíčů najdete tady na Gitu a můžete si naši platební bránu vyzkoušet ihned.

V tomto prostředí je 3DS autentizace a vlastní autorizace plateb prováděna oproti simulátoru (takže prosím používejte tyto karty), nicméně samotná funkcionalita platební brány včetně eAPI a uživatelského rozhraní je identická s produkčním prostředím. Můžete si tak otestovat nejenom vlastní přechod z e-shopu na platební bránu a zpět (předávání parametrů pomocí API) ale i finální vzhled platební brány - zobrazení loga obchodníka a jeho kontaktních údajů, zobrazení košíku a barevného schématu.