Plugin GoPay pripája platobnú bránu GoPay — zákazník sa pri platbe presmeruje na hostovanú stránku GoPay a po dokončení sa vráti späť do e-shopu.
Čo plugin robí
Po výbere platby GoPay v pokladni sa zákazník presmeruje na platobnú bránu GoPay, kde zaplatí zvolenou metódou (karta, bankový prevod alebo iná metóda podľa vašej zmluvy s GoPay). GoPay nemá v pokladni vlastný vstavaný formulár — celý platobný krok prebieha na jeho stránke.
Požiadavky
Zmluvný účet GoPay s GoID, Client ID a Client secret pre prístup k GoPay API.
Nastavenia
| Pole | Význam |
|---|---|
| GoID | Identifikátor vášho GoPay účtu. |
| Client ID | Client ID pre prístup k GoPay API (z GoPay administrácie). |
| Client secret | Client secret pre GoPay API. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho. |
| Testovací režim | Zapnite počas testovania — použije sa GoPay sandbox (gw.sandbox.gopay.com). Pred spustením naostro vypnite. Predvolené: vypnuté. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin GoPay.
- V Nastaveniach vyplňte GoID, Client ID a Client secret z GoPay administrácie.
- Kým platbu testujete, zapnite Testovací režim — komunikácia pôjde cez GoPay sandbox.
- Uložte nastavenia. Pred spustením naostro Testovací režim vypnite.
Testovací/sandbox režim
Prepínač Testovací režim prepína celú adresu GoPay API medzi gw.sandbox.gopay.com (test) a gate.gopay.com (produkcia) — ide teda o samostatné testovacie prostredie, nielen príznak transakcie. Prihlasovacie údaje pre sandbox a produkciu sa v GoPay administrácii môžu líšiť, overte si preto správnu kombináciu pred prepnutím naostro.
Čo sa deje na objednávke
Objednávka sa označí ako zaplatená, keď GoPay potvrdí stav PAID (cez notifikáciu alebo pri návrate zákazníka). GoPay pri overovaní vždy vyžaduje zhodu identifikátora platby uloženého v objednávke s tým, ktorý prišiel v notifikácii — notifikácia pre inú platbu sa tak nemôže priradiť k cudzej objednávke. Suma sa vždy porovná s pôvodnou objednávkou.
Refundácie
GoPay podporuje plnú aj čiastočnú refundáciu priamo z detailu objednávky v Ecommio — odpoveď GoPay je okamžitá.
Webhook
GoPay posiela notifikáciu na payments/gopay/notification. Ecommio si stav platby po jej prijatí ešte raz overí priamym dotazom na GoPay, nespolieha sa len na obsah notifikácie.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba GoID, Client ID alebo Client secret — doplňte ich v nastaveniach.
- Testovacia platba prebehla naostro (alebo naopak). Skontrolujte prepínač Testovací režim — mení celú adresu GoPay API, nielen príznak.
- Objednávka ostala nezaplatená, hoci zákazník platbu dokončil. Overte notifikačnú URL GoPay v GoPay administrácii — pozrite Riešenie problémov v pokladni.
- Notifikácia od GoPay sa neprejaví v objednávke inej platby. Ide o zámerné správanie — Ecommio priraďuje notifikáciu len k objednávke, ktorej platobný identifikátor sa presne zhoduje, aby sa cudzia notifikácia nemohla omylom prejaviť na inej objednávke.