Plugin Besteron pripája platobnú bránu Besteron — zákazník sa pri platbe presmeruje na hostovanú stránku Besteron a po dokončení sa vráti späť do e-shopu.
Čo plugin robí
Po výbere platby Besteron v pokladni sa zákazník presmeruje na platobnú bránu Besteron, kde zaplatí zvolenou metódou. Besteron nemá v pokladni vlastný vstavaný formulár — celý platobný krok prebieha na jeho stránke, do e-shopu sa zákazník vráti až po dokončení alebo zrušení platby.
Požiadavky
Zmluvný účet Besteron s Client ID a platobným kľúčom (client secret pre OAuth2) z portálu Besteron.
Nastavenia
| Pole | Význam |
|---|---|
| Client ID (CID) | Identifikátor obchodníka, ktorý pridelí Besteron. |
| Payment key (client secret) | Platobný kľúč z Besteron portálu. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho, alebo vložte nový. |
| Prostredie | Sandbox (testovacie prostredie) alebo Produkcia (ostrá brána). Predvolené: Sandbox. |
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin Besteron.
- V Nastaveniach vyplňte Client ID a Payment key z portálu Besteron.
- Kým platbu testujete, ponechajte Prostredie: Sandbox.
- Uložte nastavenia. Pred spustením naostro prepnite Prostredie na Produkcia.
Testovací/sandbox režim
Voľba Prostredie prepína celú adresu API medzi sandboxom (gate.snd.besteron.com) a produkciou (gate.besteron.com) — nejde len o príznak transakcie, ale o samostatné testovacie prostredie Besteron. Kým prostredie prepínate, prihlasovacie údaje pre sandbox a produkciu môžu byť odlišné — overte si to v portáli Besteron.
Čo sa deje na objednávke
Objednávka sa neoznačí ako zaplatená len na základe návratu zákazníka ani prijatej notifikácie — Ecommio si stav platby vždy ešte raz overí priamym dotazom na Besteron podľa identifikátora transakcie. Suma sa porovná s pôvodnou objednávkou; pri nezhode zostane objednávka nezaplatená a vyžaduje manuálnu kontrolu.
Refundácie
Besteron nemá refundačné API dostupné cez Ecommio — vrátenie peňazí vykonajte priamo v portáli Besteron a v objednávke ho zaznamenajte manuálne.
Webhook
Besteron posiela notifikáciu na payments/besteron/notification. Notifikácia sa neberie ako konečná pravda sama osebe — slúži len ako podnet na overenie stavu priamo v Besteron.
Besteron je presmerovacia brána — v pokladni nemá vlastný vstavaný formulár ani sa nedá naviazať na konkrétnu doručovaciu metódu, je dostupná pri každej doprave rovnako.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba Client ID alebo Payment key — doplňte ich v nastaveniach.
- Testovacia platba prešla ako ostrá (alebo naopak). Skontrolujte voľbu Prostredie.
- Objednávka ostala nezaplatená, hoci zákazník platbu dokončil. Overte notifikačnú URL v portáli Besteron — pozrite Riešenie problémov v pokladni.
- Potrebujete vrátiť peniaze zákazníkovi. Cez Ecommio to nejde — refundáciu vykonajte v portáli Besteron a v objednávke ju zaznamenajte manuálne.
- Zákazník zrušil platbu na strane Besteron. Objednávka ostáva nezaplatená a zákazník ju môže dokončiť neskôr znova cez pôvodný odkaz na platbu.