Plačilni prehod API: vodnik za implementacijo in testiranje
October 6, 2026
Merchant‑initiated vračilo pomeni, da trgovec vrne kupnino na originalno kartico ali račun stranke, in ne obratno. Za izvedbo potrebujete referenco na prvotno transakcijo, znesek pa ne more presegati zneska, ki je bil dejansko plačan. Pri fizičnem POS terminalu uporabite meni za refund ali stornacijo, pri spletni prodaji pa refund sprožite preko plačilnega vmesnika (gateway), ki odziv vrne asinhrono, ponavadi v nekaj minutah.
Na kratko:
- Za vračilo na POS terminalu morate vedno najprej najti originalno transakcijo s pravo referenco, sicer vračilo ni mogoče.
- Pri spletnem vračilu sistem asinhrono potrdi vračilo v približno dveh minutah, banka pa znesek knjiži v nekaj urah do delovnih dni.
- V primeru odstopa od pogodbe v 14 dneh imate obveznost vrniti celoten znesek, pri reklamacijah pa lahko kupec zahteva takojšnje vračilo denarja.
- Najpogostejše napake so napačne ali manjkajoče reference, zato je ključno preveriti, ali je bila transakcija že vrnjena ali stornirana.
- PosSlo omogoča enostavno upravljanje vračil z integracijo referenc in avtomatskimi izplačili brez mesečnih stroškov.
Vsako vračilo kartičnega plačila na terminalu se začne z iskanjem originalne transakcije. Brez te referenčne povezave sistem vračila sploh ne dovoli, kar preprečuje napačne ali podvojene izplačila.
Postopek na terminalu poteka po naslednjem zaporedju:
Za stornacijo terminal pogosto zahteva PIN, datum izvirne transakcije in identifikacijsko številko (STAN). Če teh podatkov ne najdete v lastni zgodovini, boste morali kontaktirati podporo procesnega centra, ki transakcijo poišče na svoji strani.
Preden potrdite vračilo, preverite tudi, ali stranka morda že prejela dobropis ali delno vračilo za isti nakup. Dvojno vračilo je ena najpogostejših napak pri ročnem delu na POS terminalu, zato si vzemite trenutek za primerjavo z blagajniško evidenco.
Strokovni nasvet: Vedno fotografirajte ali shranite potrdilo o vračilu skupaj z originalnim računom, preden ga izročite stranki. Pri morebitnem knjigovodskem nadzoru boste imeli dokaz brez iskanja po arhivu terminala.
Kdor upravlja zavrnjene kartice na POS terminalu, pozna podobno logiko preverjanja: vedno gre za usklajevanje med tem, kar terminal pokaže, in tem, kar dejansko piše na računu stranke.
Pri spletni prodaji postopek vračila plačila poteka drugače kot na fizičnem terminalu, ker refund sprožite prek klica v plačilnem vmesniku, ne prek fizične naprave.
API klic za refund mora vsebovati naslednje elemente:
Odziv na zahtevek za refund pri Bankartovem plačilnem vmesniku ni takojšen. Sistem obdela zahtevek asinhrono in rezultat vrne preko callbackUrl, praviloma v približno dveh minutah. To pomeni, da trgovčev sistem ne sme takoj prikazati “vračilo uspešno”, dokler ne prejme dejanske potrditve po callbacku.
Refund se razlikuje od izplačila (payout). Refund vrne denar nazaj na isto kartico, s katero je bilo opravljeno plačilo. Payout pa je ločeno izplačilo na drug račun ali alias, na primer pri izplačilu dobitka ali nadomestila, kjer ni neposredne povezave s prvotno kartico. Podrobnosti o razlikah med tema dvema procesoma pri hitrih izplačilih pojasnjuje vodič o izplačilih isti dan.
Pri spletnem nakupu ima potrošnik pravico do odstopa od pogodbe v 14 dneh brez obrazložitve, kar pomeni, da mu morate kupnino vrniti v celoti. Pri reklamaciji zaradi napake na izdelku ima kupec pravico izbrati vračilo denarja namesto dobropisa, če to izrecno zahteva — trgovec mu dobropisa ne more vsiliti.
Za lastno zaščito in jasnost do kupcev priporočamo interno politiko z natančnimi roki:
Jasen notranji rok olajša komunikacijo s kupcem in zmanjša tveganje spora, tudi če do dejanskega zahtevka za povračilo pri banki nikoli ne pride.
Največ težav pri vračilu kartičnega plačila nastane zaradi manjkajočih ali napačnih referenc, ne zaradi same tehnologije. Preden potrdite kakršno koli vračilo, sledite temu zaporedju:
Pred vsako potrditvijo vračila preverite tudi, ali znesek ujema izvirno transakcijo in ali gre morda za drugo, podobno naročilo iste stranke.
Strokovni nasvet: Vodite ločen dnevnik vseh sproženih refundov s časom zahteve in časom potrditve. Pri asinhronih sistemih to je edini zanesljiv način, da po nekaj dneh ločite obdelane od “obtičalih” zahtevkov.
Vsako vračilo mora pristati v blagajniški evidenci kot dobropis, povezan s številko originalnega računa, ne kot samostojen zapis brez sledi.
Pri zaključku blagajniške seje primerjajte kartične prilive z obračunom terminala in preverite, ali se število ter zneski vračil ujemajo z evidenco POS sistema. V računovodski zapis vključite:
Dokazila hranite skupaj s knjigovodskimi listinami, saj jih boste potrebovali tudi pri uskladitvi s trgovalnim računom.
Največ vračil, ki jih trgovci sprožijo po nepotrebnem, izvira iz iste napake: refund poskusijo brez pravilne referenčne številke izvirne transakcije. Ko je referenca prisotna, gre postopek skozi brez zapletov, tako na terminalu kot preko API‑ja.
Trgovcem, ki delajo z PosSlo terminali ali spletnimi rešitvami, priporočamo, da imajo dostopna navodila o vikend izplačilih pri roki, saj enaka logika časovnih zamikov velja tudi pri vračilih. Jasna interna politika vračil ostaja najboljša zaščita zaupanja kupcev.
— PosSlo
PosSlo trgovcem ponuja klasične POS terminale, soft POS rešitve, samopostrežne terminale in spletne plačilne rešitve, pri katerih je referenca na originalno transakcijo vgrajena v sam postopek obdelave, brez dodatnih mesečnih stroškov in z instantnimi izplačili.
Za trgovce, ki obravnavajo vračila pogosto, je posebej praktična podpora pri API integraciji spletnih plačil, kjer se referenca na izvirno transakcijo in asinhroni callback obravnavata avtomatsko, brez ročnega usklajevanja v tabelah. Tisti, ki šele začenjajo ali delajo sezonsko, lahko izberejo tudi najem POS terminala brez dolgoročne obveznosti. Vse naprave PosSlo vključujejo brezplačno evropsko SIM kartico za prenos podatkov, kar pomeni, da terminal deluje tudi na dogodkih ali izven poslovnega prostora, ko refund potrebujete takoj, ne šele po vrnitvi v trgovino. Za natančen pregled transakcijskih provizij si oglejte ceno provizij za kartična plačila ali kontaktirajte PosSlo za predlog rešitve, prilagojene vašemu obsegu poslovanja.
Za tehnično in pravno preverjanje postopkov vračila kartičnega plačila so koristni naslednji viri:
Pri spletnih plačilih sistem odziv na zahtevek za refund vrne asinhrono, pogosto v okoli dveh minutah, a dejansko knjiženje na računu stranke opravi banka izdajateljica kartice, kar lahko traja od nekaj ur do nekaj delovnih dni. Na POS terminalu je potrditev vračila običajno takojšnja, knjiženje na kartici pa sledi enakemu bančnemu ciklu.
Da, delno vračilo je dovoljeno, vendar vsota vseh delnih vračil za isto transakcijo ne sme presegati prvotno plačanega zneska. Vsako delno vračilo morate v blagajniški evidenci povezati z isto referenco kot izvirni nakup.
Zahtevajte dokazilo o plačilu, na primer izpisek ali potrdilo o nakupu, in preverite možnost vračila na drug način po lastni interni presoji. Nekateri sistemi omogočajo vračilo na drugo kartico iste stranke, a to je izjema, ki jo je treba posebej evidentirati.
Stornacija razveljavi transakcijo, ki je bila opravljena tik pred tem, in v večini sistemov velja samo za zadnji zapis na terminalu. Refund pa lahko uporabite za starejše transakcije, saj temelji na iskanju po zgodovini in referenci originalnega plačila.
Pri odstopu od pogodbe v 14 dneh in pri utemeljeni reklamaciji ima kupec pravico zahtevati vračilo kupnine, ne pa dobropisa, če to izrecno želi. Trgovec dobropisa ne more vsiliti kot edino možnost, kadar kupec jasno zahteva denar nazaj.
