Magento

Suport Hyva
Este disponibil suport suplimentar pentru tema Hyva. Modulul conține componente adaptate care permit funcționarea impecabilă a metodei de plată Leanpay și pe un storefront Hyva.
⚠ Pentru funcționarea suportului Hyva este obligatorie cea mai recentă versiune a plugin-ului Leanpay Magento. Înainte de instalarea pachetului Hyva, actualizează plugin-ul de bază.
Descarcă suportul Hyva

Cerințe preliminare

  • ✓
    Acces la server prin SSH sau consolă
  • ✓
    Calea către folderul root Magento (de ex. /var/www/html/magento2)
  • ✓
    API Key și Secret Word (le obții în aplicația Vendor, în secțiunea Companie > Development)
  • ✓
    Instalarea Magento acceptă comenzile bin/magento și golirea cache-ului
ℹ Dacă folosești multi-store, ține cont că Magento configurează metodele de plată la nivel de Website.

Instalarea plugin-ului

1
Descarcă plugin-ul
Apasă aici pentru a descărca cea mai recentă versiune a plugin-ului.
2
Încarcă fișierele pe server
Dezarhivează arhiva ZIP pe computer. Conținutul arhivei trebuie să includă folderul Leanpay. Copiază-l în app/code/ pe server:
app/code/Leanpay/Payment
Dacă folderul app/code/Leanpay/ nu există încă, creează-l înainte de copiere.
3
Activează modulul Leanpay
În terminal mergi în folderul root Magento și execută comanda:
bin/magento module:enable Leanpay_Payment
4
Rulează Magento Setup Upgrade
bin/magento setup:upgrade
La instalări mai mari, adaugă flag-ul --keep-generated ca să nu pierzi fișierele existente.
5
Golește cache-ul Magento
bin/magento cache:flush
6
Verifică instalarea
Deschide: Stores → Configuration → Sales → Payment Methods
✓ Tab-ul Leanpay este vizibil — instalarea a reușit.
! Tab-ul nu este vizibil — verifică pașii 3–5 sau consultă log-ul din var/log/system.log.

Configurare

Setările Leanpay le găsești sub: Stores → Configuration → Sales → Payment Methods → Leanpay

ℹ Setările cu domeniul de aplicare Website se configurează la nivelul magazinului online. Iar setările Store View la nivelul variantei lingvistice.
SetareValori posibileDescriereDomeniu de aplicare
Setări generale
Enable ExtensionEnable / DisableActivează sau dezactivează plugin-ul. Implicit este dezactivat.Website
TitleCâmp text (max 26 caractere)Numele metodei de plată la finalizarea comenzii. Implicit: “Leanpay”.Store View
DescriptionCâmp text (max 110 caractere)Descrierea afișată la selectarea metodei Leanpay la finalizarea comenzii.Store View
EnvironmentDemo / ProductionComutarea între mediul de test (Demo) și cel de producție (Production).Website
API & plăți
Base Currency RateStringCursul de schimb informativ al valutei de bază. Dacă valoarea nu este setată, în interfață se afișează un avertisment.Website
API Key ✱IntroducereIntrodu cheia API pe care ai primit-o ca și comerciant.Website
Secret Word ✱IntroducereIntrodu parola secretă asociată cheii API.Website
Payment from Applicable CountriesSelectarea țăriiRestricția generală a plăților în funcție de țară. Alege “All Allowed Countries” sau “Specific Countries”.Website
Payment from Specific Billing CountriesSelectarea țăriiRestricție suplimentară în funcție de țara de facturare a clientului. Activă doar dacă setarea de mai sus este setată la “Specific Countries”.Website

✱ Câmp obligatoriu

Magento 1 nu mai este acceptat
Plugin-ul Leanpay pentru Magento 1 nu mai primește actualizări și nici suport tehnic. Recomandăm trecerea la o versiune mai nouă a platformei. Instrucțiunile de mai jos sunt destinate exclusiv gestionării unei instalări existente a plugin-ului.

Cerințe preliminare

  • ✓
    Acces FTP sau acces la server prin SSH
  • ✓
    Calea către folderul root Magento (de ex. /var/www/html/magento)
  • ✓
    API Key și Secret Word (le obții în aplicația Vendor, în secțiunea Companie > Development)
  • ✓
    Acces la Magento Admin Panel pentru golirea cache-ului
ℹ Magento 1 nu include instrumentul din linia de comandă bin/magento. Plugin-ul se instalează manual prin copierea fișierelor pe server.

Instalarea plugin-ului

1
Pregătește fișierele plugin-ului
Dezarhivează arhiva ZIP a plugin-ului pe computer. Arhiva trebuie să conțină:
• folderul app/code/community/Leanpay/
• fișierul app/etc/modules/Leanpay_Payment.xml
2
Încarcă fișierele modulului
Copiază folderul Leanpay în app/code/community/ pe server:
app/code/community/Leanpay/Payment
Dacă folderul app/code/community/Leanpay/ nu există încă, creează-l înainte de copiere.
3
Încarcă declarația modulului
Copiază fișierul Leanpay_Payment.xml în folderul app/etc/modules/ pe server:
app/etc/modules/Leanpay_Payment.xml
Acest fișier înregistrează modulul în Magento și îl activează automat la următoarea cerere.
4
Golește cache-ul Magento
În Admin Panel mergi la System → Cache Management și apasă Flush Magento Cache.
Alternativ, șterge conținutul folderului var/cache/ pe server:
rm -rf var/cache/*
5
Verifică instalarea
Deschide: System → Configuration → Sales → Payment Methods
✓ Tab-ul Leanpay este vizibil — instalarea a reușit.
! Tab-ul nu este vizibil — verifică pașii 2–4 sau consultă log-ul din var/log/system.log.

Configurare

Setările Leanpay le găsești sub: System → Configuration → Sales → Payment Methods → Leanpay

ℹ Setările în Magento 1 se configurează în funcție de domeniul de aplicare: Global se aplică întregii instalări, Website unui magazin online individual, iar Store View unei variante lingvistice individuale.
SetareValori posibileDescriereDomeniu de aplicare
Setări generale
EnabledYes / NoActivează sau dezactivează plugin-ul. Implicit este dezactivat.Website
TitleCâmp text (max 26 caractere)Numele metodei de plată la finalizarea comenzii. Implicit: “Leanpay”.Store View
DescriptionCâmp text (max 110 caractere)Descrierea afișată la selectarea metodei Leanpay la finalizarea comenzii.Store View
EnvironmentDemo / ProductionComutarea între mediul de test (Demo) și cel de producție (Production).Website
Sort OrderNumărDetermină ordinea de afișare printre celelalte metode de plată. Valoare mai mică = mai sus în listă.Website
API & plăți
API Key ✱IntroducereIntrodu cheia API pe care ai primit-o ca și comerciant.Website
Secret Word ✱IntroducereIntrodu parola secretă asociată cheii API.Website
Payment from Applicable CountriesSelectarea țăriiRestricția generală a plăților în funcție de țară. Alege “All Allowed Countries” sau “Specific Countries”.Website
Payment from Specific Billing CountriesSelectarea țăriiRestricție suplimentară în funcție de țara de facturare a clientului. Activă doar dacă setarea de mai sus este setată la “Specific Countries”.Website

✱ Câmp obligatoriu