Back
Leanpay Romania

Integration with Leanpay

1 - Awareness 2 - Instalment Prices 3 - Pre-qualify 4 - Payment Method 5 - Terms and Conditions

PLUGINS

Magento OpenCart PrestaShop Shopify WooCommerce

API integration

API integration Overview Standard Custom

TESTING INTEGRATION

Testing integration Register demo account API key and secret word My first purchase

WooCommerce

Modificarea API Vendor URL
În noua versiune a plugin-ului s-a modificat API Vendor URL. După upgrade, acesta trebuie obligatoriu actualizat și în profilul Leanpay Vendor, sub Companie > Development, altfel magazinul tău nu va primi actualizările de stare a comenzilor.

Cerințe preliminare

  • ✓
    WordPress 6.8 sau mai nou
  • ✓
    WooCommerce 10.x sau mai nou (plugin activ)
  • ✓
    PHP 7.4 sau mai nou
  • ✓
    Acces de administrator la WordPress 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. Cheia API și Secret Word le găsești în secțiunea Companie > Development.

Instalarea plugin-ului

1
Caută plugin-ul în WordPress
În WordPress Admin mergi la Plugin-uri → Adaugă plugin și în câmpul de căutare scrie Leanpay. Plugin-ul îl poți găsi și pe wordpress.org/plugins/wc-leanpay.
2
Instalează plugin-ul
La plugin-ul Leanpay for WooCommerce apasă Instalează acum. WordPress va descărca și instala automat plugin-ul.
3
Activează plugin-ul
După instalare apasă Activează plugin-ul. Plugin-ul apare în lista plugin-urilor active, sub Plugin-uri → Plugin-uri instalate.
4
Deschide setările Leanpay
Mergi la WooCommerce → Setări → Plăți, caută Leanpay și apasă Gestionează.
5
Verifică instalarea
Deschide: WooCommerce → Setări → Plăți
✓ Leanpay este vizibil în lista metodelor de plată — instalarea a reușit.
Leanpay nu este vizibil — verifică dacă plugin-ul este activat și consultă log-ul din WooCommerce → Stare → Jurnale.

Upgrade-ul unui plugin mai vechi

⚠ La upgrade-ul de la o versiune mai veche a plugin-ului, unele setări s-ar putea să nu se transfere automat. După upgrade, verifică și salvează obligatoriu toate tab-urile de configurare.

Înainte de instalarea unei versiuni mai noi, elimină obligatoriu toate versiunile mai vechi ale plugin-ului. Iar după instalare, parcurge pașii de mai jos pentru fiecare tab de setări (General, Setarea plății, Setări).

1
Elimină toate versiunile mai vechi ale plugin-ului
În WordPress Admin mergi la Plugin-uri → Plugin-uri instalate, caută toate plugin-urile Leanpay existente, mai întâi dezactivează-le, apoi șterge-le. Continuă cu instalarea versiunii mai noi abia după eliminarea completă.
2
Verifică și salvează fiecare tab
În fiecare tab verifică toate valorile. Pentru a te asigura că setările sunt într-adevăr salvate: modifică temporar un câmp, apasă Salvează modificările, readu valoarea înapoi și salvează din nou. Astfel te asiguri că configurația este scrisă corect.
3
Verifică API Vendor URL
Compară valoarea câmpului API Vendor URL din plugin cu URL-ul indicat în aplicația Leanpay Vendor, sub Companie > Development. Ambele trebuie să fie identice, altfel magazinul nu va primi actualizările de stare a comenzilor.
4
Rulează actualizarea manuală a prețurilor
În tab-ul General apasă butonul Actualizează prețurile produselor. Astfel te asiguri că prețurile pe rate de pe paginile produselor sunt actuale.

Configurare

Setările Leanpay le găsești sub: WooCommerce → Setări → Plăți → Leanpay → Gestionează

⚠ Cheia API, Secret Word și setarea mediului trebuie să fie întotdeauna corelate — toate pentru mediul de test sau toate pentru cel de producție. O combinație greșită face ca plugin-ul să nu funcționeze corect.
⚠ Dacă Produsul financiar nu apare în tab-ul Setări, verifică dacă cheia API și Secret Word sunt corecte pentru mediul ales (Test / Producție). O combinație greșită blochează încărcarea produselor financiare.
SetareValori posibileDescriere
General
Metoda de platăActivează / DezactiveazăActivează sau dezactivează Leanpay ca metodă de plată în magazinul tău online.
MediuTest / ProducțieComutarea între mediul de test și cel de producție. În mediul de test plățile nu se procesează real. Trebuie să corespundă cheii API și Secret Word introduse.
Cheia API ✱IntroducereCheia API pentru mediul ales. O obții în aplicația Vendor, sub Companie > Development.
Parola secretă ✱Introducere (ascunsă)Secret Word asociat cheii API. Trebuie să fie din același mediu ca și cheia API.
API Vendor URLURLAdresa endpoint-ului API pentru comunicarea cu sistemul Leanpay. Trebuie să fie identică cu URL-ul indicat în aplicația Vendor, sub Companie > Development.
URL-ul paginii cu informațiiCale relativă (de ex. /info)Calea către pagina WordPress care conține informații despre ratele Leanpay. Plugin-ul actualizează automat această pagină cu prețuri.
Pre-qualify URLURLAdresa paginii Leanpay pentru precalificarea clienților. Setată automat în funcție de mediul ales.
Țara de piațăSelectare (de ex. Slovenia)Determină endpoint-ul de piață pentru metoda de plată. Alege țara în care operează magazinul tău online.
Restricția adreselor IPListă de adrese IPDoar pentru testare. Metoda de plată Leanpay va fi vizibilă doar pentru adresele IP indicate. Câmpul gol înseamnă fără restricții.
Setarea plății
Denumirea plățiiCâmp textNumele metodei de plată, afișat clientului la finalizarea comenzii. Implicit: “Leanpay – plată simplă în rate”.
Descrierea plățiiCâmp textDescriere scurtă a metodei de plată, afișată clientului la alegerea plății. Implicit: “Cumpărare rapidă fără vizita la bancă și fără documentație pe hârtie.”
Starea după plata reușităSelectarea stării comenziiStarea comenzii WooCommerce care se setează după finalizarea reușită a plății. Implicit: “În procesare”.
Starea la plata nereușităSelectarea stării comenziiStarea comenzii WooCommerce care se setează la o plată nereușită sau anulată. Implicit: “Nereușit”.
Valoarea minimă a comenziiNumăr (EUR)Suma minimă a comenzii pentru afișarea metodei de plată Leanpay. Implicit: 50 €.
Valoarea maximă a comenziiNumăr (EUR)Suma maximă a comenzii pentru afișarea metodei de plată Leanpay. Implicit: 5000 €.
Setări
Produsul financiarSelectare (de ex. WEB – OFERTĂ STANDARD)Produsul financiar Leanpay pentru magazinul tău online. Dacă lista rămâne goală, verifică corectitudinea cheii API, Secret Word și a mediului ales.
Programul actualizării prețurilor pe rateOră (HH:MM)Ora zilnică a actualizării automate a prețurilor pe rate de pe paginile produselor. Implicit: 15:00.
Afișarea pe paginile de catalogActivează / DezactiveazăAfișează informația despre rata lunară sub prețul produsului în lista de catalog.
Afișarea pe paginile produselorActivează / DezactiveazăAfișează informația despre rata lunară sub preț pe pagina fiecărui produs.
Afișarea pe pagina de finalizare a comenziiActivează / DezactiveazăAfișează informația despre rata lunară la checkout, la alegerea metodei de plată.
Actualizarea paginii cu informații la schimbarea limbiiActivează / DezactiveazăActualizează automat conținutul paginii cu informații la schimbarea variantei lingvistice (pentru site-uri multilingve cu WPML sau Polylang).
Actualizarea paginii cu informațiiActivează / DezactiveazăActivează actualizarea automată a paginii WordPress cu informații despre ratele Leanpay (conținutul se obține din API-ul Leanpay).
URL de succes personalizatActivează + introducere URLCând este activat, definește o pagină proprie către care va fi redirecționat clientul după plata reușită (în locul paginii implicite de mulțumire WooCommerce).
URL de eroare personalizatActivează + introducere URLCând este activat, definește o pagină proprie către care va fi redirecționat clientul la o plată nereușită (în locul paginii implicite de eroare WooCommerce).
Setări avansate
Custom CSSCâmp text (CSS)Introdu reguli CSS proprii pentru personalizarea afișării elementelor Leanpay în magazinul tău online (de ex. culoarea butoanelor, fontul, aranjamentul widget-ului cu rate).

✱ Câmp obligatoriu