Preskočiť na obsah
Všetky príručky

Platobná brána TatraPay+ (Tatra banka)

Nastavenie pluginu TatraPay+ — Client ID a Client secret z developer portálu, sandbox a produkcia, predvolená metóda, preautorizácia a refundácie.

Pre: ObchodníkV administrácii:/admin/plugins/tatrapay/settings

Plugin TatraPay+ pripája platobnú bránu tatrapay+ od Tatra banky. Zákazník sa pri platbe presmeruje na stránku banky, kde zaplatí kartou (vrátane Apple Pay a Google Pay), bankovým prevodom z Tatra banky alebo inej slovenskej banky, QR kódom alebo na splátky (NaSplátkyTB), a po dokončení sa vráti späť do e-shopu.

Nezamieňajte s pluginom CardPay — ten pripája staršie rozhranie Tatra banky len pre platby kartou (číslo obchodníka a bezpečnostný kľúč). TatraPay+ je novšia brána so všetkými metódami v jednom a s prístupom cez developer portál banky.

Čo plugin robí

Po výbere platby v pokladni sa zákazník presmeruje na bránu tatrapay+, kde si vyberie metódu (alebo je rovno na jednej z nich, ak ju nastavíte ako predvolenú). Metódy, ktoré nemáte v zmluve s bankou, brána nezobrazí. Po návrate si Ecommio overí stav platby priamo u banky a objednávku označí ako zaplatenú.

Požiadavky

  1. Zmluva o službe tatrapay+ s Tatra bankou (určuje, ktoré metódy máte povolené — karta, prevod, QR, splátky).
  2. Registrácia na developer portáli banky (developer.tatrabanka.sk) a vytvorená aplikácia s API TatraPayPlus, scope TATRAPAYPLUS a typom „Dôverné“. Portál vám vygeneruje Client ID a Client secret.
  3. V aplikácii na portáli musí byť zaregistrovaná Redirect URL vášho e-shopu: https://vasa-domena.sk/payments/tatrapay/return (bez ďalších parametrov). Bez nej banka platbu odmietne s chybou „Invalid Redirect-URI“.
  4. Produkčný prístup pridelí banka až po podpise zmluvy — žiada sa cez online formulár na portáli; dovtedy funguje len Sandbox.

Nastavenia

PoleVýznam
Client ID (API key)API key / Client ID aplikácie z developer portálu.
Client secretClient secret tej istej aplikácie. Po uložení sa zašifruje; nechajte prázdne pre zachovanie existujúceho, alebo vložte nový.
ProstredieSandbox (testovacie prostredie banky so simulovanými platbami) alebo Produkcia (ostrá brána). Predvolené: Sandbox.
Predvolená platobná metóda„Výber na bráne“ nechá zákazníka vybrať si kartu, prevod, QR alebo splátky. Zvolená metóda ho presmeruje rovno na ňu a zmení aj názov platby v pokladni (napr. „Platba kartou“ alebo „Bankový prevod (TatraPay)“).
Typ kartovej transakciePredaj = okamžité zúčtovanie. Preautorizácia = suma sa na karte len zablokuje a z detailu objednávky ju doúčtujete alebo uvoľníte (do 7 dní). Týka sa len platby kartou.

Inštalácia a nastavenie

  1. Otvorte Systém > Pluginy a zapnite plugin TatraPay+ (Tatra banka).
  2. V Nastaveniach vyplňte Client ID a Client secret z developer portálu.
  3. Na developer portáli doplňte do aplikácie Redirect URL https://vasa-domena.sk/payments/tatrapay/return.
  4. Kým platbu testujete, ponechajte Prostredie: Sandbox — sandbox simuluje jednotlivé scenáre (úspešná platba, zamietnutá, čakajúca) a stavy sa menia po 1,5–2 minútach.
  5. Po pridelení produkčného plánu prepnite Prostredie na Produkcia. Client ID zo samostatnej registrácie slúži len na sandbox; na produkciu použite údaje aplikácie s produkčným plánom.

Čo sa deje na objednávke

tatrapay+ nemá webhook — banka e-shopu žiadnu notifikáciu neposiela. Objednávka sa preto označí ako zaplatená dvoma cestami:

  • pri návrate zákazníka z brány si Ecommio podľa identifikátora platby overí stav priamo u banky,
  • automatickou kontrolou každých 5 minút (tatrapay:reconcile-payments), ktorá dohľadá platby, kde zákazník zatvoril okno pred návratom, prevody z inej banky, ktoré sa spracúvajú dlhšie, alebo úver vyplatený až na druhý deň. Kontroluje sa 3 dni od vytvorenia objednávky.

Stav sa nikdy neberie z adresy, na ktorú sa zákazník vrátil — vždy z odpovede banky. Suma a mena sa porovnajú s pôvodnou objednávkou; pri nezhode zostane objednávka nezaplatená a vyžaduje manuálnu kontrolu. Neúspešná platba nechá objednávku nezaplatenú, zákazník ju môže zaplatiť znova; Ecommio si pamätá všetky pokusy, takže platba dokončená v staršom okne sa k objednávke priradí tiež. Ak zákazník zaplatí už stornovanú objednávku, objednávka sa automaticky neotvorí — v logu sa objaví upozornenie na ručnú kontrolu.

Kedy je platba zaplatená podľa metódy: karta po úspešnom zúčtovaní, bankový prevod po pripísaní na váš účet (prevod z inej banky môže chvíľu čakať v stave „spracováva sa“), QR platba po pripísaní, NaSplátkyTB po vyplatení úveru bankou.

Preautorizácia

Pri type transakcie Preautorizácia sa po platbe kartou objednávka dostane do stavu autorizovaná. V detaile objednávky ju potom doúčtujete alebo uvoľníte. Pri doúčtovaní nižšej sumy sa rozdiel zapíše do objednávky ako vrátená suma. Banka vyžaduje ukončenie do 7 dní, inak preautorizácia exspiruje a peniaze sa zákazníkovi uvoľnia automaticky.

Refundácie

Refund cez Ecommio funguje len pri platbe kartou: plná suma sa vracia ako storno transakcie (reversal), čiastočná ako návrat (chargeback). Po prvom čiastočnom vrátení už banka plné storno nepovolí, ďalšie vrátenia idú tiež ako čiastočné. Bankový prevod, QR platbu a splátky vráťte mimo systému (prevodom na účet zákazníka, resp. cez banku) a v objednávke refund zaznamenajte manuálne.

Časté problémy

  • Brána sa v pokladni nezobrazuje. Chýba Client ID alebo Client secret — doplňte ich v nastaveniach.
  • Banka platbu odmietne hneď pri presmerovaní. Najčastejšie chýba Redirect URL v aplikácii na developer portáli alebo aplikácia nemá scope TATRAPAYPLUS. V logu nájdete chybový kód od banky.
  • V sandboxe funguje, v produkcii nie. Aplikácia nemá pridelený produkčný plán, alebo používate Client ID zo sandbox registrácie.
  • Zákazník vidí na bráne menej metód, než čakáte. Metódu musíte mať v zmluve s bankou; splátky navyše vyžadujú sumu v povolenom rozsahu.
  • Objednávka ostala nezaplatená, hoci zákazník platbu dokončil. Počkajte na automatickú kontrolu (do 5 minút); pri prevode z inej banky môže pripísanie trvať dlhšie. Ak sa nič nezmení ani po hodine, skontrolujte, či beží plánovač úloh — pozrite Riešenie problémov v pokladni.
  • Zákazník zrušil platbu na strane banky. Objednávka ostáva nezaplatená a zákazník ju môže dokončiť znova.

Súvisí

Bola táto stránka užitočná?