Namestitev soft POS: od prenosa aplikacije do prvega plačila
October 21, 2026
Plačilni API je programski vmesnik, prek katerega vaša spletna trgovina, aplikacija ali rezervacijski sistem sproži plačilo, prejme potrditev in zapiše transakcijo, ne da bi kupec zapustil vaš proces nakupa. Slovensko podjetje, ki išče plačilni API, se običajno odloča med štirimi tipi vmesnikov: API plačilnega prehoda za kartična plačila, bančni API po direktivi PSD2, API sistema UJP e-plačila za javni sektor in povezave z davčnim potrjevanjem računov. Ta vodnik pojasni, kateri tip potrebujete, katera pravila veljajo v Sloveniji, kako poteka integracija od testnega okolja do produkcije in po katerih merilih ocenite ponudnika.
API (Application Programming Interface) je dogovorjen način, kako dva sistema izmenjujeta podatke. Pri plačilih to pomeni, da vaš sistem pošlje zahtevo (znesek, valuta, številka naročila, povratni naslov), ponudnik pa vrne odgovor (odobreno, zavrnjeno, v obdelavi) in kasneje še obvestilo o končnem stanju.
Tipičen plačilni API pokriva naslednje funkcije:
Pomembna razlika: API je le vmesnik. Za njim stoji ponudnik plačilnih storitev, ki dejansko obdela transakcijo, nosi regulatorne obveznosti in vam izplača sredstva. Zato pri izbiri ne ocenjujete samo dokumentacije, ampak predvsem ponudnika. Podrobnejšo razlago pojmov najdete v vodniku kaj je plačilni prehod.
Izraz »plačilni API« se v slovenskem okolju uporablja za zelo različne stvari. Preden začnete pisati kodo ali zbirati ponudbe, določite, katero vrsto dejansko potrebujete.
| Vrsta API-ja | Komu je namenjen | Kaj omogoča | Kdo ga zagotavlja |
|---|---|---|---|
| API plačilnega prehoda | spletne trgovine, aplikacije, rezervacijski sistemi | kartična in druga spletna plačila, vračila, ponavljajoča plačila | ponudnik plačilnih storitev z dovoljenjem |
| PSD2 / open banking API | licencirani ponudniki storitev (TPP) | vpogled v račune (AIS), odreditev plačila z računa (PIS) | banke, ki vodijo plačilne račune |
| UJP e-plačila | organi javne uprave z e-storitvami | plačilo upravnih in drugih e-storitev | Uprava RS za javna plačila |
| API za davčno potrjevanje | blagajniški in računovodski sistemi | izdaja računov v skladu z davčnimi pravili | razvijalci blagajn in programskih modulov |
To je vmesnik, ki ga potrebuje večina malih in srednjih podjetij. Kupec na vaši strani izbere plačilo s kartico ali drugo metodo, prehod izvede preverjanje in avtorizacijo, vi pa prejmete potrditev. Na voljo so tri stopnje integracije:
Za večino spletnih trgovin je smiselna prva ali druga možnost. Tehnični postopek po korakih opisujemo v vodniku plačilni prehod API: implementacija in testiranje.
Slovenske banke morajo licenciranim tretjim ponudnikom omogočiti dostop do plačilnih računov strank prek namenskih vmesnikov. Večina jih sledi standardu Berlin Group NextGenPSD2 in objavlja razvijalske portale s testnim peskovnikom ter produkcijskim prehodom. Ti vmesniki omogočajo dve glavni storitvi: storitev zagotavljanja informacij o računih (AIS) in storitev odreditve plačil (PIS).
Za trgovca je bistveno naslednje: do teh API-jev lahko neposredno dostopa le ponudnik z ustreznim dovoljenjem. Spletna trgovina, ki želi sprejemati plačila neposredno z bančnega računa kupca, zato to storitev običajno uporablja prek ponudnika, ki je dovoljenje že pridobil, in ne gradi lastne povezave z vsako banko.
Organi javne uprave, ki ponujajo plačljive e-storitve, uporabljajo sistem UJP e-plačila. Uprava RS za javna plačila objavlja tehnična navodila za API vmesnik UJP e-plačila, ki opisujejo plačevanje e-storitve in postopek vključevanja nove e-storitve, vključno s testiranjem. Za zasebna podjetja ta sistem ni namenjen, je pa uporaben zgled, kako je urejen postopek od testa do produkcije.
Plačilo in račun sta v praksi povezana: ko API potrdi plačilo, mora vaš sistem izdati pravilen račun. Pri prodaji končnim kupcem v Sloveniji se to lahko sreča z obveznostjo davčnega potrjevanja računov. Ali in kako ta velja za vaš način prodaje, preverite pri svojem računovodji ali na FURS, preden povežete plačilni in blagajniški sistem.
Plačilne storitve so urejene na ravni EU z direktivo o plačilnih storitvah (PSD2), ki je bila v slovensko pravo prenesena z Zakonom o plačilnih storitvah, storitvah izdajanja elektronskega denarja in plačilnih sistemih (ZPlaSSIED). Za trgovca, ki vgrajuje plačilni API, so v praksi pomembna tri vprašanja.
Plačilne storitve in izdajo elektronskega denarja lahko opravljajo le subjekti z ustreznim dovoljenjem. Banka Slovenije vodi centraliziran register plačilnih institucij, institucij za izdajo elektronskega denarja in ponudnikov storitev zagotavljanja informacij o računih, v katerem so tudi njihovi zastopniki in podružnice. Ponudniki iz drugih držav EU lahko storitve v Sloveniji opravljajo na podlagi dovoljenja v matični državi. Preden podpišete pogodbo, preverite:
Ko ste v dvomih, odgovore na pogosta vprašanja o nadzoru nad plačilnimi storitvami najdete na strani pogosta vprašanja Banke Slovenije.
To je pogosto vprašanje pri nastavljanju blagajne. Banka Slovenije v pojasnilu o prepovedi doplačil pri kartičnih plačilih navaja, da doplačila za plačilne instrumente, za katere velja Uredba (EU) 2015/751, niso dovoljena, morebitna druga nadomestila pa morajo biti kupcu jasno sporočena, preden odredi plačilo. V praksi to pomeni, da pri potrošniških karticah pribitka za plačilo s kartico ne prištevate v API zahtevo. Podrobnosti po vrstah kartic razlaga članek prenos provizije na kupca: kaj sme trgovec zaračunati.
Če uporabljate gostujočo plačilno stran ali vgrajeni obrazec ponudnika, kartičnih podatkov vaš strežnik ne vidi. To bistveno zmanjša vaše varnostne obveznosti. Pri neposredni integraciji podatke obdeluje vaš sistem, kar pomeni strožje varnostne zahteve in višje stroške skladnosti. Za malo podjetje je to eden najmočnejših razlogov, da ne izbere neposredne integracije.
Ne glede na ponudnika ima integracija plačilnega API-ja podoben potek. Spodnji koraki veljajo za tipično spletno trgovino ali rezervacijski sistem.
Najpogostejše napake, ki jih vidimo pri prehodu v produkcijo:
Tehnično so si plačilni API-ji podobni. Razlike, ki vplivajo na vaš dobiček, so v pogojih poslovanja. Spodnja tabela povzema merila, ki jih priporočamo preveriti pri vsaki ponudbi.
| Merilo | Kaj vprašati | Zakaj je pomembno |
|---|---|---|
| Dovoljenje | Kdo je pravna oseba in kje ima dovoljenje? | zakonitost in zaščita sredstev |
| Provizija | Koliko znaša na transakcijo, po vrstah kartic in za tuje kartice? | največji del stroškov pri rasti prometa |
| Fiksni stroški | Ali obstaja mesečna naročnina, pristojbina za odprtje ali minimalni promet? | pri sezonskem ali nizkem prometu odločilno |
| Izplačila | V kolikšnem času so sredstva na voljo? | denarni tok, zlasti pri malih podjetjih |
| Valute | V katerih valutah lahko sprejemate plačila in kako se pretvarjajo? | tuji kupci, turizem |
| Dokumentacija | Ali sta na voljo peskovnik in vtičniki za vašo platformo? | čas in strošek razvoja |
| Fizična plačila | Ali isti ponudnik omogoča tudi POS terminal ali soft POS? | eno poročilo, ena pogodba, en pregled |
| Podpora | Ali je podpora dosegljiva v vašem jeziku in ob vaših delovnih urah? | hitrejše reševanje zapletov |
Primerjajte celoten strošek na letni ravni, ne le odstotka na transakcijo. Mesečna naročnina pri nizkem prometu hitro preseže razliko v proviziji. Za izračun po vrstah kartic uporabite vodnik provizije kartičnih plačil za trgovce.
Hoteli, hostli, organizatorji dogodkov in spletne trgovine pogosto prejemajo plačila tujih kupcev. Pri teh je treba poleg provizije preveriti, v kateri valuti kupec plača, kdaj se znesek pretvori in po katerem tečaju. Tečajne razlike se nato pokažejo v poslovnem izidu, zato je dobro, da jih računovodstvo spremlja sistematično; uporaben pregled ponuja članek o tem, kako pravilno upoštevati vpliv valut na poslovne rezultate. Praktične možnosti za slovenska podjetja opisujemo v članku kako podjetja sprejemajo tuja plačila.
Če vaša trgovina teče na razširjeni platformi, preverite, ali ponudnik ponuja hotov vtičnik. Ta pokrije večino zgornjih korakov brez programiranja, vi pa nastavite le ključe in pravila. Lastna integracija prek API-ja je smiselna, ko imate rezervacijski sistem po meri, mobilno aplikacijo ali posebne scenarije, kot je predavtorizacija.
Veliko malih podjetij išče API, v resnici pa potrebuje preprostejšo rešitev. Preden naročite razvoj, preverite, ali vaš primer pokrije ena od teh možnosti:
Samostojni podjetniki lahko izbiro zožijo s pomočjo vodnika spletna plačila za s.p.. Splošni pregled, kaj mala podjetja na spletu resnično potrebujejo, je v članku spletna plačila za podjetja.
Pri svetovanju slovenskim podjetjem opažamo, da se pogovor prepogosto začne pri tehnologiji. Lastnik salona, hostla ali food trucka vpraša za API, ker ga je omenil razvijalec, v resnici pa potrebuje predvsem tri stvari: da kupec plača brez zapletov, da denar hitro prispe na račun in da ga rešitev ne stane ničesar v mesecih, ko je prometa malo.
Zato svetujemo, da najprej opredelite, kje vse kupci plačujejo: v lokalu, na terenu, na spletu ali na avtomatu. Šele nato izberite tehnično obliko. Podjetje, ki sprejema plačila na več mestih, ima največ koristi od ponudnika, pri katerem so terminal, soft POS in spletna plačila povezani z istim računom in istim poročilom. Tako odpade ročno usklajevanje več virov.
Kot uradni prodajalec rešitev myPOS v Sloveniji ponujamo prav takšno povezano celoto: klasične, soft POS in samopostrežne terminale ter spletne plačilne rešitve, brez mesečnih stroškov, s takojšnjimi izplačili in konkurenčnimi provizijami. Lastni razvoj prek API-ja priporočamo, ko imate sistem po meri. Za vse ostalo je hitrejša in cenejša pot vtičnik ali plačilna povezava.
— PosSlo
PosSlo slovenskim podjetjem ponuja spletne plačilne rešitve, ki jih lahko povežete s klasičnim POS terminalom ali soft POS aplikacijo na telefonu. Odprtje je brezplačno, mesečnih stroškov ni, izplačila so takojšnja, vsi terminali pa vključujejo brezplačno podatkovno SIM kartico za vso Evropo. Če plačila sprejemate tudi na terenu, si oglejte še soft POS rešitve za naprave Android.
Praviloma ne. Dostop do PSD2 vmesnikov bank imajo licencirani tretji ponudniki, ki morajo imeti ustrezno dovoljenje nadzornika. Trgovec plačila z bančnega računa običajno sprejema prek ponudnika, ki je to dovoljenje že pridobil.
Pravno ime ponudnika poiščite v registru Banke Slovenije ali v registru nadzornika države EU, v kateri ima dovoljenje. Preverite tudi, ali se pravna oseba v pogodbi ujema z vpisom. Dodatno ocenite dokumentacijo, peskovnik in dosegljivost podpore.
Z vtičnikom za razširjeno spletno platformo je plačilo lahko vzpostavljeno v enem dnevu. Lastna integracija z webhooki, vračili in testiranjem v peskovniku običajno zahteva več dni razvoja. Čas je odvisen predvsem od števila plačilnih scenarijev, ki jih potrebujete.
Za potrošniške kartice, za katere velja Uredba (EU) 2015/751, doplačila niso dovoljena. Pri drugih plačilnih instrumentih mora biti morebitno nadomestilo kupcu jasno prikazano pred plačilom. V dvomih se posvetujte s ponudnikom plačilnih storitev ali pravnim svetovalcem.
Ne. Za prodajo na lokaciji zadošča POS terminal ali soft POS aplikacija, ki delujeta brez programiranja. API postane smiseln, ko želite plačila povezati z lastnim spletnim, rezervacijskim ali naročniškim sistemom.
