Plugin Comgate pripája platobnú bránu Comgate — zákazník sa pri platbe presmeruje na hostovanú stránku Comgate a po dokončení sa vráti späť do e-shopu.
Čo plugin robí
Po výbere platby Comgate v pokladni sa zákazník presmeruje na platobnú bránu Comgate, kde zaplatí zvolenou metódou (karta, bankový prevod alebo iná metóda podľa vašej zmluvy s Comgate). Podporuje aj režim preautorizácie s neskorším doúčtovaním.
Požiadavky
Zmluvný účet Comgate s Merchant ID a bezpečnostným heslom (secret) z klientského portálu Comgate.
Nastavenia
| Pole | Význam |
|---|---|
| Merchant ID | Identifikátor e-shopu, ktorý pridelí Comgate v klientskom portáli. |
| Heslo (secret) | Bezpečnostné heslo z Comgate portálu. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho, alebo vložte nové. |
| Platobné metódy | Kód povolených metód — ALL zobrazí všetky metódy dostupné na bráne. Predvolené: ALL. |
| Typ transakcie | Predaj (okamžité zúčtovanie) alebo Preautorizácia (doúčtovanie neskôr). Predvolené: Predaj. |
| Testovací režim | Zapnite počas testovania — transakcie sa nespoplatnia. Pred spustením naostro vypnite. Predvolené: vypnuté. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin Comgate.
- V Nastaveniach vyplňte Merchant ID a Heslo (secret) z Comgate portálu.
- Ponechajte Platobné metódy na
ALL, pokiaľ nechcete obmedziť len na konkrétnu metódu. - Kým platbu testujete, zapnite Testovací režim — transakcie sa nespoplatnia.
- Uložte nastavenia. Pred spustením naostro Testovací režim vypnite.
Testovací režim
Prepínač Testovací režim posiela do Comgate príznak testovacej transakcie na tej istej adrese brány — nejde o samostatnú sandbox adresu. Nezabudnite ho pred ostrou prevádzkou vypnúť.
Čo sa deje na objednávke
Objednávka sa označí ako zaplatená, keď Comgate potvrdí stav PAID (buď cez notifikáciu, alebo pri návrate zákazníka). Pri preautorizácii (preauth) sa objednávka označí ako autorizovaná a čaká na neskoršie doúčtovanie. Suma platby sa vždy porovná s pôvodnou objednávkou — pri nezhode sa platba neoznačí ako zaplatená automaticky.
Refundácie
Comgate podporuje plnú aj čiastočnú refundáciu priamo z detailu objednávky v Ecommio — odpoveď Comgate je okamžitá, takže refund sa v objednávke prejaví ihneď.
Webhook
Comgate posiela notifikáciu na payments/comgate/notification. Notifikácia sa neberie ako konečná pravda sama osebe — Ecommio si stav platby po jej prijatí ešte raz overí priamym dotazom na Comgate.
Comgate nemá v pokladni vlastný vstavaný formulár — celý platobný krok prebieha na jeho hostovanej stránke, zákazník sa do e-shopu vráti až po dokončení alebo zrušení platby.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba Merchant ID alebo Heslo (secret) — doplňte ich v nastaveniach.
- Testovacia platba sa spoplatnila. Skontrolujte, či je zapnutý Testovací režim.
- Objednávka ostala nezaplatená, hoci zákazník platbu dokončil. Overte, že notifikačná URL Comgate je nastavená na doménu vášho e-shopu — pozrite Riešenie problémov v pokladni.
- Preautorizovaná platba sa nedoúčtovala. Skontrolujte Typ transakcie — pri preautorizácii treba platbu doúčtovať samostatne, nezúčtuje sa automaticky.