DocsnopCommerce
Integra Cost+ con il tuo negozio nopCommerce utilizzando il plugin ufficiale di pagamento
Integra Cost+ come metodo di pagamento nel tuo negozio nopCommerce. Il plugin ufficiale NoPayn Payment Gateway supporta più metodi di pagamento con reindirizzamento diretto al metodo di pagamento selezionato — completamente conforme PCI DSS.
Prerequisiti
- Account commerciante Cost+ attivo
- nopCommerce 4.90 o successivo
- .NET 9
- Accesso amministratore al tuo pannello di amministrazione nopCommerce
- Accesso al codice sorgente di nopCommerce (per l'installazione del plugin)
Metodi di Pagamento Supportati
| Nome Visualizzato al Checkout | Identificativo NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Installa il Plugin
Copia la cartella del plugin nella directory del codice sorgente nopCommerce:
src/Plugins/Nop.Plugin.Payments.NoPayn/Aggiungi il progetto alla tua soluzione e compila:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildNel pannello di amministrazione nopCommerce:
- Vai a Configurazione → Plugin locali
- Trova NoPayn Payment Gateway e clicca Installa
- Vai a Configurazione → Metodi di pagamento
- Attiva NoPayn Payment Gateway
- Clicca Configura per aprire le impostazioni
2. Configura il Plugin
Accedi al Portale Commerciante e vai a Siti Web, poi clicca sul sito web che vuoi collegare. Clicca su Integrazione dove troverai la tua chiave API.
Nella configurazione del plugin, inserisci la tua chiave API e attiva i metodi di pagamento che vuoi offrire:
| Impostazione | Descrizione |
|---|---|
| API Key | La tua chiave API NoPayn |
| Enable Credit / Debit Card | Attiva/disattiva i pagamenti con carta di credito/debito |
| Enable Apple Pay | Attiva/disattiva i pagamenti Apple Pay |
| Enable Google Pay | Attiva/disattiva i pagamenti Google Pay |
| Enable Vipps MobilePay | Attiva/disattiva i pagamenti Vipps MobilePay |
Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.
3. Flusso di Pagamento
- Il cliente seleziona NoPayn Payment Gateway al checkout
- Appare una selezione di sotto-metodo (Carta di Credito, Apple Pay, ecc.)
- Il cliente sceglie un metodo e conferma l'ordine
- L'ordine viene creato con stato di pagamento In Attesa
- Il cliente viene reindirizzato direttamente al metodo di pagamento selezionato sulla pagina di pagamento NoPayn
- Dopo il pagamento:
- Successo — ordine contrassegnato come Pagato / In Elaborazione
- Annullato / Fallito / Scaduto — ordine impostato a Annullato
- NoPayn invia un webhook per la conferma asincrona dello stato
Le transazioni scadono dopo 5 minuti. Se un cliente non completa il pagamento entro questa finestra, l'ordine viene automaticamente annullato tramite webhook.
4. Mappatura degli Stati dell'Ordine
| Stato NoPayn | Stato Pagamento nopCommerce | Stato Ordine nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhook
Il plugin registra un endpoint webhook a /NoPayn/Webhook. NoPayn invia dati POST contenenti l'identificatore dell'ordine quando lo stato cambia. Il plugin verifica lo stato attuale tramite chiamata API prima di aggiornare l'ordine.
Non è richiesta alcuna configurazione manuale del webhook — il plugin gestisce la registrazione automaticamente.
6. Testa e Lancia
Effettua alcune transazioni di test per assicurarti che tutto funzioni correttamente. Ti consigliamo di testare sia i pagamenti riusciti che quelli falliti per confermare che tutti gli scenari vengano gestiti correttamente.
Supporto
Hai bisogno di aiuto? Contatta il nostro team di supporto a support@costplus.io.