Č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

Přejděte do sekce Platební brány a v řádku u vaší platební brány zvolte ikonu lupy (validace).

Na následující obrazovce klikněte na tlačítko Provést validaci a poté na Odeslat požadavek.

Přepnutí do produkčního provozu

O schválení testovacích transakcí ze strany ČSOB budete informování e-mailem.

Nyní je potřeba vygenerovat nové klíče pro produkční provoz na adrese: https://platebnibrana.csob.cz/keygen/

Zadejte své údaje a klikněte na Generovat klíč.

Po vygenerování klíčů si uložte jak veřejný, tak soukromý klíč. Veřejný klíč následně odešlete do ČSOB pomocí tlačítka Odeslat veřejný klíč do banky.

Pro použití v produkčním prostředí je nutné klíč potvrdit v aplikaci POS Merchant. Přihlaste se do aplikace na adrese: https://posman.csob.cz/posmerchant Upozornění: Přístupové údaje do produkční verze POS Merchant se liší od těch pro testovací prostředí.

Přejděte do sekce Platební brány a v řádku s vaší platební bránou klikněte na ikonku klíče.

Zadejte jednorázový kód, který jste obdrželi po vygenerování klíčů, a potvrďte jej tlačítkem Odeslat.

Nyní přejděte do sekce Nastavení > On-line platby > ČSOB v administraci vašeho e-shopu.

Vypněte Integrační prostředí. Zadejte své ID obchodníka a nahrajte Soukromý klíč pro produkční prostředí, který jste si předtím vygenerovali.

Nastavte příslušné Stavy objednávek, které se mají automaticky použít při úspěšné platbě, neúspěšné platbě nebo po jejím zrušení.