# Č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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2Fk2EnauSzmakCXNCW8nNy%2Fimage.png?alt=media&#x26;token=46a9f56c-4f1c-480d-b4fe-a1ca4ce158bc" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FPLc5DygEdU1571venMor%2Fimage.png?alt=media&#x26;token=da1a8aee-1ce1-46a8-96cd-cc4742c83ac4" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FacdE9owELCqQ1wLxUYLu%2Fimage.png?alt=media&#x26;token=08a1304e-e660-4679-9f7e-70189cade67a" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FPUBQiaJilHE1Kivw5Tks%2Fimage.png?alt=media&#x26;token=e68e6e99-65f5-4499-bb46-70ad18d7d35f" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2F59kypW6jutpencr9CkdZ%2Fimage.png?alt=media&#x26;token=30888e4c-0b95-4634-bb62-ca625a643a76" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FtuDkZoM4Pl26ggm1TYvZ%2Fimage.png?alt=media&#x26;token=2bcacea4-45e8-4212-822c-a79442064776" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FYg9dQkVqR4BbxUVhxf6s%2Fimage.png?alt=media&#x26;token=67496b03-66e1-467a-832f-a10c20024ae9" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FFMBSgoDdW9dsPjRYNo6C%2Fimage.png?alt=media&#x26;token=2f03ed01-cfe4-4ec7-aa3d-1e509f0eec7e" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FfmAKRNSpC5Vq3TUX48Rj%2Fimage.png?alt=media&#x26;token=edb2170f-e051-4b8a-a55b-d6a8b23e8fc7" 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="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FH2kViHvYXb3lTcHoWf4y%2Fimage.png?alt=media&#x26;token=fe23deae-d31a-475e-8507-5388f9630eba" 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í.