# WooQR UPN: UPN QR koda, ki jo kupec plača z enim skenom

Vtičnik za WooCommerce spletne trgovine. UPN nalog s QR kodo. Različica 2.0.1 (15. 10. 2026). Spletna stran: https://wooqr-upn.racunalnicar.eu/ (angleško: https://wooqr-upn.racunalnicar.eu/en/). Avtor: Računalničar, Sebastijan Bandur s.p., Slovenija. Podpora: wooqr-upn@racunalnicar.eu.

WooQR UPN doda na vsako WooCommerce naročilo z bančnim nakazilom UPN QR kodo (QR kodo za plačilo, ki jo poznate s položnic) po standardu ZBS in celoten UPN nalog v PDF-ju. Kupec skenira v svoji mobilni banki, banka izpolni IBAN, znesek in referenco. Brez tipkanja, brez napačnih sklicev, brez zunanjih storitev.

Potrjeno v produkciji: Intesa Sanpaolo, Delavska hranilnica. 20+ slovenskih trgovin. Vse nastane lokalno; podatki ne zapustijo strežnika trgovine. 14 dni vračilo.

## Tole dobi vaš kupec: celoten UPN nalog s QR kodo

Vtičnik nariše obrazec univerzalnega plačilnega naloga (UPN) s QR kodo po milimetrskih koordinatah tehničnega standarda Združenja bank Slovenije (ZBS): potrdilo, nalog, QR koda, prejemnik, znesek, referenca in podatki kupca. Kot slika na strani z zahvalo, kot PDF v e-pošti.

1. QR koda po standardu ZBS. UPN QR v2: ISO-8859-2 z glavo ECI, verzija 15, nivo M, kontrolna dolžina. Natanko to, kar berejo slovenske mobilne banke.
2. Referenca s kontrolno številko. SI12 10014: model, številka naročila in kontrolna številka po modulu 11. Tudi SI00, SI11, SI99 in mednarodni RF.
3. Podatki kupca iz naročila. Ime in naslov za račun se vpišeta v polja plačnika na obrazcu. V QR kodi jih ni; banka jih vzame iz računa plačnika.
4. Rok plačila. Datum naročila plus nastavljeno število dni, zapisan na obrazec in v QR kodo. Po izteku opomin ali preklic, če to vklopite.

Vzorčni nalogi na spletni strani niso izmišljeni: so nalogi za nakup licence Basic (9 €), Pro (29 €) ali Agency (79 €) na avtorjev račun. Podjetja lahko naročijo po predračunu: oddajo podatke za račun prek obrazca, nalog plačajo s skeniranjem, ključ in račun prejmejo po nakazilu (ročno, v 24 urah). Natisnjen PDF ni uradni predtiskani obrazec; plačilo poteka s skeniranjem QR kode.

## Kako deluje: od blagajne do plačila v treh korakih

1. Kupec izbere bančno nakazilo. Na WooCommerce blagajni izbere plačilo po predračunu (BACS) ali katerikoli način plačila, določen v nastavitvah vtičnika.
2. Vtičnik izdela QR kodo in UPN nalog. Lokalno na strežniku trgovine, v istem trenutku: QR koda na strani z zahvalo in v e-pošti, UPN nalog kot PDF priloga. Nobene zunanje storitve.
3. Kupec skenira in potrdi. Odpre mobilno banko, skenira, preveri predizpolnjene podatke in potrdi. Trgovina dobi nakazilo s pravilno referenco.

## Kjerkoli je plačilo: na strani, v e-pošti, v adminu

- E-pošta s PDF prilogo. K sporočilom »naročilo na čakanju« in »račun« se priloži UPN nalog kot PDF (UPN-nalog-1001.pdf): A4 s pismom in podatki naročila ali sam obrazec. QR koda v sporočilu je vdelana (inline priloga), ne zunanja slika, zato jo vidijo tudi v Outlooku in Thunderbirdu, ki zunanje slike blokirata. Prikaz: QR koda s tabelo, slika naloga ali le en stavek.
- Stran z zahvalo in shortcode. QR koda s tabelo podatkov ali celoten nalog čez širino strani, z gumbom za prenos PDF in lastnim obvestilom. Shortcoda [wooqr_upn_qr] in [wooqr_upn_nalog] za FunnelKit, CartFlows, Elementor in e-poštne avtomatizacije.
- Admin pregled naročila. Metabox z QR kodo, podatki in prenosom PDF. Diagnostika, ki pove, katera datoteka in kodiranje sta na zaslonu, ter gumb za regeneracijo, kadar predpomnilnik strani streže staro sliko.

## Tehnični list: kar bi preverila vaš računovodja in vaša banka

- Standard. ZBS UPN QR v2, do zadnjega bajta: dvajset vrstic, ISO-8859-2 z glavo ECI 000004, fiksna verzija 15, nivo M, bajtni način, kontrolna dolžina v bajtih, omejitve dolžin polj po standardu. Enako oddajajo referenčni generatorji (Zint, upn-qr.si). Šumniki č, š, ž so v bančnih aplikacijah pravilni. Proračun vsebine 411 bajtov. IBAN preverjen po MOD-97.
- UPN nalog PDF. Obrazec po milimetrskih koordinatah standarda (A1–A62), barvna razdelka plačnika in prejemnika, strojni vpis v monospace pisavi. PDF in slika nastaneta iz istega izrisa. Potrdilo in nalog, podatki kupca, rok plačila, pri tuji banki tudi BIC. A4 s pismom in lastnim obvestilom ali sam obrazec 210 × 99 mm. PDF priloga, slika na strani, prenos s ključem naročila. Novo v 2.0.
- Rok in opomini. Rok plačila kot datum naročila plus N dni, zapisan na obrazec in v QR kodo. Po izteku, če je vklopljeno: opomin z QR kodo in nalogom ali samodejni preklic naročila, enkrat dnevno (WP-Cron), vsako naročilo enkrat, z opombo k naročilu. WooCommerce sam roka za bančno nakazilo ne pozna. Privzeto izklopljeno. Od 2.0.1 se rok, ki pade na soboto ali nedeljo, lahko premakne na ponedeljek (opcijsko, privzeto izklopljeno).
- Reference. SI00, SI11, SI12, SI99 in RF. Kontrolna številka po modulu 11 pri SI11 in SI12, mednarodni RF po ISO 11649 za celotno območje SEPA. Številka naročila se vključi samodejno, predolg sklic se obravnava varno namesto tihega rezanja.
- Tuja banka. UPN nalog za prodajalca z računom izven Slovenije (Revolut, N26, banka v Avstriji) in kupce s slovenskimi bankami: BIC obvezen in prikazan ob QR kodi, referenca prazna, številka naročila v namenu plačila (koda namena OTHR), država sedeža prejemnika v naslovu, čezmejno SEPA nakazilo v EUR. Standard tuj SEPA IBAN dovoljuje; sprejem po skeniranju preverite s svojo banko.
- Zasebnost. Nič ne zapusti strežnika. QR koda s knjižnico phpqrcode, PDF s tFPDF, oboje bundlano v vtičniku. Slike in PDF-ji v zaščiteni mapi z nepredvidljivimi (HMAC) imeni, izbrisani, ko naročilo ni več v čakanju. Brez pogodb o obdelavi podatkov, brez klicev v tujino. GDPR.
- Vzdrževanje. Samodejne posodobitve (nove različice namesti WordPress sam v ozadju; izklopljivo), WooCommerce HPOS in bloki blagajne, PHP 7.4+. Angleški prevod vmesnika, licenčna sporočila v štirih jezikih. Validacija IBAN po dolžini za vse države SEPA in BIC že ob vnosu.
- Prilagoditve. Poljubno obvestilo pod QR kodo s placeholderji, koda namena po ISO 20022, velikost QR kode. Gumb za prenos PDF z lastnim besedilom, barvo, obliko in velikostjo, s predogledom. Naslov in opis načina plačila na blagajni (»UPN nalog s QR kodo«) sta polji v nastavitvah, ki se z enim klikom zapišeta v WooCommerce (2.0.1). Dvanajst filtrov za razvijalce in dokumentiran shortcode; vse nastavitve na eni strani v WooCommerce.

## Brezplačni UPN QR generator

Na spletni strani je UPN QR generator, ki deluje v brskalniku po istem standardu kot vtičnik: vpišete IBAN, ime prejemnika, znesek, namen in referenco (SI00 + številka naročila), odprete mobilno banko in skenirate; banka ponudi nakazilo na ta IBAN. Nič se ne pošlje nikamor. Stran pokaže tudi dobesedno vsebino QR kode: 19 polj in kontrolno dolžino. Preizkus uporablja samo znake brez šumnikov (ASCII), zato glava ECI ni potrebna; vtičnik v trgovini kodira po ISO-8859-2 z ECI in šumnike prikaže pravilno. URL: https://wooqr-upn.racunalnicar.eu/#upn-qr-generator

## Cene: enkratno plačilo, trajna licenca za uporabo

| Paket | Cena (enkratno, brez DDV) | Spletna mesta | Vključuje |
|---|---|---|---|
| Basic | 9 € | 1 | vse funkcije, tudi UPN nalog PDF; posodobitve 12 mesecev; e-poštna podpora 12 mesecev |
| Pro | 29 € | 5 | vse funkcije; posodobitve 12 mesecev; prednostna podpora 12 mesecev |
| Agency | 79 € | neomejeno | vse funkcije; posodobitve 12 mesecev; prednostna podpora 12 mesecev |

Licenca za uporabo je trajna; vtičnik deluje tudi po izteku posodobitev. Posodobitve in podpora so vključene 12 mesecev; podaljšanje za nadaljnjih 12 mesecev je opcijsko in 15 % ceneje (Basic 7,65 €, Pro 24,65 €, Agency 67,15 €), v licenčnem portalu. Pred iztekom opomnik po e-pošti; nič se ne zaračuna samodejno. Kupci do 8. 10. 2026 obdržijo doživljenjske posodobitve.

Cene so brez DDV (ponudnik ni zavezanec za DDV, 94. člen ZDDV-1). Plačilo prek Stripe: kartica, Apple Pay, Google Pay. 14-dnevno vračilo brez vprašanj. Licenčni ključ prispe po e-pošti takoj po plačilu. Podjetja lahko naročijo tudi po predračunu (UPN nalog) prek obrazca na spletni strani.

Povezave za nakup: Basic https://buy.stripe.com/7sY4gA3CdaNo8Jt5hScZa06 · Pro https://buy.stripe.com/eVq6oI1u508Kf7RbGgcZa09 · Agency https://buy.stripe.com/fZu6oI1u5bRscZJ6lWcZa08 · Licenčni portal https://wooqr-upn.racunalnicar.eu/api/portal

## Pogosta vprašanja

### Kaj je UPN QR koda (univerzalni plačilni nalog s QR kodo)?

UPN je univerzalni plačilni nalog, slovenski standardni obrazec za bančno nakazilo. UPN QR koda je QR koda na tem nalogu, ki po tehničnem standardu Združenja bank Slovenije (ZBS UPN QR) nosi vse podatke plačila: IBAN prejemnika, znesek, referenco (sklic), namen in rok plačila. Plačnik jo skenira v mobilni banki in nakazilo je izpolnjeno brez tipkanja. Vtičnik WooQR UPN tako kodo in cel nalog izdela za vsako WooCommerce naročilo z bančnim nakazilom.

### Je to položnica s QR kodo?

Pogovorno da. »Položnica« je star izraz za plačilni nalog; uradno ime obrazca je UPN (univerzalni plačilni nalog), QR koda na njem pa UPN QR. Vtičnik kupcu na strani z zahvalo in v e-pošti izroči natanko to: položnico s QR kodo za plačilo naročila, ki jo skenira namesto prepisovanja IBAN-a in sklica.

### Ali obstaja brezplačen UPN vtičnik za WooCommerce?

Da. Na wordpress.org je brezplačni GR UPN payment form, ki UPN obrazec s QR kodo pošlje ročno iz menija naročila; samodejni prikaz, e-pošta in shortcode so v njegovi plačljivi različici. Pri WooQR UPN za 9 € enkratno dobite vse samodejno: QR kodo in UPN nalog PDF na strani z zahvalo in v e-pošti, rok plačila z opominom ali preklicem, tujo banko, obvestilo, shortcoda za FunnelKit in Elementor ter samodejne posodobitve. Pred nakupom lahko standard preverite z brezplačnim generatorjem in 14 dni velja vračilo.

### V katerih mobilnih bankah delujejo UPN QR kode?

QR kode so po tehničnem standardu ZBS UPN QR v2, ki ga berejo vse slovenske mobilne banke. Potrjeno v produkciji (resnični kupci plačujejo v živo): Intesa Sanpaolo, Delavska hranilnica. Po standardu (isti format, brez posameznega testa v živo): NLB Klik, mBills, OTP banka (nekdanji Nova KBM in SKB), Gorenjska banka, Addiko, Sparkasse, BKS Bank, Deželna banka Slovenije, LON, hranilnice. Težavo pri katerikoli banki popravimo v roku dneva ali v 14 dneh vrnemo kupnino.

### Ali kupec dobi tudi celoten UPN nalog, ne le QR kode?

Da (od 2.0). Vtičnik izdela PDF z obrazcem UPN QR po standardu ZBS: potrdilo in nalog, QR koda, prejemnik, znesek, referenca, namen, rok plačila ter ime in naslov kupca iz naročila. PDF je priložen istim e-poštnim sporočilom kot QR koda, na strani z zahvalo je gumb za prenos, nalog pa lahko prikažete tudi kot sliko namesto QR kode. Natisnjen izvod ni uradni predtiskani obrazec; plačilo poteka s skeniranjem QR kode.

### Kakšne podatke obdelujete? Gre kaj na zunanji strežnik?

Nič. QR koda in PDF nastaneta lokalno na WordPress strežniku s knjižnicama, ki sta bundlani v vtičniku. IBAN, znesek, referenca in ime prejemnika nikoli ne zapustijo infrastrukture trgovine. QR koda vsebuje samo podatke prejemnika; podatki plačnika ostanejo prazni in jih banka izpolni iz računa, s katerega kupec plačuje. Edini klic navzven je dnevno preverjanje licence na licenčni strežnik (ključ in naslov spletnega mesta), brez podatkov o naročilih.

### Imam račun pri tuji banki (Revolut, N26, Avstrija …), prodajam pa slovenskim kupcem. Deluje?

Da. Vklopite »Imam tujo banko« in izberite državo sedeža prejemnika. Plačilo je potem čezmejno SEPA nakazilo v EUR: vtičnik zahteva BIC in ga prikaže ob QR kodi (standard UPN QR nima polja za BIC, kupčeva banka ga izpelje iz IBAN), referenca je prazna (tuje banke slovenskih modelov SI ne poznajo), številka naročila je v namenu plačila. Priporočena koda namena je OTHR. Standard tuj SEPA IBAN v QR kodi dovoljuje, sprejem po skeniranju pa še ni potrjen pri vseh slovenskih mobilnih bankah. Pred prodajo opravite testni sken s svojo banko.

### Kaj se zgodi po 12 mesecih? Vtičnik preneha delovati?

Ne. Licenca za uporabo je trajna; QR kode in nalogi nastajajo naprej, brez omejitev. Po 12 mesecih se izteče le obdobje posodobitev in podpore: nove različice in e-poštna podpora so na voljo po opcijskem podaljšanju za 12 mesecev, 15 % ceneje od redne cene (Basic 7,65 €, Pro 24,65 €, Agency 67,15 €). Mesec, teden, tri dni in dan pred iztekom prejmete e-poštni opomnik s povezavo za podaljšanje; brez vašega klika se nič ne zaračuna. Datum izteka vidite v WP Admin → WooCommerce → UPN QR → Licenca. Kupci do 8. 10. 2026 imajo doživljenjske posodobitve.

### Ali vtičnik pošlje opomin ali prekliče neplačano naročilo?

Lahko, če to vklopite. WooCommerce sam roka plačila za bančno nakazilo ne pozna; vtičnik enkrat dnevno preveri neplačana naročila, starejša od roka plačila plus dodatnih dni, in po vaši izbiri pošlje opomin (e-pošta z QR kodo in priloženim UPN nalogom) ali naročilo prekliče. Vsako naročilo obdela enkrat in k njemu doda opombo. Privzeto je izklopljeno.

### Se QR koda v e-pošti prikaže tudi v Outlooku in Thunderbirdu?

Da. QR koda (ali slika naloga) je vdelana v samo sporočilo kot inline priloga, ne kot povezava na sliko na strežniku. Odjemalci, ki zunanje slike blokirajo, jo zato prikažejo brez klika »naloži slike«, in koda ostane vidna tudi po tem, ko je naročilo plačano in vtičnik datoteke s strežnika pobriše. Deluje z vsemi pošiljalci, ki gredo skozi PHPMailer (WordPress, SMTP vtičniki); za redke API pošiljalce je v nastavitvah preklop na povezavo. Poleg tega je vedno priložen še PDF.

### Ali deluje s FunnelKit, CartFlows, Elementorjem in custom e-poštnimi šablonami?

Da. Poleg samodejnega prikaza v standardnih WooCommerce hookih sta na voljo shortcoda, ki na poljubno mesto vstavita isti blok: QR kodo s tabelo ali celoten UPN nalog, gumb za PDF in obvestilo.

- `[wooqr_upn_nalog]`: celoten UPN nalog na custom thank-you strani (FunnelKit, CartFlows, Elementor, Bricks); naročilo zazna sam
- `[wooqr_upn_qr mode="qr"]`: QR koda s tabelo podatkov
- `[wooqr_upn_nalog email="1"]`: šablona, ki nadomešča WooCommerce e-pošto
- `[wooqr_upn_nalog order_id="{{order_id}}" key="{{order_key}}" email="1"]`: e-poštna avtomatizacija v ozadju (FunnelKit Automations, Klaviyo …)

Eksplicitni order_id brez ključa naročila ne prikaže ničesar, namenoma. Celotna dokumentacija z vsemi filtri je v nastavitvah vtičnika, zavihek Shortcode.

### Ali deluje samo v Sloveniji? Kaj z EU kupci?

UPN QR je slovenski standard za kupce s slovensko mobilno banko. Druge države uporabljajo svoje formate (Hrvaška HUB-3A, Nemčija in Avstrija EPC QR, Češka SPAYD). Za slovensko trgovino, ki prodaja tudi v EU: slovenski kupci skenirajo QR, EU kupci plačajo po običajnem SEPA nakazilu, IBAN in BIC sta v e-pošti tako ali tako. EPC QR ali HUB-3A dodamo, če bo dovolj povpraševanja.

### Katere zahteve ima vtičnik?

WordPress 6.0+, PHP 7.4+ z razširitvijo GD (standard na vseh slovenskih gostiteljih), WooCommerce 7.0+. HPOS združljivo. Brez zunanjih odvisnosti.

### Ali se spreminja obstoječi proces plačila?

Ne. Vtičnik samo doda QR kodo in UPN nalog k obstoječemu načinu plačila z bančnim nakazilom. Kupec lahko še vedno plača ročno; QR je dodatna, hitrejša pot. Plačana ali preklicana naročila kupcu kode ne kažejo več, da ne pride do dvojnih nakazil.

### Kaj če mi ne ustreza, ali dobim denar nazaj?

Da, 14 dni po nakupu brez navedbe razloga (43. člen ZVPot). Pišite na wooqr-upn@racunalnicar.eu.

### Kako dobim licenčni ključ po nakupu?

Takoj po plačilu prek Stripe prispe e-pošta s ključem in povezavo za prenos. Ključ vpišete v WooCommerce → UPN QR → Licenca in kliknete »Preveri licenco«. Ključ in aktivirana mesta kadarkoli vidite v licenčnem portalu (https://wooqr-upn.racunalnicar.eu/api/portal), kamor se prijavite z e-poštnim naslovom.

## Kdo stoji za tem

Računalničar, Sebastijan Bandur s.p., Marjeta na Dravskem polju (https://racunalnicar.eu). WordPress in WooCommerce vtičnike razvija za slovenske spletne trgovine; WooQR UPN je nastal, ker so kupci v lastnih trgovinah tipkali napačne sklice. Standard ZBS je prebral v celoti, QR kode preverja v resničnih bančnih aplikacijah, in spletna stran loči, kaj je potrjeno in kaj ne. Podpora: wooqr-upn@racunalnicar.eu, odgovor praviloma isti delovni dan.

Tudi iz Računalničar s.p.: AgenticWP, AI agent toolkit za WordPress (Claude Code, Cursor, Windsurf ali katerikoli MCP-združljivi AI agent upravlja WordPress spletna mesta prek 30+ REST endpointov, Elementor, WooCommerce, Astra): https://agenticwp.racunalnicar.eu/