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

1
Prenesi modul
Klikni tukaj za prenos najnovejše verzije modula.
2
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.
3
Namesti modul
Po nalaganju PrestaShop prikaže modul Leanpay Payments. Klikni Namesti in počakaj na potrditev namestitve.
4
Odpri konfiguracijo
Po namestitvi klikni Konfiguriraj pri modulu Leanpay Payments ali pojdi v Moduli → Leanpay → Konfiguriraj.
5
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/.

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
  1. Varnostno kopiraj podatkovne tabele, ki se začnejo z ps_leanpay (za ohranitev zgodovine transakcij).
  2. V PrestaShop Admin odstrani stari modul Leanpay.
  3. Namesti novo verzijo modula po zgornjim navodilih.
  4. Po namestitvi znova vnesi vse nastavitve (API ključ, sinhronizacija produktov in cen).
Možnost 2 — Ponastavitev obstoječega modula
  1. Kopiraj novo verzijo modula čez obstoječo (v mapo modules/leanpaypayments/).
  2. V PrestaShop Admin pri modulu Leanpay Payments klikni Ponastavi — sistem bo samodejno ustvaril nove podatkovne tabele.
  3. Po ponastavitvi znova vnesi vse nastavitve (API ključ, sinhronizacija produktov in cen).

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:
PoljeVrednost
Vrsta promocijeLeanpay Zero
Threshold — obdobje3 mesece
Threshold — najmanjši znesek300 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.
NastavitevMožne vrednostiOpis
Splošno
ModulOmogoči / OnemogočiAktivira ali deaktivira Leanpay kot plačilno metodo v tvoji spletni trgovini.
API Vendor URLURLNaslov API končne točke za komunikacijo z Leanpay sistemom. Najdeš ga v Vendor aplikaciji pod Podjetje > Development.
Cron URLInformativnoPrikazani URL za samodejno osveževanje cen na obroke. Nastavi ga v svojem cron sistemu za redno (npr. dnevno) posodabljanje cen.
Posodobi cene produktovGumbRočna posodobitev cen na obroke na straneh produktov. Klikni po vsaki spremembi API ključa, finančnega produkta ali okolja.
Debug modeOmogoči / OnemogočiVklopi podrobno beleženje za diagnostiko težav. Pusti izklopljeno v produkciji.
Omejitev IP naslovovSeznam IP naslovovSamo za testiranje. Leanpay plačilna metoda bo vidna le za navedene IP naslove. Prazno polje pomeni ni omejitev.
API & plačila
Sandbox modeOmogoči / OnemogočiKo 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 VnosAPI ključ za produkcijsko okolje. Pridobi ga v Vendor aplikaciji pod Podjetje > Development.
Live Secret Word VnosSecret Word za produkcijsko okolje, povezan z Live API ključem.
Sandbox API KeyVnosAPI ključ za testno okolje. Pridobi ga v Vendor aplikaciji pod Podjetje > Development.
Sandbox Secret WordVnosSecret Word za testno okolje, povezan s Sandbox API ključem.
Tržna končna točkaIzbiraDoloča tržno končno točko za plačilno metodo. Izberi trg, na katerem deluje tvoja spletna trgovina.
Finančni produktIzbiraLeanpay finančni produkt za tvojo spletno trgovino. Če seznam ostane prazen, preveri pravilnost API ključa, Secret Word in izbranega okolja.
URL informacijske straniURLURL za preverjanje limite kupca. Najdeš ga v Leanpay Vendor aplikaciji.
URL za več informacijURL (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čilaBesedilno poljeIme plačilne metode, prikazano kupcu pri zaključku nakupa.
Opis plačilaBesedilno poljeKratek opis plačilne metode, prikazan kupcu pri izbiri plačila.
Status po uspešnem plačiluIzbira statusa naročilaPrestaShop status naročila, ki se nastavi po uspešno zaključenem plačilu.
Status ob neuspešnem plačiluIzbira statusa naročilaPrestaShop 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 obrokeOmogoč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 blokaIzbira pozicijeDoloč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 CSSBesedilno polje (CSS)Vnesi lastne CSS stilske zapise za prilagoditev prikaza Leanpay elementov v tvoji spletni trgovini.

✱ Obvezno polje