Nacházíte se na stránkách dokumentace pluginu Toret ČSOB, který který integruje platební bránu ČSOB do WooCommerce.
Před implementací platební brány je nutné uzavřít s ČSOB smlouvu. Více informací k platební bráně a formulář pro registraci do platební brány najde zde.
Instalace pluginu
Po zakoupení pluginu obdržíte e-mailem licenční klíč a odkaz na stažení zip souboru s pluginem. Detailní návod, jak do WordPress nainstalovat plugin z počítače, najdete zde.
Aktivace pluginu
Po instalaci pluginu si otevřete plugin Toret ČSOB, do příslušného pole vložte licenční klíč a ověřte licenci.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-platebni-brana-csob-aktivace-1024x453.png)
Krok 1: Testovací proces
Po uzavření smlouvy vám pošle ČSOB přístupové údaje do aplikace Posman a e-mail s výzvou k provedení testovacích plateb. Projdeme si jednotlivé kroky testovacího procesu.
Nastavení platební metody ČSOB najdete ve WooCommerce > Nastavení > Pokladna > ČSOB platební brána.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/CSOB-testovani.png)
1.Vygenerujte si testovací klíče. Ty se generují v integračním prostředí zde.
2. Vygenerovaný veřejný klíč (PUB) vložíte do integračního prostředí přes tlačítko „Upload veřejného klíče“ (na stejné stránce jako bod 1).
3. Soukromý klíč (KEY) je nutné nahrát v nastavení pluginu a zároveň povolit testovací mód.
4. V pluginu dále vyplňte ID Brány (ID obchodníka) a povolte platební metodu platby kartou. ID Brány najdete v aplikaci Posman pod kartou “Platební brány”.
5. Nyní je třeba provést testovací platby a následně je zvalidovat.
Testovací platby
ČSOB vyžaduje čtyři testovací platby – úspěšnou, uživatelem zrušenou, expirovanou a reverzovanou. Pro testovací platby je připravena testovací karta:
- č. karty: 4000007000010006
- CVC 100
- expirace: libovolné datum v budoucnosti
O více možnostech testovacích plateb se dozvíte pod odkazem zde.
a. U úspěšné platby se zadá testovací karta a po dokončení platby dojde k přesměrování zpět do e-shopu.
b. Pro uskutečnění uživatelem zrušené platby je nutné na platební bráně kliknout na odkaz „Zrušit platbu a návrat zpět do e-shopu“.
c. U expirované platby je nutné je vyčkat 30 minut na stránce platební brány. Po 30 minutách dojde k expiraci platby a dojde k přesměrování zpět na e-shop.
d. U reverzní testovací platby je nutné v nastavení platební metody ČSOB aktivovat funkci „Zakázat automatické zavírání“. Následně je nutné vytvořit objednávku s platbou. V detailu objednávky se nachází vpravo box „Toret ČSOB“, v tomto boxu stačí kliknout na tlačítko “Reverzní platba”.
Validace
Po dokončení testovacích objednávek je nutné provést validaci v testovacím prostředí aplikace POS Merchant (https://iposman.iplatebnibrana.csob.cz/posmerchant/).
Po přihlášení je nutné přejít na kartu Platební brány a poté se přes ikonu lupy u platební brány dostat ke schválení testovacích plateb. Kliknutím na tlačítko Provést validaci dojde k ověření plateb a zobrazí se výsledek validace jednotlivých plateb.
Pokud budou u všech testovacích plateb zelené fajfky, je ještě nutné kliknout na tlačítko Odeslat požadavek. Tím se testovací proces odešle ke schválení.
Po splnění testovacích plateb zašle ČSOB informaci o aktivaci produkčního prostředí a přidá dalších pokyny ke spuštění platební brány. Nyní se může přejít k ostré implementaci.
![](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-csob-overeni-testovacich-plateb-980x613-1.png)
Krok 2: Ostrá implementace
Pokud po vás ČSOB nevyžaduje provést testovací platby nebo jste již úspěšně prošli testovacím procesem v předchozím kroku, tak si na stránkách platebnibrana.csob.cz/keygen/ vygenerujete produkční klíče, které použijete pro provozní prostředí.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/CSOB-produkcni-klic.png)
- Na stránce platebnibrana.csob.cz/keygen/ zadáte Merchatn ID a registrovanou e-mailovou adresu
- Vygenerujete přístupové klíče (public a private)
- Veřejný klíč vložíte do integračního prostředí přes tlačítko „Upload veřejného klíče“ (na stejné stránce jako bod 1).
- Privátní klíč nahrajete do WooCommerce v nastavení platební metody ČSOB (WooCommerce > Nastavení > Pokladna > ČSOB platební brána – Nahrát produkční privátní klíč – Uložit změny).
- ČSOB vám zašle na registrovanou adresu aktivační kód, kterým potvrdíte požadavek na zavedení klíče. Potvrzení probíhá v aplikaci posman.csob.cz → Platební brány → sloupec Akce → ikonka klíče.
- Vypnete testovací mód v nastavení platební metody.
Po uložený produkčních klíčů a nastavení pluginu je platební brána připravena přijímat platby. Napojení můžete snadno otestovat tak, že vytvoříte testovací objednávku s výběrem platební metody ČSOB. Pokud po dokončení testovací objednávky budete přesměrováni na platební bránu, provedli jste integraci správně. Případně můžete platbu dokončit a tím si budete 100% jisti s funkčností platební brány.
Automatické načítání stavu plateb
V případě dokončení platby je zákazník přesměrován na děkovnou stránku. Zároveň je předána notifikace o tom, že je objednávka uhrazena a dojde ke změně stavu objednávky na Zpracovává se (u fyzických produktů) nebo na Dokončeno (u virtuálních produktů).
Může se však stát, že zákazník z nějakého důvodu nebyl po uhrazení objednávky přesměrován na děkovnou stránku. V tom případě plugin nemá žádnou informaci od platební brány o tom, že je objednávka uhrazena. Aby nedošlo k tomu, že uhrazené objednávky bez notifikace budou funkcí WooCommerce zrušeny, je nutné nastavit funkci automatického načítání plateb.
Nastavení automatického načítání stavu platby najdete po kartou Toret Plugins → Toret ČSOB.
![Toret ČSOB – Automatické načítání stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-csob-automaticke-nacitani-stavu-platby-1-1024x667-1.png)
1) Nastavíte počet dní pro zpětnou kontrolu stavů plateb u objednávek, tedy v jakém zpětném časovém horizontu se budou objednávky kontrolovat.
![Toret ČSOB – nastavení počtu dní pro zpětnou kontrolu](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-gp-csob-nastaveni-poctu-dni-pro-zpetnou-kontrolu.png)
2) Pokud nechcete kontrolovat stav platby u všech objednávek, je možné vybrat jednotlivé stavy objednávek, které se z kontroly vyřadí. Rozhodně nedoporučujeme vylučovat stav Čeká na platbu, Selhalo a Zrušeno.
![Toret ČSOB – nastavení stavů objednávky, které se nebudou kontrolovat](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-csob-nastaveni-stavu-objednavky-ktere-se-nebudou-kontrolovat-1024x43-1.png)
3) Změna stavu objednávky podle stavu platby: V případě, že chcete po potvrzení úhrady objednávky změnit stav např. na „Zpracovává se“ nebo jiný preferovaný stav, tak u stavu platby „4 – Platba potvrzena“ si nastavte stav objednávky, na který se objednávka přepne. Ve stavu platby „4 – Platba potvrzena“ se bere objednávka jako uhrazená.
![Toret ČSOB – změna stavu objednávky podle stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-csob-zmena-stavu-objednavky-podle-stavu-platby-1024x516-1.png)
Funkci změny stavu objednávky na základě stavu platby je nutné povolit aktivací checkboxu.
![Toret ČSOB – aktivace změny stavu objednávky na základě stavu platby](https://documentation.toret.cz/wp-content/uploads/2024/06/toret-csob-aktivace-zmeny-stavu-objednavky-na-zaklade-stavu-platby.png)
4) Aby se stav plateb aktualizoval podle nastavení z předchozích tří bodů, tak je nutné na hostingu nastavit URL CRONu, která je uvedená v nastavení u vás na webu. CRON doporučujeme pravidelně spouštět, minimálně 1x za hodinu.
Dále je nutné nastavit počet objednávek, které budou kontrolovány na jeden běh CRONu.
![Toret ČSOB – nastavení CRONu](https://documentation.toret.cz/wp-content/uploads/2024/06/screenshot-csob.toret_.dev-2024.04.02-15_00_24.png)
Pojmy v nastavení pluginu
Nastavení platební metody ČSOB najdete ve WooCommerce > Nastavení > Pokladna > ČSOB Platební brána
Zde si projdeme jednotlivé možnosti nastavení platební metody v pluginu ČSOB.
![](https://documentation.toret.cz/wp-content/uploads/2024/08/CSOB-nastaveni-1024x977.png)
- Název: Jedná se o název platební metody ČSOB, který se bude zobrazovat v pokladně.
- Popis: Nastavený popis se zobrazí v pokladně při výběru způsobu platby.
- Vlastní ikona: Plugin má výchozí ikonu nastavenou, ale je možné si nastavit vlastní ikonu pro platební metodu ČSOB. Ikonu je nutné vložit mezi média WordPressu a její URL vložit zde do pole.
- Vrácení platby: Zapnutím této funkce dojde k vrácení platby při změně stavu objednávky na „Vráceno“ (Cancelled). Také dojde ke zrušení platby, která ještě nebyla zaúčtována.
- Název obchodu: Název obchodu použitý v platebních údajích, který se předává pomocí API na platební bránu.
- ID obchodníka: Jedná se o implementační údaj, který získáte od ČSOB. Případně jej najdete v posman.csob.cz → Platební brány → ID Brány
- Nahrát testovací privátní klíč: Jedná se o soubor (.key) získaný od ČSOB, který pomocí tlačítka „Vybrat soubor“ vložíte na FTP do pluginu. O řádek níže (Vybraná cesta k testovacímu privátnímu klíči) se po nahrátí zobrazí cesta k souboru.
- Nahrát produkční privátní klíč: Zde nahrajete privátní klíč pro ostrý provoz platební brány, který získáte po úspěšném otestování.
- Testovací režim: Zde je checkbox pro zapnutí testovacího prostředí platební brány. Pro její použití je nutné mít k dispozici testovací private key.
- Zakázat automatické zavírání: Tuto funkci využije při testování plateb, viz výše.
- Povolené způsoby dopravy: Zde je možné nastavit zobrazení platební brány jen pro vybrané dopravní metody. Pokud platební bránu chcete používat pro všechny dopravní metody, nechte pole prázdné.
- Povolené platební metody: Zde je nutné vybrat alespoň jednu platební metodu ČSOB platební brány, kterou chcete v pokladně zobrazit. Počet metod k výběru je ovlivněný tím, kolik jich jich máte od ČSOB povolených.
- Povolené země: Zde lze nastavit pro jaké země se bude platební metoda ČSOB zobrazovat v pokladně. Pokud platební bránu chcete používat pro všechny země, nechte pole prázdné.