PrestaShop

Precondiții

  • PrestaShop 1.6, 1.7, 8.1.x sau 9.0.x
  • Acces administrativ la PrestaShop Admin
  • API Key și Secret Word (le obții în aplicația Vendor în secțiunea Companie > Development)
Pentru testare creează un cont de test gratuit aici. API Key și Secret Word le găsești în secțiunea Companie > Development.

Instalarea modulului

1
Descarcă modulul
Apasă aici pentru a descărca cea mai recentă versiune a modulului.
2
Încarcă modulul în PrestaShop
În PrestaShop Admin mergi la Module → Manager module și apasă butonul Încarcă modul (iconița nor în colțul din dreapta sus). Selectează fișierul ZIP descărcat.
3
Instalează modulul
După încărcare PrestaShop afișează modulul Leanpay Payments. Apasă Instalează și așteaptă confirmarea instalării.
4
Deschide configurarea
După instalare apasă Configurează la modulul Leanpay Payments sau mergi la Module → Leanpay → Configurează.
5
Verifică instalarea
În PrestaShop Admin mergi la Module → Manager module și în câmpul de căutare introdu Leanpay.
✓ Modulul Leanpay Payments este vizibil și marcat ca instalat — instalarea a reușit.
Modulul nu este vizibil — verifică dacă fișierul ZIP este corect și consultă log-ul în var/log/.

Actualizarea unui modul mai vechi

Noua versiune a modulului conține modificări ale structurii tabelelor de date. Simpla copiere a fișierelor noi peste cele vechi nu este suficientă — urmează una dintre procedurile de mai jos.

Alege procedura care ți se potrivește mai bine:

Opțiunea 1 — Dezinstalare completă și reinstalare recomandat
  1. Fă o copie de siguranță a tabelelor de date care încep cu ps_leanpay (pentru a păstra istoricul tranzacțiilor).
  2. În PrestaShop Admin dezinstalează vechiul modul Leanpay.
  3. Instalează noua versiune a modulului conform instrucțiunilor de mai sus.
  4. După instalare reintroduce toate setările (API Key, sincronizarea produselor și a prețurilor).
Opțiunea 2 — Resetarea modulului existent
  1. Copiază noua versiune a modulului peste cea existentă (în folderul modules/leanpaypayments/).
  2. În PrestaShop Admin la modulul Leanpay Payments apasă Resetează — sistemul va crea automat noile tabele de date.
  3. După resetare reintroduce toate setările (API Key, sincronizarea produselor și a prețurilor).

Setarea în aplicația Leanpay Vendor

Înainte de utilizarea modulului, în aplicația Leanpay Vendor este necesar să configurezi o promoție pe care modulul o folosește pentru afișarea prețurilor în rate.

În aplicația Vendor mergi la secțiunea Promotions și adaugă o promoție cu următoarele setări:
CâmpValoare
Tipul promoțieiLeanpay Zero
Threshold — perioadă3 luni
Threshold — sumă minimă300 EUR

Configurare

Setările Leanpay le găsești la: Module → Manager module → Leanpay Payments → Configurează

API Key, Secret Word și setarea mediului trebuie să fie întotdeauna corelate — toate pentru mediul de test sau toate pentru mediul de producție. După fiecare modificare nu uita să sincronizezi produsele și prețurile.
SetareValori posibileDescriere
General
ModulActivează / DezactiveazăActivează sau dezactivează Leanpay ca metodă de plată în magazinul tău online.
API Vendor URLURLAdresa punctului final API pentru comunicarea cu sistemul Leanpay. O găsești în aplicația Vendor sub Companie > Development.
Cron URLInformativURL-ul afișat pentru actualizarea automată a prețurilor în rate. Setează-l în sistemul tău cron pentru actualizarea regulată (de ex. zilnică) a prețurilor.
Actualizează prețurile produselorButonActualizare manuală a prețurilor în rate pe paginile produselor. Apasă după fiecare modificare a API Key, a produsului financiar sau a mediului.
Debug modeActivează / DezactiveazăPornește logarea detaliată pentru diagnosticarea problemelor. Lasă dezactivat în producție.
Restricție adrese IPListă de adrese IPDoar pentru testare. Metoda de plată Leanpay va fi vizibilă doar pentru adresele IP specificate. Câmpul gol înseamnă fără restricții.
API & plăți
Sandbox modeActivează / DezactiveazăCând este activat, modulul folosește mediul de test (Sandbox). Când este dezactivat, este activ mediul de producție. Trebuie să corespundă API Key și Secret Word introduse.
Live API Key IntroducereAPI Key pentru mediul de producție. Îl obții în aplicația Vendor sub Companie > Development.
Live Secret Word IntroducereSecret Word pentru mediul de producție, asociat cu Live API Key.
Sandbox API KeyIntroducereAPI Key pentru mediul de test. Îl obții în aplicația Vendor sub Companie > Development.
Sandbox Secret WordIntroducereSecret Word pentru mediul de test, asociat cu Sandbox API Key.
Punct final de piațăSelecțieStabilește punctul final de piață pentru metoda de plată. Selectează piața pe care funcționează magazinul tău online.
Produs financiarSelecțieProdusul financiar Leanpay pentru magazinul tău online. Dacă lista rămâne goală, verifică corectitudinea API Key, a Secret Word și a mediului selectat.
URL-ul paginii informativeURLURL pentru verificarea limitei clientului. Îl găsești în aplicația Leanpay Vendor.
URL pentru mai multe informațiiURL (opțional)Pagina cu informații despre plata cu Leanpay. Dacă lași câmpul gol, se folosește automat pagina Leanpay pentru piața ta.
Setarea plății
Denumirea plățiiCâmp textNumele metodei de plată, afișat clientului la finalizarea comenzii.
Descrierea plățiiCâmp textScurtă descriere a metodei de plată, afișată clientului la selectarea plății.
Status după plata reușităSelecția statusului comenziiStatusul comenzii PrestaShop care se setează după finalizarea cu succes a plății.
Status la plata nereușităSelecția statusului comenziiStatusul comenzii PrestaShop care se setează la o plată eșuată sau anulată.
Valoarea minimă a comenziiNumăr (EUR)Suma minimă a comenzii pentru afișarea metodei de plată Leanpay.
Valoarea maximă a comenziiNumăr (EUR)Suma maximă a comenzii pentru afișarea metodei de plată Leanpay.
Setări vizuale
Afișarea prețurilor în rateActivează / Dezactivează (pentru fiecare locație)Stabilește unde se afișează informația despre rata lunară: pe pagina produsului, în lista de produse, în coș și la finalizarea comenzii.
Mărimea fontuluiNumăr (px)Mărimea fontului pentru blocul de rate Leanpay la fiecare locație în parte.
Poziția blocului de rateSelecția pozițieiStabilește unde pe pagina produsului se afișează blocul de rate (înainte de preț, după preț, după butonul de adăugare în coș etc.). Notă: nu toate temele suportă toate pozițiile.
Custom CSSCâmp text (CSS)Introdu propriile reguli de stil CSS pentru personalizarea afișării elementelor Leanpay în magazinul tău online.

✱ Câmp obligatoriu