DocsosCommerce
Integrați Cost+ cu magazinul dvs. osCommerce 4 folosind modulul oficial de plată
Integrați Cost+ ca metodă de plată în magazinul dvs. osCommerce 4. Modulul oficial NoPayn Payments folosește fluxul paginii de plată găzduite, astfel încât nicio dată de card nu atinge serverul dvs. — complet conform PCI DSS.
Cerințe preliminare
- Cont activ de comerciant Cost+
- osCommerce 4.x
- PHP 8.1 sau mai nou
- Extensia cURL activată
- Certificat SSL (HTTPS necesar)
- Acces de administrator la panoul de administrare osCommerce
Metode de plată suportate
| Etichetă la checkout | Identificator NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Fiecare metodă poate fi activată sau dezactivată individual din panoul de administrare.
1. Instalați modulul
Descărcați sau clonați modulul de pe GitHub.
Copiați directorul lib/ în directorul rădăcină osCommerce 4:
cp -r lib/ /path/to/oscommerce/Aceasta plasează fișierele modulului la:
lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.phpÎn panoul de administrare osCommerce:
- Navigați la Modules → Payment → Online
- Activați filtrele „Show inactive" și „Show not installed" dacă este necesar
- Găsiți NoPayn Payments și faceți clic pe Install
2. Configurați modulul
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.
Introduceți cheia API și configurați următoarele setări:
| Setare | Descriere | Implicit |
|---|---|---|
| Enable NoPayn Payments | Comutator principal activare/dezactivare | True |
| API Key | Cheia dvs. API NoPayn | — |
| Enable Credit / Debit Card | Afișare card de credit/debit la checkout | True |
| Enable Apple Pay | Afișare Apple Pay la checkout | True |
| Enable Google Pay | Afișare Google Pay la checkout | True |
| Enable Vipps MobilePay | Afișare Vipps MobilePay la checkout | True |
| Manual Capture (Credit Card) | Autorizare doar — captură când comanda este finalizată | False |
| Debug Logging | Scriere cereri/răspunsuri API în log | False |
| Completed Order Status | Status setat când plata reușește | Processing |
| Pending Order Status | Status setat în așteptarea plății | Pending |
| Cancelled Order Status | Status setat la anulare/eșec/expirare | Cancelled |
| Payment Zone | Restricționare pe o zonă geografică (opțional) | Toate zonele |
| Sort Order | Ordine de afișare pe pagina de checkout | 0 |
Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.
3. Actualizați etichetele checkout-ului (Recomandat)
Etichetele implicite ale butoanelor de checkout din osCommerce presupun un flux într-un singur pas. Pentru o experiență mai bună cu redirecționarea externă de plată, actualizați aceste traduceri în Admin → Localisation → Languages → English → Define:
| Cheie | Implicit | Recomandat |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Go to payment |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Review order |
CONFIRM_ORDER | Confirm order | Confirm and pay |
Aceasta îmbunătățește experiența clientului făcând fluxul de checkout mai clar — clienții înțeleg că vor fi redirecționați pentru a finaliza plata pe o pagină securizată.
4. Fluxul de plată
Odată configurat, fluxul de plată funcționează astfel:
- Clientul selectează o metodă de plată Cost+ la checkout
- Clientul confirmă comanda
- Modulul creează o comandă în așteptare și apelează API-ul Cost+
- Clientul este redirecționat către pagina de plată găzduită Cost+ (HPP)
- Clientul finalizează plata pe HPP-ul securizat
- Clientul este redirecționat înapoi în magazin
- Modulul verifică statusul plății prin API-ul Cost+
- Statusul comenzii este actualizat corespunzător
Linkurile de plată expiră după 5 minute. Dacă clientul nu finalizează plata în acest interval, comanda este marcată automat ca anulată.
5. Webhook-uri
Modulul înregistrează un URL webhook cu Cost+ pentru actualizări server-la-server. Când statusul unei plăți se schimbă, Cost+ trimite o notificare și modulul:
- Primește cererea POST webhook
- Verifică statusul plății prin API (nu are niciodată încredere în payload-ul webhook-ului)
- Actualizează statusul comenzii în osCommerce
Nu 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
- Fondurile sunt capturate când comanda trece la statusul completed
- Dacă comanda este anulată, autorizarea este automat anulată
Folosiți captura manuală dacă doriți să taxați clienții doar când comanda lor este expediată. Acest lucru este util pentru comercianții cu timpi mai lungi de onorare.
Logare debug
Când Debug Logging este activat, modulul scrie în nopayn_debug.log în directorul de loguri osCommerce. Intrările de log includ:
- Toate cererile și răspunsurile API
- Evenimentele și rezultatele procesării webhook-urilor
- Operațiunile de captură și anulare
- Erorile (loguite întotdeauna, indiferent de setarea debug)
Toate intrările sunt prefixate cu NoPayn_ pentru filtrare ușoară.
Dezinstalare
- Mergeți la Modules → Payment → Online în panoul de administrare
- Selectați NoPayn Payments
- Faceți clic pe Remove
Dezinstalarea modulului elimină configurația și șterge tabelele nopayn_transactions și nopayn_refunds din baza de date. Asigurați-vă că exportați orice date necesare înainte de dezinstalare.
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.