-
Notifications
You must be signed in to change notification settings - Fork 67
Home
➡️ Obsah a jednotlivé články ve wiki najdete v navigačním sloupci po pravé straně
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 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í.
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).
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ů.
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 MasterPass a 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 |
– | – | – | – | ✔️ |
| MasterPass | masterpass/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
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.
- Payment lifecycle
- Integration and API security
- Activation of the production environment
- Test cards and credentials
- API Sunset
- Payment Authentication
- Basic Payment
- OneClick Payment
- Custom Payment
- Apple Pay
- Google Pay
- Collecting partial card payment
- ČSOB Payment Button
- Payment Skip Pay
- API Integration
- Request Signing and Response Signature Validation
- API Methods Overview
- Basic Methods
- Methods for OneClick Payment
- Methods for Apple Pay
- Methods for Google Pay
- Methods for ČSOB Payment Button
- Methods for Skip Pay
- Purchase metadata