PrestaShop UPN QR modul — samodejno generiranje QR kod in PDF priponka za bančno nakazilo

PrestaShop in bančno nakazilo: zakaj je QR koda koristna?

PrestaShop je priljubljena platforma za spletno prodajo, ki jo uporablja veliko slovenskih e-trgovin. Kadar kupec izbere plačilo z bančnim nakazilom, mora ročno vpisati IBAN, znesek, referenco in namen plačila — kar je zamudno in pogost vir napak. Rezultat so zamude pri plačilih in dodatno delo pri usklajevanju naročil s prejetimi plačili.

Standard UPN QR ta problem odpravi. Kupec s svojo mobilno banko samo slika QR kodo in vsi podatki za plačilo se samodejno vnesejo. Plačilo potrdi z enim klikom.

Mosaic UPN QR modul za PrestaShop

Mosaic UPN QR je modul za PrestaShop, ki samodejno generira plačilno QR kodo za vsako naročilo plačano z bančnim nakazilom. Modul kodo prikaže na potrditveni strani naročila in k potrditvenemu e-poštnem sporočilu doda PDF priponko z obrazcem UPN.

Podprti formati plačilnih kod

Mosaic UPN QR podpira tri formate, ki jih izberete v nastavitvah modula:

  • UPN QR koda — slovenski standard za plačevanje z mobilno banko po principu "slikaj in plačaj". Podpirajo jo vse večje slovenske banke.
  • EPC koda — European Payments Council standard (znan tudi kot Girocode), primeren za evropska bančna nakazila SEPA. Podpirajo ga številne evropske države, med njimi Avstrija in Hrvaška, ter banke kot so N26, Revolut in druge mobilne banke z SEPA podporo.
  • UPN nalog — vizualna oblika Univerzalnega plačilnega naloga z vsemi podatki za plačilo v obliki slike obrazca.

PDF priponka v potrditvenem e-sporočilu

Potrditveno e-poštno sporočilo kupcu vsebuje PDF priponko z obrazcem UPN. To je bistvena prednost pred rešitvami, ki v e-pošto vdelajo sliko — mnogi e-poštni odjemalci, kot so Outlook, Gmail in Apple Mail, tovrstne vdelane slike privzeto blokirajo ali jih ne prikažejo pravilno. PDF priponka se v e-pošti vedno prikaže pravilno, ne glede na e-poštni odjemalec.

Poleg plačila z mobilno banko ima kupec z PDF obrazcem UPN še eno možnost: obrazec natisne in ga odda kot položnico na banki, pošti ali bencinskih servisih Petrol, ki sprejemajo gotovinska plačila položnic.

Prilaganje PDF-a je mogoče vklopiti ali izklopiti v nastavitvah modula.

Format reference plačila: RF in SI00

PrestaShop reference naročil vsebujejo kombinacijo črk in številk (npr. XWJWXJH). Mosaic UPN QR podpira dva formata reference prejemnika:

  • RF referenca — mednarodni format, ki alfanumerično referenco naročila pretvori v veljavno RF referenco. Priporočena izbira za PrestaShop, saj ohrani povezavo med referenco naročila in plačilom ter omogoča enostavno avtomatizacijo usklajevanja plačil.
  • SI00 referenca — slovenski format na osnovi številčnega ID-ja naročila.

Demonstracijska in produkcijska različica

Modul je po namestitvi takoj pripravljen za testiranje — privzeti demonstracijski API ključ omogoča preizkus delovanja brez kakršnekoli konfiguracije. V demonstracijskem načinu se generirajo plačilni obrazci z vzorčnimi podatki prejemnika (izmišljen IBAN in podatki trgovine).

Za produkcijsko uporabo, kjer obrazec vsebuje vaš dejanski IBAN in podatke vaše spletne trgovine, pridobite osebni API ključ. Vaš IBAN je vgrajen neposredno v API ključ — vsak ključ je tako vezan izključno na en IBAN prejemnika, kar preprečuje zlorabo ključa in zagotavlja, da kupci vedno prejmejo pravilne podatke za plačilo. Ključ pridobite tako, da nam sporočite vaš IBAN; pošljemo vam ga po e-pošti. Cena temelji na predvidenem obsegu uporabe in se obračuna kot letni pavšal.

Namestitev modula

Namestitev poteka neposredno iz PrestaShop nadzorne plošče v treh korakih: naložite ZIP datoteko modula, shranite nastavitve in oddajte testno naročilo. Modul deluje že s privzeto konfiguracijo.

Prenesi namestitveni paket (zip)

Pogosta vprašanja

Na kateri strani se prikaže UPN QR koda?

Koda se prikaže na potrditveni strani naročila, takoj po zaključku nakupa. Privzeto modul skrije PrestaShopove privzete bančne podatke, da kupec ne vidi podvojenih informacij — to vedenje je mogoče spremeniti v nastavitvah.

Ali modul deluje samo z bančnim nakazilom?

Da, modul se aktivira samo za naročila plačana z metodo bančnega nakazila (ps_wirepayment). Za druga plačilna sredstva se ne prikaže.

Zakaj za produkcijsko uporabo potrebujete moj IBAN?

Vaš IBAN je vgrajen neposredno v vaš API ključ. To pomeni, da je vsak ključ vezan izključno na en IBAN prejemnika — generiranje plačilnih obrazcev z drugačnimi podatki tako ni mogoče. S tem zagotovimo, da kupci vedno prejmejo pravilne podatke za plačilo, hkrati pa preprečimo zlorabo ključa.

Kako pridobim API ključ za produkcijsko uporabo?

Pišite nam na info@podjetnikovpomocnik.net ali uporabite kontaktni obrazec in nam sporočite IBAN vašega poslovnega računa. API ključ vam pošljemo po e-pošti.