PrestaShop

Predpogoji

✓
PrestaShop 1.6, 1.7, 8.1.x ali 9.0.x
✓
Skrbniški dostop do PrestaShop Admin
✓
API Key in Secret Word (dobiš ga v Vendor aplikaciji v razdelku Podjetje > Development)

ℹ Za testiranje ustvari brezplačni testni račun tukaj. API ključ in Secret Word najdeš v razdelku Podjetje > Development.

Namestitev modula

Prenesi modul

Klikni tukaj za prenos najnovejše verzije modula.

Naloži modul v PrestaShop

V PrestaShop Admin pojdi v Moduli → Upravitelj modulov in klikni gumb Naloži modul (ikona oblaka v zgornjem desnem kotu). Izberi prenešeno ZIP datoteko.

Namesti modul

Po nalaganju PrestaShop prikaže modul Leanpay Payments. Klikni Namesti in počakaj na potrditev namestitve.

Odpri konfiguracijo

Po namestitvi klikni Konfiguriraj pri modulu Leanpay Payments ali pojdi v Moduli → Leanpay → Konfiguriraj.

Preveri namestitev

V PrestaShop Admin pojdi v Moduli → Upravitelj modulov in v iskalno polje vpiši Leanpay.

✓ Modul Leanpay Payments je viden in označen kot nameščen — namestitev je uspešna.

Modul ni viden — preveri, ali je ZIP datoteka pravilna, in si oglej log v var/log/.

Vnesi API URL v Leanpay Vendor platformo

V konfiguraciji modula (Moduli → Leanpay → Konfiguriraj) kopiraj vrednost polja API Vendor URL. Nato se prijavi v Leanpay Vendor platformo pod Podjetje > Development, vnesi kopirani URL v ustrezno polje in shrani spremembe. Brez tega koraka trgovina ne bo prejemala posodobitev statusov naročil.

Nadgradnja starejšega modula

Nova verzija modula vsebuje spremembe strukture podatkovnih tabel. Preprosto kopiranje novih datotek čez stare ne zadostuje — sledi enemu od spodnjih postopkov.

Izberi postopek, ki ti bolj ustreza:

Možnost 1 — Čista odstranitev in ponovna namestitev priporočeno

Varnostno kopiraj podatkovne tabele, ki se začnejo z ps_leanpay (za ohranitev zgodovine transakcij).
V PrestaShop Admin odstrani stari modul Leanpay.
Namesti novo verzijo modula po zgornjim navodilih.
Po namestitvi znova vnesi vse nastavitve (API ključ, sinhronizacija produktov in cen).
Kopiraj vrednost polja API Vendor URL iz konfiguracije modula, prijavi se v Leanpay Vendor platformo pod Podjetje > Development, vnesi URL v ustrezno polje in shrani spremembe.
Klikni gumb Preveri konfiguracijo, da preveriš, ali so API ključ, Secret Word, okolje in API Vendor URL pravilno povezani z Leanpay sistemom. Nato klikni Posodobi cene produktov, da se cene na obroke na straneh izdelkov takoj posodobijo z novo verzijo modula.

Možnost 2 — Ponastavitev obstoječega modula

Kopiraj novo verzijo modula čez obstoječo (v mapo modules/leanpaypayments/).
V PrestaShop Admin pri modulu Leanpay Payments klikni Ponastavi — sistem bo samodejno ustvaril nove podatkovne tabele.
Po ponastavitvi znova vnesi vse nastavitve (API ključ, sinhronizacija produktov in cen).
Kopiraj vrednost polja API Vendor URL iz konfiguracije modula, prijavi se v Leanpay Vendor platformo pod Podjetje > Development, vnesi URL v ustrezno polje in shrani spremembe.
Klikni gumb Preveri konfiguracijo, da preveriš, ali so API ključ, Secret Word, okolje in API Vendor URL pravilno povezani z Leanpay sistemom. Nato klikni Posodobi cene produktov, da se cene na obroke na straneh izdelkov takoj posodobijo z novo verzijo modula.

Nastavitev v Leanpay Vendor aplikaciji

Pred uporabo modula je v Leanpay Vendor aplikaciji potrebno nastaviti promocijo, ki jo modul uporablja za prikaz cen na obroke.

ℹ V Vendor aplikaciji pojdi v razdelek Promotions in dodaj promocijo z naslednjimi nastavitvami:

Polje	Vrednost
Vrsta promocije	Leanpay Zero
Threshold — obdobje	3 mesece
Threshold — najmanjši znesek	300 EUR

Konfiguracija

Nastavitve Leanpay najdeš pod: Moduli → Upravitelj modulov → Leanpay Payments → Konfiguriraj

⚠ API ključ, Secret Word in nastavitev okolja morajo biti vedno usklajeni — vsi za testno ali vsi za produkcijsko okolje. Po vsaki spremembi ne pozabi sinhronizirati produktov in cen.

Nastavitev	Možne vrednosti	Opis
Splošno
Modul	Omogoči / Onemogoči	Aktivira ali deaktivira Leanpay kot plačilno metodo v tvoji spletni trgovini.
API Vendor URL	URL	Naslov API končne točke za komunikacijo z Leanpay sistemom. Najdeš ga v Vendor aplikaciji pod Podjetje > Development.
Cron URL	Informativno	Prikazani URL za samodejno osveževanje cen na obroke. Nastavi ga v svojem cron sistemu za redno (npr. dnevno) posodabljanje cen.
Posodobi cene produktov	Gumb	Ročna posodobitev cen na obroke na straneh produktov. Klikni po vsaki spremembi API ključa, finančnega produkta ali okolja.
Debug mode	Omogoči / Onemogoči	Vklopi podrobno beleženje za diagnostiko težav. Pusti izklopljeno v produkciji.
Omejitev IP naslovov	Seznam IP naslovov	Samo za testiranje. Leanpay plačilna metoda bo vidna le za navedene IP naslove. Prazno polje pomeni ni omejitev.
API & plačila
Sandbox mode	Omogoči / Onemogoči	Ko je vklopljeno, modul uporablja testno okolje (Sandbox). Ko je izklopljeno, je aktivno produkcijsko okolje. Mora ustrezati vnesenemu API ključu in Secret Word.
Live API Key ✱	Vnos	API ključ za produkcijsko okolje. Pridobi ga v Vendor aplikaciji pod Podjetje > Development.
Live Secret Word ✱	Vnos	Secret Word za produkcijsko okolje, povezan z Live API ključem.
Sandbox API Key	Vnos	API ključ za testno okolje. Pridobi ga v Vendor aplikaciji pod Podjetje > Development.
Sandbox Secret Word	Vnos	Secret Word za testno okolje, povezan s Sandbox API ključem.
Tržna končna točka	Izbira	Določa tržno končno točko za plačilno metodo. Izberi trg, na katerem deluje tvoja spletna trgovina.
Finančni produkt	Izbira	Leanpay finančni produkt za tvojo spletno trgovino. Če seznam ostane prazen, preveri pravilnost API ključa, Secret Word in izbranega okolja.
URL informacijske strani	URL	URL za preverjanje limite kupca. Najdeš ga v Leanpay Vendor aplikaciji.
URL za več informacij	URL (neobvezno)	Stran z informacijami o plačilu z Leanpay. Če polje pustiš prazno, se samodejno uporabi Leanpay stran za tvoj trg.
Nastavitev plačila
Naziv plačila	Besedilno polje	Ime plačilne metode, prikazano kupcu pri zaključku nakupa.
Opis plačila	Besedilno polje	Kratek opis plačilne metode, prikazan kupcu pri izbiri plačila.
Status po uspešnem plačilu	Izbira statusa naročila	PrestaShop status naročila, ki se nastavi po uspešno zaključenem plačilu.
Status ob neuspešnem plačilu	Izbira statusa naročila	PrestaShop status naročila, ki se nastavi ob neuspelem ali preklicanem plačilu.
Najmanjša vrednost nakupa	Število (EUR)	Minimalni znesek nakupa za prikaz Leanpay plačilne metode.
Najvišja vrednost nakupa	Število (EUR)	Maksimalni znesek nakupa za prikaz Leanpay plačilne metode.
Vizualne nastavitve
Prikaz cen na obroke	Omogoči / Onemogoči (za vsako lokacijo)	Nastavi, kje se prikazuje informacija o mesečnem obroku: na strani produkta, v seznamu produktov, v košarici in pri zaključku nakupa.
Velikost pisave	Število (px)	Velikost pisave za Leanpay obrončni blok na posamezni lokaciji.
Položaj obrončnega bloka	Izbira pozicije	Določa, kje na strani produkta se prikaže obrončni blok (pred ceno, za ceno, za gumbom za košarico itd.). Opomba: vse teme ne podpirajo vseh položajev.
Custom CSS	Besedilno polje (CSS)	Vnesi lastne CSS stilske zapise za prilagoditev prikaza Leanpay elementov v tvoji spletni trgovini.

✱ Obvezno polje