Nastavení ČSOB

Po dokončení tohoto návodu budete mít ČSOB připojený k účtu v testovacím režimu, ověříte si testovací platbu kartou od začátku do konce a budete mít jasnou cestu, jak přepnout na ostrý provoz, jakmile budete mít s ČSOB smlouvu.

Jak se ČSOB propojí s Cabintale

Cabintale od vás potřebuje tři věci, které vložíte v Nastavení → Platby:

1. Vaše číslo obchodníka — to vám dá ČSOB.
2. Váš soukromý klíč — ten si vygenerujete (zůstává u vás, nikam ho neposíláte).
3. Veřejný klíč banky ČSOB — soubor, který si od ČSOB stáhnete.

Začnete v testovacím režimu (sandbox ČSOB zdarma, simulované platby) a na ostrý provoz přepnete s oddělenými produkčními klíči, jakmile budete mít smlouvu.

Krok 1: Vygenerujte klíče a získejte číslo obchodníka

1. Otevřete testovací keygen ČSOB: https://iplatebnibrana.csob.cz/keygen/
2. Vygenerujte RSA pár (2048 bitů). Uložte si oba klíče na bezpečné místo — soukromý klíč už znovu nestáhnete.
3. Pomocí tlačítka na stránce odešlete veřejný klíč do ČSOB.
4. ČSOB zobrazí vaše číslo obchodníka — zkopírujte si ho.

Krok 2: Stáhněte veřejný klíč banky ČSOB

1. Otevřete složku s klíči ČSOB: https://github.com/csob/paymentgateway/tree/master/keys
2. Pro testování použijte sandbox klíč: mips_iplatebnibrana.csob.cz.pub.
3. Otevřete ho a zkopírujte jeho obsah — vložíte ho v dalším kroku. (Až půjdete do ostrého provozu, vezmete odsud místo toho produkční klíč.)

Krok 3: Vložte vše do Cabintale

1. V postranní nabídce → Nastavení → Platby → na kartě ČSOB klikněte Nastavit.
2. Nechte režim na Testovací režim.
3. Vyplňte tři pole:
   • Číslo obchodníka — z Kroku 1.
   • Soukromý klíč (PEM) — váš soukromý klíč (začíná -----BEGIN RSA PRIVATE KEY-----).
   • Veřejný klíč banky (PEM) — soubor z Kroku 2.
4. Klikněte Uložit.

Karta ČSOB se teď zobrazí jako připojená a stane se výchozí bránou pro platby na účtu.

Krok 4: Otestujte platbu

1. Zapněte platby u nějakého místa nebo služby (viz Přijímání plateb na ubytování).
2. Udělejte testovací rezervaci ve widgetu a zaplaťte testovací kartou ČSOB — platba i bezpečnostní ověření jsou simulované, žádné skutečné peníze se nehýbou.
3. Rezervace dorazí do správy jako zaplacená.

Krok 5: Přepnutí na ostrý provoz

1. Uzavřete s ČSOB smlouvu na platební bránu — zavolejte na obchodní linku ČSOB 800 150 150 nebo se obraťte na svého obchodního zástupce ČSOB ohledně e-commerce platební brány.
2. Vygenerujte oddělený produkční pár klíčů na https://platebnibrana.csob.cz/keygen/ a oba si uložte.
3. Potvrďte klíč v POS Merchant — https://posman.csob.cz/posmerchant — aby ho ČSOB aktivoval pro ostré platby.
4. Stáhněte produkční veřejný klíč banky ze stejné složky s klíči.
5. V Cabintale → Nastavení → Platby → ČSOB → Nastavení přepněte režim na Ostrý režim, vložte své produkční číslo obchodníka, soukromý klíč a veřejný klíč banky, klikněte Uložit a nastavte ostrý režim jako aktivní.

Řešení potíží

Související návody

• Nastavení platební brány — Platební brány
• Přijímání plateb na ubytování — Přijímání plateb na ubytování
• Refundy a storna — Vrácení a zrušení rezervací