Cost+Docs

OpenCart

Integrați Cost+ cu magazinul dvs. OpenCart (4.x și 3.x / ocStore 3)

OpenCart

Integrați Cost+ ca metodă de plată în magazinul dvs. OpenCart. Extensia oficială NoPayn Payment Gateway este disponibilă pentru OpenCart 4 și OpenCart 3 / ocStore 3.

Cerințe preliminare

  • Cont activ de comerciant Cost+
  • OpenCart 4.0.0.0 sau mai nou
  • PHP 8.0 sau mai nou
  • Acces de administrator la panoul de control OpenCart
  • Cont activ de comerciant Cost+
  • ocStore 3.0.x sau OpenCart 3.0.3.x
  • PHP 7.4 sau mai nou
  • Acces de administrator la panoul de control OpenCart

Metode de plată suportate

  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Instalați extensia

Metoda A: Încărcare prin panoul de administrare (Recomandat)

  1. Descărcați ultima versiune .ocmod.zip de pe GitHub
  2. În panoul de administrare OpenCart, mergeți la Extensions → Installer
  3. Încărcați fișierul .ocmod.zip
  4. Mergeți la Extensions → Extensions → Payment
  5. Găsiți NoPayn Payment Gateway și faceți clic pe Install, apoi Edit

Metoda B: Încărcare manuală

  1. Descărcați sau clonați depozitul
  2. Copiați conținutul folderului upload/ în directorul rădăcină OpenCart
  3. Mergeți la Extensions → Extensions → Payment
  4. Găsiți NoPayn Payment Gateway și faceți clic pe Install, apoi Edit

Arhitectură

OpenCart 3 folosește o configurare multi-extensie:

  • NoPayn - Global Settings — configurare partajată (cheie API, statusuri comenzi, disponibilitate metode, captură manuală, logare debug)
  • NoPayn - Card Payments — checkout card de credit/debit
  • NoPayn - Apple Pay / Google Pay — checkout wallet (dacă doar un wallet este activat, eticheta se ajustează automat)
  • NoPayn - Vipps MobilePay — checkout Vipps/MobilePay
  • NoPayn - Swish — checkout Swish

Metoda A: Încărcare prin panoul de administrare (Recomandat)

  1. Descărcați fișierul .ocmod.zip de la ultima versiune GitHub

Folosiți fișierul .ocmod.zip de la versiune — nu descărcările „Source code" generate automat de GitHub, care conțin structura depozitului, nu structura de instalare.

  1. În panoul de administrare, mergeți la Extensions → Installer
  2. Încărcați fișierul .ocmod.zip
  3. Mergeți la Extensions → Extensions → Payments
  4. Instalați mai întâi NoPayn - Global Settings
  5. Deschideți NoPayn - Global Settings și configurați:
    • Cheia API
    • Statusuri comenzi pentru finalizat, în așteptare și anulat
    • Metodele de plată disponibile pentru care contul de comerciant are aprobare
    • Opțional: captură manuală card
    • Opțional: logare debug
  6. Instalați modulele de checkout pe care doriți să le expuneți:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Pentru fiecare modul de checkout, setați: Status, Geo Zone și Sort Order

Metoda B: Încărcare manuală

  1. Descărcați sau clonați depozitul
  2. Copiați conținutul folderului upload/ în directorul rădăcină al magazinului
  3. Mergeți la Extensions → Extensions → Payments
  4. Urmați aceeași ordine de instalare ca la Metoda A (Global Settings mai întâi, apoi modulele de checkout)

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.

Portalul comerciantului Cost+ cu cheia API

În setările NoPayn Payment Gateway, introduceți cheia API în câmpul corespunzător.

În NoPayn - Global Settings, introduceți cheia API în câmpul corespunzător. Cheia API este partajată între toate modulele de checkout — trebuie să o introduceți o singură dată.

3. Configurați setările de plată

  1. Activați metodele de plată pentru care aveți aprobare
  2. Setați statusurile de comandă preferate pentru plăți finalizate, în așteptare și anulate
  3. Opțional, restricționați plățile pe Geo Zone
  4. Setați Status la Enabled
  5. Faceți clic pe Save

Setări globale

NoPayn - Global Settings stochează toată configurarea partajată:

SetareDescriere
API KeyCheia dvs. API NoPayn
Order StatusesMapare statusuri finalizat, în așteptare și anulat
Method AvailabilityCe metode de plată are contul de comerciant aprobate
Manual CaptureAutorizare doar plăți cu card de credit — captură ulterioară
Debug LoggingActivare logare detaliată pentru depanare

Setări modul checkout

Fiecare modul de checkout are propriile setări de vitrină:

SetareDescriere
StatusActivare sau dezactivare această metodă de plată la checkout
Geo ZoneRestricționare pe zone geografice specifice
Sort OrderOrdine de afișare pe pagina de checkout

Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.

Fluxul de plată

  1. Clientul selectează o metodă de plată Cost+ la checkout
  2. Clientul este redirecționat către pagina de plată găzduită NoPayn
  3. După plată, clientul revine și statusul comenzii este actualizat automat
  4. NoPayn trimite un webhook pentru confirmarea asincronă a statusului

Extensia folosește pagina de plată găzduită Cost+, ceea ce înseamnă că clienții sunt redirecționați către un formular securizat de plată. Nicio dată sensibilă a cardului nu este gestionată de serverul dvs.

Fiecare modul de checkout este o extensie separată de plată OpenCart, oferind clienților opțiuni radio distincte la checkout (de ex. „Card Payments", „Apple Pay & Google Pay").

  1. Clientul selectează o etichetă de metodă de plată la checkout (de ex. Card Payments)
  2. Extensia creează o comandă de plată găzduită NoPayn
  3. Clientul este redirecționat către pagina securizată de plată NoPayn
  4. După plată, clientul revine și statusul comenzii este actualizat automat
  5. NoPayn trimite un webhook pentru confirmarea asincronă a statusului

Modulul Apple Pay / Google Pay trimite ambele metode într-o singură tranzacție, astfel încât pagina găzduită NoPayn poate oferi ambele opțiuni wallet într-un singur flux.

Actualizare de la v1.0.0 la v2.0.0

Versiunea 1.0.0 folosea o singură metodă de checkout numită „NoPayn Checkout". Versiunea 2.0.0 trece la module separate de checkout per metodă de plată. La actualizare:

  1. Încărcați noul pachet
  2. Intrarea existentă „NoPayn Checkout" devine NoPayn - Global Settings
  3. Verificați și salvați setările globale
  4. Instalați și activați noile module de checkout pe care doriți să le vadă clienții

4. Testați și lansați

Plasați câteva tranzacții de test pentru a vă asigura că totul funcționează corect. Vă recomandăm să testați atât plăți reușite, cât și eșuate pentru a confirma că toate scenariile sunt gestionate corect.

Suport

Aveți nevoie de ajutor? Contactați echipa noastră de suport la support@costplus.io.

On this page