Platobná brána je plugin, ktorý po zapnutí a vyplnení prístupových údajov automaticky pridá svoju metódu do zoznamu platieb v pokladni — nezakladáte pre ňu záznam v Platby. Tento článok porovnáva všetky podporované brány; podrobný postup nastavenia každej má samostatný článok.
Kde to nájdete
Brány sa aktivujú a nastavujú v Systém > Pluginy na /admin/plugins — pri module s ozubeným kolieskom otvorte Nastavenia.
Porovnanie brán
| Brána | Typ platby | Priebeh v pokladni | Refundácia cez Ecommio | Webhook | Testovací režim |
|---|---|---|---|---|---|
| Stripe | Platobná karta | Zostáva v našej pokladni (Stripe Elements) | áno, plná aj čiastočná | payments/stripe/webhook | podľa typu API kľúča (test/live) |
| Comgate | Karta, bankový prevod a ďalšie metódy brány | Presmerovanie na Comgate | áno, plná aj čiastočná | payments/comgate/notification | prepínač Testovací režim |
| GoPay | Karta, bankový prevod a ďalšie metódy brány | Presmerovanie na GoPay | áno, plná aj čiastočná | payments/gopay/notification | prepínač Testovací režim (sandbox) |
| CardPay | Platobná karta (Tatra banka) | Presmerovanie na 3-D Secure stránku banky | áno, plná aj čiastočná | žiadny — iba návrat z banky | ručná zmena URL brány |
| GP webpay | Platobná karta (ČSOB/KB a ďalšie) | Presmerovanie na 3-D Secure stránku banky | nie — vráťte prostriedky mimo systému | žiadny — iba návrat z banky | ručná zmena URL brány |
| PayPal | Peňaženka PayPal | Presmerovanie na PayPal | áno | žiadny — potvrdenie prebehne pri návrate zákazníka | výber Prostredie: Sandbox/Produkcia |
| Besteron | Platobná brána (karta a ďalšie metódy) | Presmerovanie na Besteron | nie — refundujte cez portál Besteron | payments/besteron/notification | výber Prostredie: Sandbox/Produkcia |
| Home Credit splátky | Splátky (BNPL) | Presmerovanie na podpis zmluvy Home Credit | nie — riešte cez stornom objednávky | payments/homecredit/notification | výber Prostredie (SK/CZ test aj produkcia) |
| Quatro splátky | Splátky (BNPL) | Presmerovanie na podpis zmluvy Quatro | nie — riešte cez stornom objednávky | payments/quatro/notification | žiadny prepínač — mení sa URL prostredia |
| Coinbase Commerce | Kryptomeny | Zostáva v pokladni, presmerovanie na hostovanú platbu až po potvrdení | nie — kryptoplatby nie je možné refundovať cez API | payments/coinbase/webhook | prepínač existuje v nastaveniach, ale správanie neovplyvňuje |
| QR platba | Nie je samostatná brána — QR kód k bankovému prevodu | Zobrazí sa na ďakovacej stránke pri platbe prevodom | — | — | — |
Ako sa brána stane dostupnou
Brána sa v pokladni objaví, až keď je plugin zapnutý a má vyplnené všetky povinné prístupové údaje — samotné zapnutie nestačí. Pri redirect bránach (Comgate, GoPay, CardPay, GP webpay, PayPal, Besteron, Home Credit, Quatro) sa zákazník po výbere platby presmeruje mimo Ecommio a vráti sa až po dokončení; pri Stripe a Coinbase Commerce zostáva v pokladni dlhšie — Stripe rovno v platobnom formulári, Coinbase Commerce až do potvrdenia odchádza na hostovanú stránku.
Čo sa deje na pozadí
Väčšina brán potvrdzuje platbu cez webhook (server-to-server notifikáciu), ktorá je jediným dôveryhodným zdrojom stavu — návrat zákazníkovho prehliadača sa berie len ako doplnkový, rýchlejší signál. Brány bez webhooku (CardPay, GP webpay, PayPal) naopak overujú platbu výhradne pri podpísanom návrate zákazníka. Pri každej platbe sa suma porovnáva s pôvodnou objednávkou — pri nezhode sa objednávka neoznačí ako zaplatená automaticky.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba jej povinný prístupový údaj — otvorte jej nastavenia v Pluginy a doplňte ich.
- Objednávka ostala nezaplatená, hoci zákazník platbu dokončil. Skontrolujte webhook danej brány — pozrite Riešenie problémov v pokladni.
- Testovacia platba prešla ako ostrá (alebo naopak). Skontrolujte prepínač/voľbu prostredia danej brány — pri CardPay a GP webpay ide o ručne zadanú URL brány.
- Potrebujete vrátiť peniaze, ale tlačidlo Refund chýba. Nie každá brána podporuje refund cez Ecommio — pozrite stĺpec Refundácia vyššie a článok konkrétnej brány.