Odkiaľ získam MID a Shared Secret?

Od Tatra banky po aktivácii služby CardPay alebo TatraPay. Banka ich zasiela poštou, spravidla do 5 pracovných dní.

Nastavil som bránu, ale na faktúre tlačidlá nie sú.

Skontrolujte, či je brána aj zapnutá prepínačom, či doklad nie je už uhradený, či má nenulovú sumu a variabilný symbol a či je pre klienta vytvorený verejný odkaz.

Musím platbu po zaplatení ešte niekde potvrdiť?

Nie. Monivio si potvrdenie z brány overí podpisom, založí bankovú transakciu, zaeviduje platbu k dokladu a posunie jeho stav.

Čo ak klient zaplatí len časť sumy?

Doklad prejde do stavu čiastočne uhradený a zvyšok zostáva otvorený — rovnako ako pri čiastočnej platbe prevodom.

Je rozdiel medzi CardPay a TatraPay?

CardPay je platba platobnou kartou, TatraPay presmeruje klienta do internetbankingu Tatra banky. Môžete zapnúť obe naraz — klient si vyberie.

Kto v tíme smie brány nastaviť?

Iba administrátor organizácie. Ostatné roly integrácie vidia, ale tlačidlá na nastavenie majú neaktívne.

Ako si overím, že sú údaje správne?

Pri nastavenej bráne je tlačidlo Otestovať funkčnosť — overí kombináciu MID a shared secretu bez toho, aby ste museli poslať faktúru klientovi.

Platba kartou na faktúre (CardPay a TatraPay)

Čo to klientovi umožní

Keď klientovi pošlete faktúru s verejným odkazom, na stránke uvidí okrem QR kódu aj tlačidlá na okamžitú online platbu:

Zaplatiť kartou — cez bránu CardPay
Zaplatiť cez TatraPay — presmerovanie do internetbankingu Tatra banky

Predpoklady

Máte v Tatra banke aktivovanú službu CardPay alebo TatraPay a od banky ste dostali MID (Merchant ID) a Shared Secret. Banka ich zasiela poštou spravidla do 5 pracovných dní po aktivácii.
Ste administrátor organizácie — iné roly integráciu nastaviť nevedia.
Na doklade máte verejný odkaz a variabilný symbol.

Krok 1: Otvorte platobné brány v integráciách

Prejdite do Nastavenia → Integrácie, sekcia Platobné brány.

Sekcia Platobné brány v nastaveniach integrácií — CardPay a TatraPay sa nastavujú samostatne — každá má vlastné tlačidlo Nastaviť.

V zozname vidíte aj brány označené ako Čoskoro — tie zatiaľ nastaviť nejde.

Krok 2: Zadajte MID a Shared Secret

Kliknite na Nastaviť pri bráne, ktorú chcete zapojiť, a prepíšte údaje z listu od banky.

Nastavenie CardPay — MID a Shared Secret — Shared secret sa ukladá zašifrovaný a po uložení sa už nezobrazuje.

Po uložení sa pri bráne objaví štítok Nastavené.

Krok 3: Bránu zapnite

Konfigurácia sama o sebe nestačí — bránu ešte prepnite prepínačom vpravo. Kým nie je nastavená, prepínač je neaktívny.

Zapnutá platobná brána so štítkom Nastavené a maskovanými údajmi — Zapnutá brána sa hneď premietne na verejné stránky vašich dokladov.

Pri zapnutej bráne vidíte uložené údaje v maskovanej podobe a tlačidlo Otestovať funkčnosť — overí, že kombinácia MID a shared secretu sedí.

Krok 4: Ako to vidí klient

Na verejnej stránke dokladu pribudne blok Online platba s tlačidlami. Klient klikne, presmeruje sa na bránu Tatra banky a po zaplatení sa vráti späť.

Verejná stránka faktúry s tlačidlami Zaplatiť kartou a Zaplatiť cez TatraPay — Tlačidlá sa zobrazia len pri nezaplatenom doklade s nenulovou sumou.

Tlačidlá sa nezobrazia, ak:

doklad je už uhradený,
suma je nulová,
doklad nemá variabilný symbol,
mena dokladu nie je bránou podporovaná.

Čo sa stane po úspešnej platbe

Monivio si potvrdenie z brány overí podpisom a potom:

založí bankovú transakciu so sumou a variabilným symbolom z platby,
eviduje platbu k dokladu,
podľa uhradenej sumy posunie stav dokladu (čiastočne uhradená / uhradená).

Nemusíte teda čakať na bankový výpis ani nič párovať ručne — to rieši párovanie platieb z banky len pre prevody mimo brány.

Shared secret je citlivý údaj — je to podpisový kľúč vašich platieb. Nikam ho neposielajte e-mailom a pri podozrení si od banky vyžiadajte nový.

Čo ďalej?

Verejný odkaz a QR platba — ako sa klient k stránke s platbou vôbec dostane
Párovanie platieb z banky — pre platby prevodom
Predvolené hodnoty dokladov — zapnutie QR kódu a verejnej URL