ČSOB setup

By the end of this guide you'll have ČSOB connected to your account in Test mode, a test card payment working end-to-end, and a clear path to switch to Live once you have a ČSOB contract.

How ČSOB connects to Cabintale

Cabintale needs three things from you, pasted into Settings → Payments:

1. Your Merchant ID — ČSOB gives you this.
2. Your private key — you generate it (you keep this; it never leaves you).
3. ČSOB's bank public key — a file you download from ČSOB.

You start in Test mode (ČSOB's free sandbox, simulated payments) and switch to Live with separate production keys once you have a contract.

Step 1: Generate your keys and get your Merchant ID

1. Open the ČSOB test keygen: https://iplatebnibrana.csob.cz/keygen/
2. Generate a 2048-bit RSA keypair. Save both keys somewhere safe — you can't re-download the private key later.
3. Send the public key to ČSOB using the button on that page.
4. ČSOB shows your Merchant ID — copy it.

Step 2: Download ČSOB's bank public key

1. Open ČSOB's key folder: https://github.com/csob/paymentgateway/tree/master/keys
2. For testing, take the sandbox key: mips_iplatebnibrana.csob.cz.pub.
3. Open it and copy its contents — you'll paste them in the next step. (When you go live, you'll grab the production key from the same place instead.)

Step 3: Paste everything into Cabintale

1. Sidebar → Settings → Payments → on the ČSOB card click Setup.
2. Leave the mode on Test.
3. Fill the three fields:
   • Merchant ID — from Step 1.
   • Private key (PEM) — your private key (it starts with -----BEGIN RSA PRIVATE KEY-----).
   • Bank public key (PEM) — the file from Step 2.
4. Click Save.

Your ČSOB card now shows as connected and becomes the account default for payments.

Step 4: Test a payment

1. Turn payments on for a place or service (see Accept payments on a property).
2. Make a test booking on your widget and pay with a ČSOB test card — the payment and the security check are simulated, no real money moves.
3. The booking arrives paid in your admin.

Step 5: Go live

1. Sign a ČSOB payment-gateway contract — call ČSOB's commercial line 800 150 150 (Czech Republic) or ask your ČSOB business contact for the e-commerce payment gateway.
2. Generate a separate production keypair at https://platebnibrana.csob.cz/keygen/ and save both keys.
3. Confirm the key in POS Merchant — https://posman.csob.cz/posmerchant — so ČSOB activates it for live payments.
4. Download the production bank public key from the same key folder.
5. In Cabintale → Settings → Payments → ČSOB → Settings, flip the mode to Live, paste your production Merchant ID, private key, and bank public key, then Save and set Live as the active mode.

Troubleshooting

Related guides

• Set up your payment gateway — Payment gateways
• Accept payments on a property — Accept payments on a property
• Refunds and cancellations — Refunds and cancellations