Návod na zprovoznění platební brány ČOSB od Platiti.cz

Integraci ČSOB platební brány pro WooCommerce od společnosti Platiti.cz jsme prováděli již několikrát, ale postup není příliš jednoznačný a také při vycházení z oficiálního návodu pluginu jsme se několikrát zasekli. Právě proto jsme se rozhodli sepsat tento návod, který by měl mnohem podrobněji vysvětlit celý proces.

Příprava pro integraci

Pro zdárné dokončení integrace budete potřebovat následující:
 
  • Předpokladem je zakoupení pluginu na webu Platiti.cz
  • Musíte také provést registraci u ČSOB (některé další banky také využívají právě ČSOB brány, protože nemají vlastní)
  • Číslo obchodníka neboli Merchant ID (např. M1MIPSXXXX)
  • Emailovou adresu obchodníka a jeho IČO
  • Přístup do testovacího ( https://iposman.iplatebnibrana.csob.cz/posmerchant/ ) a produkčního ( https://posman.csob.cz/posmerchant/ ) prostředí POS Merchant
  • Přístupové údaje pro FTP vašeho eshopu
  • Správně nastavený webhosting, který vyžaduje především podporu php_opnssl a bcmath
  • WooCommerce (nejlépe samozřejmě v poslední verzi)

Zakoupení modulu

Nejdříve musíte zakoupit modul na webu platit.cz a poté obdržíte mailem licenční klíč a odkaz pro stažení souborů.

Generování testovacích klíčů

Nyní provedeme vygenerování testovacích klíčů na adrese https://iplatebnibrana.csob.cz/keygen/. Musíte samozřejmě znát Merchant ID a Email, který registraci obchodníka prováděl. Případně email pro technický kontakt. Poté vygenerujete klíče, které stáhnete. Bude se jednat o klíče s koncovkami .key a .pub.

Veřejný klíč můžete rovnou nahrát kliknutím na tlačítko Upload Public Key.

Kopírování souborů pomocí FTP

Stažené soubory nyní rozbalte a překopírujte pomocí FTP. Složka UniModul se kopíruje na úroveň www a obsah složky wp-content právě do ní. Tedy CsobBinder a WooCommerceAdapter do složky wp-content/plugins.

Vygenerované klíče nahrajte do složky UniModul -> certs. V této složce najdete také další soubory, například mips_iplatebnibrana.csob.cz.cer

Aktivace a nastavení pluginu

Nyní se můžete přihlásit do administrace vašeho webu a přejít do sekce pluginy, kde provedete aktivaci WooCommerce Csob a WooCommerce platiti.cz adapter.

Po aktivování přejděte do sekce WooCommerce -> Nastavení -> Pokladna a klikněte na Csob. Nyní budete muset zadat správné informace.

  • Aktivační klíč: Licence, kterou jste dostali od platiti v emailu
  • Adresa brány Csob: Pro testovací použijeme hodnotu https://iapi.iplatebnibrana.csob.cz/api/v1.8
  • Číslo obchodníka pro CZK: Vaše Merchant ID, které obdržíte přímo od ČOSB. Má tvar M1MIPXXXX.
  • Veřejný klíč Csob: Pro testovací použijeme hodnotu mips_iplatebnibrana.csob.cz.pub
  • Soubor privátního klíče: Soubor nahraný do složky certs, například rsa_M1MIPSXXXX.key
  • Zapnout/Vypnout: Plugin zapneme

Testovací scénáře pro přechod do produkčního prostředí

Pokud máte zadané veškeré informace a povolenou platební bránu, stačí vytvořit testovací objednávku, pro kterou zvolíte platbu právě pomocí ČSOB brány. Pokud budete úspěšně přesměrováni na samotnou bránů, můžete začít s testovacími scénáři pro přechod do produkčního prostředí.

Scénáře provedete tak, že budete vytvářet objednávky a simulovat různé typy výsledků. Toho dosáhnete pomocí testovacích karet, které jsou uvedeny zde: https://github.com/csob/paymentgateway/wiki/Testovac%C3%AD-karty

Úspěšná platba
Použijeme testovací kartu pro úspěšnou autorizaci, například 4125010001000208 expirace 12/22 CVC 123

Uživatelem zrušená platba
Stačí kliknout na tlačítko zrušit platbu a vrátit se do obchodu.

Expirovaná (zrušená platba)
Po přesměrování na platební bránu vyčkejte 30 minut a nechte platbu expirovat.

Reverzovaná platba
Pro platbu zadejte kartu 5542860001000224, expiraci 06/23 a CVC 100

Generování produkčních klíčů

Vygenerování produkčního klíče a jeho nahrání probíhá stejně jako v případě toho testovacího. Musíte ovšem tuto akci provést na adrese pro generování produkčních klíčů, přesněji na https://platebnibrana.csob.cz/keygen/ Veřejný klíč můžete opět rovnou nahrát pomocí Upload public key (Nahrát veřejný klíč) a soukromý klíč nahrát do složky certs.

Přechod do produkčního prostředí

Nyní stačí změnit nastavení pluginu pro produkční prostředí. Bude se jednat o změnu několika položek.

  • Aktivační klíč: Ponecháme
  • Adresa brány Csob: Pro produkční použijeme hodnotu https://api.platebnibrana.csob.cz/api/v1.8
  • Číslo obchodníka pro CZK: Ponecháme
  • Veřejný klíč Csob: Pro produkční použijeme hodnotu mips_platebnibrana.csob.cz.pub
  • Soubor privátního klíče: Změníme za název souboru nového klíče nahraného do složky certs
  • Zapnout/Vypnout: Plugin zapneme

Řešení problémů

Kompletní informace o fungování brány jsou zapisovány do logu, kde se dozvíte případné chyby. Log najdete ve složce UniModul/logs/UniModul.log

Pomohl vám článek? Sdílejte ho na sociální sítě.

Facebook
Twitter
LinkedIn
WhatsApp
Skype
Email
5 2 votes
Article Rating
Subscribe
Upozornit na
guest
9 Komentáře
Nejstarší
Nejnovější Most Voted
Inline Feedbacks
View all comments
Pavel
Pavel
6. 4. 2021 13:23

Jakým způsobem se po otestování přejde na produkční prostředí? Kde získám produkční klíče?

Pavel
Pavel
13. 4. 2021 17:43
Reply to  Jan Drábek

Děkuji za doplnění návodu. Ještě se vrátím k testovacímu scénáři – není mi úplně jasné, jak se provede rezervovaná platba – vložil jsem údaje této karty jako předtím tu první testovací platbu a v POS Merchant se tato platba nezobrazila resp. nepotvrdil se daný test. Není nutné třeba ještě změnit nějaké nastavení brány ve woocommerce – např. Převod peněz – Strhnout ihned / pouze předautorizace ?

Pavel
Pavel
14. 4. 2021 8:47
Reply to  Pavel

Všiml jsem si překlepu, tak raději kopie z POS Merchant:
Nenalezena transakce se stavem: ReverzovánoMusíte udělat alespoň jeden reverzal.

Daniel
11. 5. 2021 12:03
Reply to  Pavel

asi už jste na to během měsíce přišel sám, ale pro budoucí…

reverzovat platbu musíte přímo z POS merchant > transakce > platební brány > vyhledat
reverzi provedete kliknutím na modrý symbol dolaru nalevo u platby

Roman U
19. 9. 2021 18:27

Dobrý den, CSOB nám nyní psalo, že se bude měnit produkční certifikát. Šlo by udělat podrobnější návod jak tento certifikát aktualizovat?

Radek
Radek
20. 2. 2022 20:57

Dobrý den,
chtěl jsem se zeptat zda mě můžete prosím navést v čem může být problém, že platby po zadání testovací karty končí na uvedené stránce a nepřesměrují zákazníka zpět? Plugin nastaven dle návodu a vše jinak funguje ale končím zde

screen.png

Obsah článku

Autor článku

Jan Drábek

Jan Drábek

Jsem provozovatelem webů pod značkou EASYPRESS a autorem většiny článků v tomto Magazínu o WordPressu. Specializuji se především na tvorbu stránek na míru a jsem jednatelem webového studia PAGEART.CZ.