Dokumentácia
← cabintale.com EN · CZ · SK · FI Napísať podpore
Platby · Návod

Nastavenie ČSOB

Pripojte platobnú bránu ČSOB, aby mohli českí hostia platiť kartou — vygenerujte kľúče, vložte ich a pred spustením si všetko zadarmo vyskúšajte.

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.

Skôr než začnete

Č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.
Čo získate
  • Č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:

  1. Vaše ID obchodníka – dostanete ho od ČSOB.
  2. Váš súkromný kľúč – vygenerujete ho vy (ostáva u vás; nikdy ho neopustí).
  3. 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

  1. Otvorte testovací generátor kľúčov ČSOB: https://iplatebnibrana.csob.cz/keygen/
  2. Vygenerujte 2048-bitový pár RSA. Uložte oba kľúče na bezpečné miesto – súkromný kľúč si neskôr už nestiahnete.
  3. Pošlite verejný kľúč ČSOB tlačidlom na tejto stránke.
  4. ČSOB zobrazí vaše ID obchodníka – skopírujte si ho.

Krok 2: Stiahnite verejný kľúč banky od ČSOB

  1. Otvorte priečinok s kľúčmi ČSOB: https://github.com/csob/paymentgateway/tree/master/keys
  2. Na testovanie vezmite kľúč pre testovacie prostredie: mips_iplatebnibrana.csob.cz.pub.
  3. 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

  1. Bočné menu → Nastavenia → Platobné brány → na karte ČSOB kliknite na Nastaviť.
  2. Režim nechajte na Test.
  3. 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.
  4. 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

  1. Zapnite platby pri ubytovaní alebo službe (pozrite Prijímanie platieb pri ubytovaní).
  2. 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ú.
  3. Rezervácia príde do vašej administrácie ako zaplatená.

Krok 5: Spustite naostro

  1. 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.
  2. Vygenerujte samostatný produkčný pár kľúčov na https://platebnibrana.csob.cz/keygen/ a uložte oba kľúče.
  3. Potvrďte kľúč v POS Merchant – https://posman.csob.cz/posmerchant – aby ho ČSOB aktivovala pre ostré platby.
  4. Stiahnite produkčný verejný kľúč banky z rovnakého priečinka s kľúčmi.
  5. 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íznakPravdepodobná príčinaRiešenie
Test pripojenia zlyhá hneď po uloženíKľúč bol vložený neúplný, alebo s medzerami navyše / chýbajúcim riadkom hlavičkySkopírujte celý kľúč znova vrátane riadkov -----BEGIN…----- / -----END…-----, bez medzier na začiatku
Funguje v teste, ale nie naostroOstrý režim potrebuje vlastné produkčné kľúče, ID obchodníka a produkčný verejný kľúč bankyVygenerujte 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 podpisuPouž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ť naostroProdukčný kľúč ešte nie je aktivovanýPotvrďte kľúč v POS Merchant; aktivácia môže chvíľu trvať

Súvisiace návody

Stále si neviete rady?

Na každý e-mail odpovedáme do jedného pracovného dňa.

Napísať podpore →