Integrace platební brány Comgate | WEBZI

Integrace platební brány Comgate

Comgate je česká platební brána, která dnes patří mezi nejrozšířenější způsoby, jak v online prostředí přijímat platby kartou, bankovním tlačítkem, QR platbou nebo přes Apple Pay a Google Pay. V tomto článku si projdeme, co Comgate umí, jak ho napojit na nejčastější e-commerce platformy — WooCommerce, Shoptet, PrestaShop, Magento — a jak na integraci přes vlastní REST API, pokud máte web nebo aplikaci postavenou na míru.

Jsme oficiální partneři Comgate, takže pokud se kdekoli v průběhu zaseknete, napojení na váš systém rádi dotáhneme za vás — stačí nám dát vědět. Oficiální stránky provozovatele najdete na comgate.cz a kompletní technickou dokumentaci na help.comgate.cz.

Co je Comgate a co umí

Comgate je česká platební instituce licencovaná ČNB a zároveň platební brána, která funguje jako jedno jednotné napojení pro většinu platebních metod, se kterými se u nás setkáte. Místo toho, abyste si integrovali zvlášť kartový procesor, zvlášť bankovní tlačítka a zvlášť mobilní peněženky, dostanete všechno pod jednou střechou a s jednou fakturací.

Mezi klíčové podporované metody patří:

• Platba kartou (Visa, Mastercard, Maestro) včetně 3-D Secure 2 a uložení karty pro opakované platby.
• Bankovní tlačítka — rychlé převody přímo z internetového bankovnictví (ČSOB, Česká spořitelna, KB, Raiffeisenbank, Fio a další).
• Apple Pay a Google Pay pro platbu z mobilu jedním klikem.
• QR platba a bankovní převod s předvyplněným VS.
• Opakované a předautorizované platby pro předplatné a rezervace.
• Benefitní karty (Benefit Plus, Sodexo / Pluxee, Edenred) na vybraných typech účtu.

Hlavní výhody pro provozovatele

Jedno napojení, všechny metody. Nemusíte řešit samostatné smlouvy s acquirerem, bankami a mobilními peněženkami — všechno jde přes jednu smlouvu a jedno API.

Rychlé výplaty (standardně D+1 u kartových plateb) a přehledná administrace v portálu Comgate, kde vidíte transakce v reálném čase, řešíte storna, refundy i dispute.

Hotové pluginy pro všechny hlavní e-shopové platformy, takže u typické instalace nepotřebujete programátora — jen pár údajů zkopírovat z portálu do administrace obchodu.

Jak Comgate zapojit — přehled možností

Konkrétní postup se liší podle toho, na čem váš e-shop nebo web běží. Projděme si ty nejčastější scénáře.

WordPress a WooCommerce

Pro WooCommerce existuje oficiální plugin, který Comgate dodává a udržuje. Postup je jednoduchý:

1. Uzavřete smlouvu na comgate.cz a získejte přístup do portálu.
2. V portálu si v sekci Integrace vygenerujte Merchant ID a tajné heslo (secret).
3. V administraci WordPressu nainstalujte plugin „Comgate Payments for WooCommerce“ (plugins → přidat nový → vyhledat „Comgate“) a aktivujte ho.
4. V WooCommerce → Nastavení → Platby povolte Comgate a vložte Merchant ID a secret z kroku 2.
5. Nastavte callback URL — většinou ji plugin vygeneruje a zobrazí sám; tu pak vložte do portálu Comgate.
6. Přepněte režim na test, proveďte kontrolní platbu a teprve pak aktivujte ostrý provoz.

Pokud jedete „čistý“ WordPress bez WooCommerce (třeba jen s platebním formulářem přes Contact Form 7 nebo Gravity Forms), půjde to taky — obvykle ale přes REST API, stejně jako u řešení na míru (viz níže).

Shoptet

Shoptet má podporu Comgate přímo v jádru — nemusíte nic instalovat. Stačí v administraci Shoptetu jít do Propojení → Platební brány → Comgate, povolit modul a vložit Merchant ID a heslo z portálu Comgate. Dál nastavíte, které platební metody chcete v košíku zobrazovat, a je hotovo.

Výhoda Shoptetu je, že párování plateb k objednávkám, refundy i stavové notifikace běží bez zásahu do kódu — starejte se jen o samotné objednávky.

PrestaShop

Na PrestaShop existuje oficiální modul dostupný jak přes PrestaShop Addons, tak přes portál Comgate. Instalace probíhá zip souborem v administraci v sekci Moduly → Manažer modulů → Nahrát modul. Po instalaci modul nakonfigurujete zadáním Merchant ID a secretu a vyberete, které metody chcete nabízet (karty, bankovní tlačítka, Apple Pay / Google Pay).

U PrestaShopu doporučujeme vždy nejdřív pořádně projet testovací platbu — zejména stavy jako PENDING a AUTHORIZED, protože se na nich často láme, zda se správně spáruje objednávka.

Magento 2

Pro Magento 2 Comgate dodává oficiální modul, který se instaluje přes Composer. Do projektu přidáte závislost, spustíte setup:upgrade, vyčistíte cache a v administraci v sekci Stores → Configuration → Sales → Payment Methods najdete Comgate mezi metodami. Konfigurace je pak stejná jako jinde — Merchant ID, secret, režim test / ostrý, callback URL.

Vlastní řešení — Next.js, Node.js, PHP, na míru

Když máte web nebo aplikaci postavenou na míru (třeba v Next.js, Laravelu, Symfony, Djangu nebo čemkoli jiném), integrujete Comgate přes jejich REST API. Kompletní specifikaci najdete v dokumentaci na help.comgate.cz.

V principu jde o tři hlavní endpointy:

1. Create payment — na server Comgate pošlete částku, měnu, referenci objednávky, e-mail zákazníka a návratové URL. Comgate vám odpoví transId a redirect URL, na kterou zákazníka pošlete.
2. Callback (notify) endpoint — na URL, kterou si u Comgate zaregistrujete, vám Comgate serverovým voláním oznámí změnu stavu platby (PAID, CANCELLED, AUTHORIZED). Na jeho základě si u sebe označíte objednávku jako zaplacenou. Spolehlivě se spoléhejte na callback, ne na přesměrování zpátky do prohlížeče.
3. Status / refund — pro dotazy na stav a vracení peněz.

Pár věcí, na kterých se typicky láme integrace na míru:

• Ověření callbacku — callback přichází jako serverový POST a je potřeba ho zvalidovat. Nikdy nespoléhejte jen na návrat uživatele z brány, protože prohlížeč se nemusí vrátit vůbec.
• Idempotence — callback může přijít víckrát (síť, retry). Zpracování musí být idempotentní, jinak hrozí dvojí označení objednávky jako zaplacené.
• Stavy — sledujte i mezistavy jako AUTHORIZED a PENDING, ne jen PAID, zejména u předautorizací.
• Měny a minimální částky — u některých metod platí minimální limity a ne každá metoda podporuje každou měnu.

Testovací režim a přechod do ostrého provozu

Comgate nabízí plnohodnotný testovací účet, na kterém si můžete celý tok nacvičit bez jediné reálné koruny. V portálu v sekci Integrace najdete testovací kartová čísla, testovací bankovní tlačítka i simulaci úspěšných a neúspěšných scénářů.

Před přepnutím do ostrého provozu doporučujeme projet minimálně: úspěšnou platbu kartou, zamítnutou platbu, platbu přes bankovní tlačítko, refund a ověření, že callback správně spáruje objednávku u vás v systému.

Shrnutí — co si z toho odnést

Comgate je pro český e-commerce trh v podstatě „bezpečná volba“ — velká pokrytá škála platebních metod, rozumné poplatky a funkční integrace do všech hlavních platforem. U hotových řešení (Shoptet, WooCommerce, PrestaShop, Magento) je napojení většinou otázka hodiny práce. U řešení na míru pak záleží hlavně na tom, jak dobře ošetříte callback — tam leží většina reálných problémů.

Jsme partnery Comgate a Comgate integrujeme pravidelně — od jednoduchých WooCommerce e-shopů až po komplexní Next.js aplikace s vlastním checkoutem, tokenizací karet a opakovanými platbami. Pokud si nejste jistí, jakou cestou se vydat, nebo chcete integraci rovnou hodit na nás, jsme tu.