Založení a integrace platební brány Comgate ve FAPI
Comgate je spolehlivá platební brána pro online platby, kterou můžete ve FAPI snadno propojit a začít přes ni přijímat platby z prodejních formulářů. Po propojení se platby automaticky párují k objednávkám a zákazník si při dokončení objednávky zvolí platbu přes Comgate.
V této nápovědě najdete postup, jak si Comgate založit, kde získat potřebné údaje pro propojení a jak bránu správně nastavit, aby vše fungovalo bez komplikací. Více informací o platební bráně najdete na webových stránkách provozovatele.
Platební brána není součástí FAPI. Pokud nechcete poskytovat svým zákazníkům možnost platit online, nemusíte ji do FAPI integrovat. Poplatek za používání platební brány je hrazen přímo jejímu provozovateli (společnosti Comgate a.s.), a není tedy součástí ceny za licenci FAPI.
Minimální výše platby, kterou platební brána Comgate dokáže zpracovat, je 1 Kč.
Návod vám pomůže se:
- Založením platební brány Comgate
- Napojením Comgate do FAPI
- Aktivací Comgate v prodejním formuláři
1. Založení účtu platební brány u Comgate
Účet Comgate si zřídíte na stránkách společnosti Comgate vyplnění tzv. poptávkového formuláře.

Ihned po vyplnění poptávkového formuláře o vás Comgate ví a pro další hladký průběh dokončení registrace vás žádají o vyplnění dalších údajů přímo na jejich stránkách.

Zároveň z Comgate z adresy poptavky@comgate.cz obdržíte e-mail s předmětem "Děkuji za poptávku služeb Comgate. Další kroky." pro nastavení další komunikace.

Většinou do jednoho dne od vyplnění vaší poptávky vám společnost Comgate zašle cenovou nabídku a smluvní dokumentaci.
Pokud se na základě nabídky rozhodnete pro spolupráci a podepíšete s provozovatelem platební brány smlouvu, bude vám založen přístup do klientského portálu Comgate.
Po splnění všech smluvních podmínek, ověření a schválení žádosti si můžete nechat aktivovat expresní bankovní převody a začít provádět testovací platby. Comgate vás o zpřístupnění této platební metody bude informovat.
Následně se schvalují samostatně platby kartou, což může trvat až 5 dnů. Opět jste ze strany Comgate informováni.
V klientském portálu můžete rovněž mít založený produkční i testovací profil.
Nastavení Comgate
Přihlaste se svého účtu Comgate a přejděte na Integrace a vyberte obchod.

Poté pro založení nového obchodu se přepněte do záložky Propojení obchodu, pak klikněte na modré tlačítko Přidat.
Již vytvořené propojení můžete spravovat kliknutím u konkrétního obchodu na tužtičku pro úpravu.

Doplňte správné údaje pro URL notifikace a povolené IP adresy. Údaje najdete níže v červeném bloku.

⚠️ Důležité nastavení v Comgate
Aby propojení platební brány Comgate ve FAPI fungovalo správně, je potřeba mít v administraci Comgate u daného obchodu správně vyplněné návratové URL adresy a nastavení IP adres.
V Comgate přejděte dle screenu výše do:
Integrace → Nastavení obchodů → Upravit propojení obchodu
Nastavte tyto návratové URL adresy adresy:
Url zaplacený: https://gateway.fapi.cz/return/com-gate/${refId}?transactionId=${id}
Url zrušený: https://gateway.fapi.cz/return/com-gate/${refId}?transactionId=${id}
Url nevyřízený: https://gateway.fapi.cz/return/com-gate/${refId}?transactionId=${id}
Url pro předání výsledku platby: https://gateway.fapi.cz/notification/com-gate
Povolené IP adresy:
Do seznamu povolených IP adres zadejte:
83.167.243.140
178.238.37.32
18.158.192.220
Alternativně můžete jednoduše zaškrtnout možnost „Povolit všechny IP“.
V takovém případě není potřeba IP adresy ručně vyplňovat a při případné změně IP není nutné nastavení znovu kontrolovat.
Pokud některý údaj chybí nebo není správně vyplněný, můžete nastavení obchodu změnit pomocí tlačítka Upravit (ikona tužky).
❗ Bez správného nastavení obchodu v Comgate nelze platební bránu úspěšně propojit s FAPI.
2. Vytvoření propojení s Comgate ve FAPI
Ve FAPI v nabídce Nastavení -> Propojení aplikací stiskněte tlačítko Nové propojení s Comgate.

Na následující stránce vyplňte údaje nezbytné pro vytvoření propojení se službou Comgate.

Do zobrazeného formuláře vyplňte všechny potřebné údaje. Přístupové údaje najdete ve svém účtu Comgate v nabídce Nastavení obchodů - záložka Propojení obchodu.
- DOMÉNA: vyplňte doménu, na které budete platební bránu používat (jde o interní pojmenování platební brány ve FAPI, ve tvaru www.fapi.cz)
- CLIENT MERCHANT: vyplňte údaj, který se v účtu Comgate nazývá Identifikátor propojení obchodu
- CLIENT SECRET: vyplňte údaj, který se v účtu Comgate nazývá Heslo
- REŽIM: zvolte režim testovací/produkční (podle stavu ve kterém je nastaven Váš účet Comgate)
Vyplněné hodnoty uložte stiskem tlačítka Uložit.
Po přepnutí platební brány do ostrého provozu na straně Comgate, je třeba stejným způsobem změnit i nastavení platební brány ve FAPI.
V nabídce Nastavení - Propojení aplikací stiskněte tlačítko Upravit u příslušného propojení s platební bránou Comgate a volbu REŽIM nastavte na hodnotu produkční režim.
Pokud chcete, aby se peníze přijaté přes platební bránu Comgate automaticky převáděly na váš konkrétní bankovní účet, je možné v nastavení propojení s platební bránou vyplnit ID bankovního účtu z administrace Comgate (pole ACCOUNT).
Tato funkce není ve FAPI dostupná automaticky a aktivujeme ji na vyžádání.
V případě zájmu nám napište na podpora@fapi.cz.
Testovací i produkční režim mají své vlastní přístupové údaje a je potřeba je správně zadat, jinak jsou vyhodnoceny chybou, že se jedná o nesprávné přístupy.
3. Nastavení platební brány Comgate v prodejním formuláři
Nakonec už jen zbývá propojenou platební bránu přidat do prodejního formuláře, v němž si přejete platební bránu využívat.
V nabídce Prodej -> Prodejní formuláře, vyberte formulář, u kterého chcete nabídnout online platby zprostředkované pomocí platební brány Comgate a stiskněte tlačítko Upravit prodejní formulář.

Na záložce 3. Platba, doprava a fakturace v úpravě prodejního formuláře vyberte v sekci Platební brána příslušné propojení s platební bránou Comgate.

Změny provedené v nastavení prodejního formuláře uložte tlačítkem Uložit formulář.

Pokud jste úspěšně došli až sem, gratulujeme! Váš prodejní formulář je nyní propojen s platební bránou Comgate a vaši zákazníci vám mohou začít platit online.
Mnoho užitečných návodů o Comgate najdete pod tímto odkazem, mimo to Comgate má českou podporu: