DocsPrestaShop
Integrați Cost+ cu magazinul dvs. PrestaShop (9.x, 8.x și 1.7)
Integrați Cost+ ca metodă de plată în magazinul dvs. PrestaShop. Modulul Cost+ este disponibil pentru PrestaShop 9.x, PrestaShop 8.x și PrestaShop 1.7.
Cerințe preliminare
- Cont activ de comerciant Cost+
- PrestaShop 9.1 sau mai nou
- PHP 8.1 sau mai nou
- SSL/HTTPS activat
- Acces de administrator la panoul de administrare PrestaShop
- Cont activ de comerciant Cost+
- Instalare PrestaShop 8.x
- PHP 8.0 sau mai nou
- Acces de administrator la panoul de administrare PrestaShop
- MySQL 5.4 sau mai nou
- Cont activ de comerciant Cost+
- Instalare PrestaShop 1.7.x
- PHP 5.4 sau mai nou
- Acces de administrator la panoul de administrare PrestaShop
- MySQL 5.4 sau mai nou
1. Instalați modulul
Descărcați modulul de pe GitHub.
Metoda A: Încărcare prin panoul de administrare (Recomandat)
- Mergeți la Modules → Module Manager în panoul de administrare
- Faceți clic pe Upload a module
- Trageți și plasați fișierul ZIP sau selectați-l manual
- Așteptați finalizarea instalării
- Căutați „NoPayn" și faceți clic pe Configure
Metoda B: Încărcare manuală
- Copiați folderul
nopaynpayment/în directorulmodules/al PrestaShop - Mergeți la Modules → Module Manager
- Căutați „NoPayn" și faceți clic pe Install
- Faceți clic pe Configure pentru a deschide setările
Descărcați modulul de pe GitHub.
Metoda A: Încărcare prin panoul de administrare (Recomandat)
- Mergeți la Improve > Module Manager în panoul de administrare
- Faceți clic pe Upload a module
- Trageți și plasați fișierul ZIP sau selectați-l manual
- Așteptați finalizarea instalării
- Derulați în jos la secțiunea „Other" și faceți clic pe Configure sub Cost+
Metoda B: Încărcare manuală prin (S)FTP
- Extrageți fișierul ZIP descărcat
- Folosind un client SFTP (de ex. FileZilla, WinSCP), încărcați toate folderele în directorul
/modules/din instalarea PrestaShop - Mergeți la Improve > Modules > Module Catalog
- Căutați „Cost+" -- verificați tab-ul Uninstalled Modules dacă este necesar
- Faceți clic pe Install
Descărcați modulul de pe GitHub.
Metoda A: Încărcare prin panoul de administrare (Recomandat)
- Mergeți la Improve > Module Manager în panoul de administrare
- Faceți clic pe Upload a module
- Trageți și plasați fișierul ZIP sau selectați-l manual
- Așteptați finalizarea instalării
- Derulați în jos la secțiunea „Other" și faceți clic pe Configure sub Cost+
Metoda B: Încărcare manuală prin (S)FTP
- Extrageți fișierul ZIP descărcat
- Folosind un client SFTP (de ex. FileZilla, WinSCP), încărcați toate folderele în directorul
/modules/din instalarea PrestaShop - Mergeți la Modules > Module Manager
- Căutați „Cost+" -- verificați tab-ul Uninstalled Modules dacă este necesar
- Faceți clic pe Install
2. Introduceți credențialele API
Conectați-vă la portalul comerciantului și navigați la Site-uri web, apoi faceți clic pe site-ul web pe care doriți să îl conectați. Faceți clic pe Integrare unde veți găsi cheia API.
În configurarea modulului NoPayn, introduceți cheia API și configurați următoarele setări:
| Setare | Descriere |
|---|---|
| API Key | Cheia dvs. API NoPayn |
| Credit / Debit Card | Activare/dezactivare plăți cu card de credit |
| Apple Pay | Activare/dezactivare Apple Pay |
| Google Pay | Activare/dezactivare Google Pay |
| Vipps MobilePay | Activare/dezactivare Vipps MobilePay |
| Manual Capture | Autorizare doar plăți cu card de credit — captură la expediere |
| Debug Logging | Activare logare detaliată în var/logs/nopayn_debug.log |
Inserați cheia în câmpul API Key din pagina de configurare Cost+ Library și faceți clic pe Save.
Inserați cheia în câmpul API Key din pagina de configurare Cost+ Library și faceți clic pe Save.
Pentru mediile de hosting PrestaShop 8.x și 1.7, activați opțiunea cURL CA bundle în timpul configurării pentru a evita problemele cu certificatele SSL.
3. Activați metodele de plată
Metodele de plată sunt configurate direct în setările modulului (vezi pasul 2 de mai sus). Comutați fiecare metodă activată sau dezactivată după necesitate.
Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.
După salvarea cheii API, încărcați fiecare modul de metodă de plată separat prin Upload a module.
Reveniți la Improve > Module Manager, faceți clic din nou pe Upload a module și încărcați fiecare fișier ZIP pentru metodele de plată pe care doriți să le activați (de ex. Credit Card, MobilePay, Swish).
Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.
Modulele de plată vor avea fie o opțiune Configure (dacă este necesară configurare suplimentară), fie doar un comutator Activare/Dezactivare.
După salvarea cheii API, încărcați fiecare modul de metodă de plată separat prin Upload a module.
Reveniți la Improve > Module Manager, faceți clic din nou pe Upload a module și încărcați fiecare fișier ZIP pentru metodele de plată pe care doriți să le activați (de ex. Credit Card, MobilePay, Swish).
Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.
Modulele de plată vor avea fie o opțiune Configure (dacă este necesară configurare suplimentară), fie doar un comutator Activare/Dezactivare.
Fluxul de plată
- Clientul selectează o metodă de plată Cost+ la checkout
- Clientul este redirecționat către pagina de plată găzduită Cost+ (HPP)
- După finalizarea plății, clientul este redirecționat înapoi la magazin
- Un webhook confirmă statusul plății server-la-server
Webhook
URL-ul webhook este configurat automat per comandă:
https://your-shop.com/module/nopaynpayment/webhookNu este necesară configurarea manuală a webhook-urilor — modulul gestionează înregistrarea automat.
Captură manuală
Când este activată pentru plățile cu card de credit:
- Plata este autorizată dar nu capturată la checkout
- Captura are loc când comanda este expediată / marcată ca finalizată
- Dacă comanda este anulată, autorizarea este automat anulată
Rambursare automată
Dacă o comandă de plată capturată este anulată, modulul emite automat o rambursare totală. Rambursările parțiale pot fi procesate prin notele de credit PrestaShop.
Etichete buton checkout
Pentru cea mai bună experiență a utilizatorului cu fluxurile de redirecționare externă, luați în considerare actualizarea etichetei butonului de checkout la „Review order" în loc de „Confirm and pay", deoarece plata efectivă are loc pe pagina găzduită Cost+. Aceasta este o setare globală PrestaShop, nu specifică modulului.
Webhook
Webhook-ul este configurat automat de modul. Nu este necesară configurare manuală.
Webhook
Webhook-ul este configurat automat de modul. Nu este necesară configurare manuală.
4. Pași finali și testare
- Verificați din nou toate metodele de plată activate
- Plasați câteva tranzacții de test -- atât reușite, cât și eșuate -- pentru a vă asigura că totul funcționează corect
- Configurați comportamentul avansat precum captură manuală vs. automată în funcție de procesul dvs. de onorare
Suport
Aveți nevoie de ajutor? Contactați echipa noastră de suport la support@costplus.io.