Plačilni prehod API: vodnik za implementacijo in testiranje
October 6, 2026
Za varna in skladna WooCommerce plačila v Sloveniji priporočamo plačilni prehod z webhook potrditvami in usklajenim računovodskim tokom, ne zgolj preusmeritev kupca na stran zahvale. Ponudnik omogoča spletna plačila na slovenskem trgu, vrača možnost testnega okolja pred zagonom in delovanje brez mesečnih stroškov. Ključ do zanesljivega delovanja je logiranje webhookov in redno preverjanje statusov naročil, saj se prav tam skriva večina napak pri obračunu.
Na kratko:
- Za zanesljivo obdelavo plačil v Sloveniji je ključno pravilno nastavitev webhookov in preverjanje statusov naročil, zlasti pri prejemu statusa Processing.
- Testno okolje omogoča preverjanje celotne poti plačila, podpisov webhookov in obravnave napak, preden se trgovec odpravi v produkcijo.
- Usklajenost med plačilom in izdajo računa je pomembna, saj se morebitne razlike v DDV pojavijo ob nepravilnih časovnih uskladitvah.
- FURS zahteva od trgovcev samostojno spremljanje pragov za DDV in predloge za povezavo med WooCommerce in eDavki, kar je treba pravočasno preveriti.
- Lokalni ponudnik PosSlo pomaga s celostnimi rešitvami, brez mesečnih stroškov in z instantnimi izplačili, ter omogoča testiranje pred zagonom.
Osnovna konfiguracija za slovenskega trgovca stoji na štirih stebrih: plačilnem prehodu, webhook povezavi, trgovinskem računu in urejenem izdajanju računov. Vsak od njih rešuje drugačen problem, zato jih ne gre obravnavati kot en sam korak namestitve.
Plačilni prehod v WooCommerce se navadno poveže na enega od treh načinov. Hosted payment page (HPP) preusmeri kupca na stran ponudnika, kjer vnese podatke kartice, kar razbremeni trgovca skladnosti s standardom PCI DSS. Payment.js ali podobne knjižnice omogočajo, da polje za kartico ostane vizualno na vaši strani, podatki pa se še vedno pošljejo neposredno ponudniku. Neposredna API integracija daje največ nadzora nad izkušnjo uporabnika, a od trgovca zahteva strožjo skladnost in več vzdrževanja kode.
Izbira med njimi je odvisna od treh dejavnikov:
Bankart kot slovenski ponudnik plačilnega prehoda podpira tako HPP kot payment.js pristop, kar je dober primer, kaj lahko lokalni trg pričakuje od tehnične integracije. PosSlo pri tem nastopi kot izvajalec spletnih plačilnih rešitev, ki trgovcu pomaga povezati spletna plačila za podjetja z obstoječo WooCommerce trgovino, vključno s testnim okoljem pred prehodom v produkcijo.
Postopek zagona po korakih izgloda takole: sklenitev pogodbe s ponudnikom plačil, nastavitev testnega vmesnika na razvojnem okolju, preverjanje webhookov v testnem načinu in šele nato odobritev za produkcijsko okolje. Preskakovanje testne faze je najpogostejši razlog, da trgovci po zagonu odkrijejo neusklajene statuse naročil.
WooCommerce loči štiri ključne statuse naročil: Pending payment, On hold, Failed in Processing. Sistem sam po sebi ne ve, ali je plačilo dejansko uspelo, dokler mu tega ne sporoči zunanji sistem. Prav zato so webhooki tehnično jedro celotne plačilne poti.
Postopek pravilne nastavitve poteka v petih korakih:
Idempotenca ni tehnična podrobnost, ki jo lahko preskočite. Če ponudnik plačil zaradi omrežne napake webhook pošlje dvakrat, brez preverjanja event_id lahko naročilo dvakrat znižate na zalogi ali dvakrat izdate račun.
Strokovni nasvet: Nikoli ne spreminjajte statusa naročila samo zato, ker je kupec uspešno prišel na stran zahvale po preusmeritvi. Redirect pove le, da je brskalnik prišel nazaj na vašo stran, ne da je banka plačilo dejansko potrdila. Počakajte na strežniško potrditev prek webhooka in šele nato naročilo premaknite v status Processing.
Ta razlika med vizualno potrditvijo in dejansko potrditvijo je vir največ nesporazumov med trgovci in strankami, ki so plačale, a naročilo ostane v čakanju.
Gateway reši tehnično stran plačila, ne pa davčne skladnosti. FURS od 1. julija 2021 uporablja posebna pravila za prodajo blaga na daljavo, kar neposredno vpliva na trgovce, ki prodajajo prek spleta znotraj EU. Trgovec mora sam preveriti, ali presega prometne prage, ki sprožijo obveznost DDV identifikacije.
Zahtevek za identifikacijo za DDV se oddaja izključno prek portala eDavki, roki in pragovi pa so vezani na višino prometa v posameznem obračunskem obdobju. To pomeni, da isti WooCommerce sistem, ki deluje brez težav pri majhnem obsegu prodaje, lahko čez nekaj mesecev rasti zahteva povsem drugačno davčno obravnavo.
Pri usklajevanju plačil in računovodstva veljajo tri praktična pravila.
Avtomatizacija te izmenjave zmanjša tveganje človeške napake, a odgovornost za pravilnost podatkov ostaja pri trgovcu, ne pri ponudniku plačilne tehnologije.
End to end test pomeni, da preverite celotno pot, ne le enega dela sistema. Testni scenarij mora zajeti checkout stran, preusmeritev na ponudnika, dostavo webhooka in končni status naročila v WooCommerce administraciji.
Postopek testiranja pred produkcijskim zagonom naj vključuje:
Webhook dnevniki v WooCommerce so prvo mesto, kamor pogledate ob težavi. Če dostava manjka, najpogosteje gre za napačen delivery URL, potekel tajni ključ ali blokado na strani gostovanja. Ponovno vzpostavite secret, preverite URL naslov in sprožite ponovni poskus dostave, preden posumite na napako pri ponudniku plačil.
Stroški spletnih plačil sestavljajo trije elementi: provizija na transakcijo, morebiten strošek najema terminala ali strojne opreme ter enkratni strošek tehnične integracije, zato je pomembna tudi WooCommerce SEO avtomatizacija za izboljšanje vidnosti vaše trgovine. Provizija na transakcijo je največji ponavljajoči se strošek in se med ponudniki razlikuje glede na obseg prometa.
Instantna izplačila neposredno vplivajo na likvidnost. Podjetje, ki čaka na sredstva tri do pet delovnih dni, mora ta čas premostiti z lastnim kapitalom, kar je pri sezonskih trgovcih ali podjetjih z visokim obratom blaga pogosto podcenjen strošek.
Pred podpisom pogodbe s ponudnikom preverite:
PosSlo pri tem izpostavlja tri konkretne prednosti svoje ponudbe: instantna izplačila, poslovanje brez mesečnih stroškov in brezplačno evropsko SIM kartico za prenos podatkov pri fizičnih terminalih. Gre za lastno pozicioniranje ponudnika, ki ga velja preveriti ob dejanski ponudbi glede na obseg vašega poslovanja.
Največja napaka, ki jo vidimo pri slovenskih trgovcih, ni izbira napačnega plačilnega prehoda. Je prepričanje, da namestitev vtičnika pomeni konec dela. Resnična zanesljivost sistema se pokaže šele v primerih, ko webhook zamuja, ko banka pošlje podvojeno obvestilo ali ko kupec plača, a se vrne na stran zahvale z napako v brskalniku.
Konvencionalni nasveti se preveč osredotočajo na izbiro ponudnika in premalo na to, kar se zgodi po prvem uspešnem plačilu.
Če imate čas za samo eno stvar pred zagonom, naj bo to testiranje webhook poti v produkcijskem okolju, ne le v testnem načinu ponudnika. Davčna skladnost pride na vrsto takoj zatem, saj FURS ne razlikuje med namerno in nenamerno napako pri DDV identifikaciji. Lokalna podpora, kot jo ponuja PosSlo, ima pri tem prednost, ker razume specifike slovenskega trga bolje kot generična dokumentacija tujega ponudnika.
— PosSlo
Na trgu so na voljo lokalne alternative tujim plačilnim agregatorjem za slovenska podjetja, ki želijo WooCommerce plačila brez mesečnih stroškov in z izplačili brez večdnevnih zamud.
Postopek sodelovanja je preprost: povpraševanje prek spletne strani, dostop do testnega okolja za preverjanje webhookov in checkout poti, nato prehod v produkcijo s podporo ob morebitnih napakah pri usklajevanju statusov. PosSlo ponuja spletne plačilne rešitve za podjetja, ki jih lahko povežete neposredno z obstoječo WooCommerce trgovino, brez dolgotrajnega vezanja na mesečno naročnino. Za trgovce, ki poleg spletne prodaje potrebujejo tudi fizično sprejemanje kartic, so na voljo tudi klasični POS terminali z evropsko SIM kartico vključeno v ceno. Pred zagonom je priporočljivo preizkusiti konfiguracijo v testnem okolju in preveriti, kako deluje z vašo trgovino, preden preidete v produkcijo.
This article is general information, not a substitute for advice from a qualified financial advisor. Consult a qualified financial professional about your own circumstances before acting on anything here.
Naročilo velja za plačano šele, ko WooCommerce prejme webhook z potrditvijo od ponudnika plačil in status spremeni v Processing. Sama preusmeritev kupca na stran zahvale ni zanesljiv dokaz plačila.
Zahtevek oddate prek eDavkov, ko vaš promet preseže predpisani prag za DDV identifikacijo, pri e-trgovanju znotraj EU pa veljajo posebna pravila od 1. julija 2021. Natančne prage in roke preveri FURS glede na vaš primer.
Najpogosteje gre za manjkajoč ali zavrnjen webhook zaradi napačnega tajnega ključa, spremenjenega delivery URL naslova ali blokade na strežniku. Preverite webhook dnevnike in ponovno sprožite dostavo.
Da, PosSlo omogoča testiranje spletnih plačilnih rešitev pred prehodom v produkcijsko okolje, kar zmanjša tveganje neusklajenih statusov po zagonu.
Natančna višina provizije je odvisna od obsega poslovanja in vrste ponudbe, zato jo PosSlo objavlja na strani s provizijami kartičnih plačil. Ponudba deluje brez mesečnih stroškov in z instantnimi izplačili.
