DocsnopCommerce
Integrați Cost+ cu magazinul dvs. nopCommerce folosind plugin-ul oficial de plată
Integrați Cost+ ca metodă de plată în magazinul dvs. nopCommerce. Plugin-ul oficial NoPayn Payment Gateway suportă mai multe metode de plată cu redirecționare directă către metoda selectată — complet conform PCI DSS.
Cerințe preliminare
- Cont activ de comerciant Cost+
- nopCommerce 4.90 sau mai nou
- .NET 9
- Acces de administrator la panoul de administrare nopCommerce
- Acces la codul sursă nopCommerce (pentru instalarea plugin-ului)
Metode de plată suportate
| Nume afișat la checkout | Identificator NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Instalați plugin-ul
Copiați folderul plugin-ului în directorul sursă nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Adăugați proiectul în soluție și compilați:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildÎn panoul de administrare nopCommerce:
- Mergeți la Configuration → Local plugins
- Găsiți NoPayn Payment Gateway și faceți clic pe Install
- Mergeți la Configuration → Payment methods
- Activați NoPayn Payment Gateway
- Faceți clic pe Configure pentru a deschide setările
2. Configurați plugin-ul
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 plugin-ului, introduceți cheia API și comutați metodele de plată pe care doriți să le oferiți:
| Setare | Descriere |
|---|---|
| API Key | Cheia dvs. API NoPayn |
| Enable Credit / Debit Card | Comutare plăți cu card de credit/debit |
| Enable Apple Pay | Comutare plăți Apple Pay |
| Enable Google Pay | Comutare plăți Google Pay |
| Enable Vipps MobilePay | Comutare plăți Vipps MobilePay |
Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.
3. Fluxul de plată
- Clientul selectează NoPayn Payment Gateway la checkout
- Apare o selecție de sub-metodă (Credit Card, Apple Pay, etc.)
- Clientul alege o metodă și confirmă comanda
- Comanda este creată cu statusul de plată Pending
- Clientul este redirecționat direct către metoda selectată pe pagina de plată NoPayn
- După plată:
- Succes — comanda marcată ca Paid / Processing
- Anulat / Eșuat / Expirat — comanda setată la Cancelled
- NoPayn trimite un webhook pentru confirmarea asincronă a statusului
Tranzacțiile expiră după 5 minute. Dacă un client nu finalizează plata în acest interval, comanda este anulată automat prin webhook.
4. Maparea statusurilor comenzii
| Status NoPayn | Status plată nopCommerce | Status comandă nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhook-uri
Plugin-ul înregistrează un endpoint webhook la /NoPayn/Webhook. NoPayn trimite date POST conținând identificatorul comenzii la schimbările de status. Plugin-ul verifică statusul curent prin apel API înainte de a actualiza comanda.
Nu este necesară configurarea manuală a webhook-urilor — plugin-ul gestionează înregistrarea automat.
6. 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.