ČSOB platební brána

Modul ČSOB propojuje Rocketoo s platební bránou ČSOB. Umožňuje platby kartou, víceměnové transakce, správu stavů plateb a notifikace přes webhooky.

Modul ČSOB je rozšíření, které umožňuje přímou integraci s platební bránou ČSOB. Umožňuje bezpečné zpracování online plateb kartou, víceměnové transakce a automatické aktualizace stavů objednávek. Je plně integrovaný do administračního rozhraní Rocketoo a podporuje notifikace přes webhooky.

Hlavní funkce modulu

Správa plateb přes ČSOB bránu

Modul zajišťuje automatické vytváření platebních požadavků při dokončení objednávky. Podporuje platby kartami Visa, MasterCard a Maestro a umožňuje transakce v CZK i cizích měnách.

• Automatické vytváření plateb

• Podpora kreditních a debetních karet

• Víceměnové platby (např. CZK, EUR)

• Automatická aktualizace platebního stavu

Práce se stavy objednávek

Modul automaticky aktualizuje stav objednávky podle výsledku platby:

• Úspěšná platba

• Neúspěšná platba (např. zamítnutá karta)

• Zrušená platba zákazníkem

• Vrácená platba (refundace)

Automatizace a synchronizace

Platební požadavky se vytvářejí automaticky. Modul také podporuje webhooky pro zpětné notifikace z ČSOB, díky kterým dochází k okamžité aktualizaci stavu objednávky bez potřeby ručního zásahu.

Propojení brány s e-shopem

Registrace v ČSOB a získání přístupových údajů

Než začnete s implementací, je nutné uzavřít smlouvu s ČSOB a získat přístup k testovacímu (integračnímu) prostředí.

Od ČSOB obdržíte:

• Merchant ID (ID obchodníka) – unikátní identifikátor vaší firmy.

• Privátní klíč – slouží k šifrování a ověřování komunikace s ČSOB.

• Veřejný klíč ČSOB – pro ověření odpovědí od platební brány.

Pro testovací prostředí budete mít jinou sadu údajů než pro produkční.

Nastevení integrace (testovací režim)

Generování testovacích klíčů

Pro generování testovacích klíčů pro integrační prostředí klikněte na níže uvedený odkaz, zadejte Merchant ID a e-mail kontaktní osoby pro technickou implementaci, který je vyplněn ve smluvní dokumentaci.

https://iplatebnibrana.csob.cz/keygen/

Stáhněte si soukromý klíč a veřejný odešlete tlačítkem Odeslat veřejný klíč do banky.

Nastavení modulu

V administraci vašeho e-shopu přejděte do části Nastavení / Online platby a na záložce ČSOB vyplňte následující údaje:

• ID obchodníka (Merchant ID) - nejprve zadejte údaje pro testovací režim.

• Soukromý klíč (Private Key) - i zde zadejte nejdříve privátní klíč pro testovací režim.

• Přepnutí mezi testovacím a ostrým režimem – přepínač Integrační prostředí přepněte do polohy zapnuto.

Provedení testovacích transakcí

Nyní je potřeba provést několik testovacích plateb, abyste měli jistotu, že komunikace mezi vaším e-shopem a platební bránou probíhá správně. V administraci modulu najdete odkazy, přes které můžete tyto transakce rychle spustit.

Doporučujeme otestovat:

• Úspěšně autorizovaná platba – simulujte standardní nákup, aby se ověřila kompletní cesta od odeslání požadavku po přesměrování a notifikaci.

• Uživatelem zrušená platba – kliknutím na „Zrušit“ během procesu platby.

• Expirovaná (zrušená) platba – např. použitím testovací karty se zamítnutím, abyste zjistili, jak systém reaguje při neúspěchu.

• Revertovaná platba – při platbě dojde k přerušení nebo chybě během zpracování transakce. Zákazník sice zahájí platbu, ale ta není dokončena.

Pokud uvedené testovací karty nefungují, jejich aktuální přehled najdete v oficiální dokumentaci ČSOB: https://github.com/csob/paymentgateway/wiki/Test-cards-and-credentials

Po úspěšném dokončení všech testovacích scénářů je potřeba jejich splnění potvrdit v systému ČSOB na adrese: https://iposman.iplatebnibrana.csob.cz/posmerchant