Po dokončení tohto návodu budete mať ČSOB pripojenú k svojmu účtu v testovacom režime, fungujúcu testovaciu platbu kartou od začiatku do konca a jasný postup, ako prepnúť na ostrý režim, keď budete mať zmluvu s ČSOB.
Čo budete potrebovať
- Účet v Cabintale.
- Na vyskúšanie: nič ďalšie – testovacie prostredie ČSOB je otvorené pre každého, bez zmluvy.
- Na spustenie naostro neskôr: zmluvu o platobnej bráne s ČSOB (obchodná linka 800 150 150) a prístup do portálu POS Merchant od ČSOB.
- Asi 15 minút.
- ČSOB pripojenú na úrovni účtu, pripravenú pre ľubovoľné ubytovanie
- Fungujúcu testovaciu platbu kartou od začiatku do konca (simulovanú, bez skutočných peňazí)
- Jasný, samostatný postup na prepnutie na ostrý režim, keď bude zmluva pripravená
Ako sa ČSOB pripája ku Cabintale
Cabintale od vás potrebuje tri veci, ktoré vložíte do Nastavenia → Platobné brány:
- Vaše ID obchodníka – dostanete ho od ČSOB.
- Váš súkromný kľúč – vygenerujete ho vy (ostáva u vás; nikdy ho neopustí).
- Verejný kľúč banky od ČSOB – súbor, ktorý si stiahnete od ČSOB.
Začínate v testovacom režime (bezplatné testovacie prostredie ČSOB, simulované platby) a na ostrý režim prepnete so samostatnými produkčnými kľúčmi, keď budete mať zmluvu.
Krok 1: Vygenerujte kľúče a zistite ID obchodníka
- Otvorte testovací generátor kľúčov ČSOB: https://iplatebnibrana.csob.cz/keygen/
- Vygenerujte 2048-bitový pár RSA. Uložte oba kľúče na bezpečné miesto – súkromný kľúč si neskôr už nestiahnete.
- Pošlite verejný kľúč ČSOB tlačidlom na tejto stránke.
- ČSOB zobrazí vaše ID obchodníka – skopírujte si ho.
Krok 2: Stiahnite verejný kľúč banky od ČSOB
- Otvorte priečinok s kľúčmi ČSOB: https://github.com/csob/paymentgateway/tree/master/keys
- Na testovanie vezmite kľúč pre testovacie prostredie:
mips_iplatebnibrana.csob.cz.pub. - Otvorte ho a skopírujte jeho obsah – vložíte ho v ďalšom kroku. (Pri spustení naostro si namiesto toho stiahnete produkčný kľúč z rovnakého miesta.)
Krok 3: Vložte všetko do Cabintale
- Bočné menu → Nastavenia → Platobné brány → na karte ČSOB kliknite na Nastaviť.
- Režim nechajte na Test.
- Vyplňte tri polia:
- ID obchodníka – z kroku 1.
- Súkromný kľúč (PEM) – váš súkromný kľúč (začína
-----BEGIN RSA PRIVATE KEY-----). - Verejný kľúč banky (PEM) – súbor z kroku 2.
- Kliknite na Uložiť.
Vaša karta ČSOB sa teraz zobrazí ako pripojená a stane sa predvolenou bránou účtu pre platby.
Krok 4: Vyskúšajte platbu
- Zapnite platby pri ubytovaní alebo službe (pozrite Prijímanie platieb pri ubytovaní).
- Vytvorte testovaciu rezerváciu vo svojom widgete a zaplaťte testovacou kartou ČSOB – platba aj bezpečnostné overenie sú simulované, žiadne skutočné peniaze sa nepresúvajú.
- Rezervácia príde do vašej administrácie ako zaplatená.
Krok 5: Spustite naostro
- Podpíšte zmluvu o platobnej bráne s ČSOB – zavolajte na obchodnú linku ČSOB 800 150 150 (Česká republika) alebo sa u svojho obchodného kontaktu v ČSOB opýtajte na platobnú bránu pre e-commerce.
- Vygenerujte samostatný produkčný pár kľúčov na https://platebnibrana.csob.cz/keygen/ a uložte oba kľúče.
- Potvrďte kľúč v POS Merchant – https://posman.csob.cz/posmerchant – aby ho ČSOB aktivovala pre ostré platby.
- Stiahnite produkčný verejný kľúč banky z rovnakého priečinka s kľúčmi.
- V Cabintale → Nastavenia → Platobné brány → ČSOB → Nastavenia prepnite režim na Ostrý, vložte svoje produkčné ID obchodníka, súkromný kľúč a verejný kľúč banky, potom Uložiť a nastavte Ostrý ako aktívny režim.
Riešenie problémov
| Príznak | Pravdepodobná príčina | Riešenie |
|---|---|---|
| Test pripojenia zlyhá hneď po uložení | Kľúč bol vložený neúplný, alebo s medzerami navyše / chýbajúcim riadkom hlavičky | Skopírujte celý kľúč znova vrátane riadkov -----BEGIN…----- / -----END…-----, bez medzier na začiatku |
| Funguje v teste, ale nie naostro | Ostrý režim potrebuje vlastné produkčné kľúče, ID obchodníka a produkčný verejný kľúč banky | Vygenerujte produkčné kľúče, potvrďte ich v POS Merchant a vložte produkčnú sadu v ostrom režime |
| „Wrong bank public key“ / chyby podpisu | Použili ste testovací kľúč banky v ostrom režime (alebo naopak) | Stiahnite kľúč pre zodpovedajúce prostredie z priečinka s kľúčmi ČSOB |
| Hostia nemôžu platiť naostro | Produkčný kľúč ešte nie je aktivovaný | Potvrďte kľúč v POS Merchant; aktivácia môže chvíľu trvať |
Súvisiace návody
- Nastavenie platobnej brány – Platobné brány
- Prijímanie platieb pri ubytovaní – Prijímanie platieb pri ubytovaní
- Vrátenia platieb a storná – Vrátenia platieb a storná