# ČSOB platební brána

**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.

{% hint style="warning" %}
Pro testovací prostředí budete mít jinou sadu údajů než pro produkční.
{% endhint %}

### 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/>

<figure><img src="/files/8j5ryRjsRuUhLQuEO8ny" alt=""><figcaption></figcaption></figure>

Stáhněte si soukromý klíč a veřejný odešlete tlačítkem **Odeslat veřejný klíč do banky**.

<figure><img src="/files/LGpVNmEHRaYbEEGUj9UJ" alt=""><figcaption></figcaption></figure>

### 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.

{% hint style="info" %}
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>
{% endhint %}

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>

<figure><img src="/files/W0eWqAkc7xGsOR7C8GD8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/8D7x9NgusUDd8XoYBVVZ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/jYESdAZrbcjmyjxSfyag" alt=""><figcaption></figcaption></figure>

### 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/>

<figure><img src="/files/beWv9NHxrwDfjaNoHQfX" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/fCSdG3dT6adCesaIOKib" alt=""><figcaption></figcaption></figure>

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í.

<figure><img src="/files/PfCjgdBOsk0vIduBSDQa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/JpjcsjvdkDQkKNfCXWxp" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/fRYEjDhZnCcjMoHwFbv4" alt=""><figcaption></figcaption></figure>

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í.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/csob-platebni-brana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.