DocsnopCommerce
Integrera Cost+ med din nopCommerce-butik via det officiella betalningsplugin
Integrera Cost+ som betalningsmetod i din nopCommerce-butik. Det officiella NoPayn Payment Gateway-pluginet stöder flera betalningsmetoder med direkt omdirigering till den valda betalningsmetoden — fullt PCI DSS-kompatibelt.
Förutsättningar
- Aktivt Cost+-handelskonto
- nopCommerce 4.90 eller senare
- .NET 9
- Administratörsåtkomst till din nopCommerce-adminpanel
- Åtkomst till nopCommerce-källkoden (för plugininstallation)
Betalningsmetoder som stöds
| Kassavisningsnamn | NoPayn-identifierare |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Installera pluginet
Kopiera pluginmappen till din nopCommerce-källkodskatalog:
src/Plugins/Nop.Plugin.Payments.NoPayn/Lägg till projektet i din lösning och bygg:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildI nopCommerce-adminpanelen:
- Gå till Konfiguration → Lokala plugins
- Hitta NoPayn Payment Gateway och klicka på Installera
- Gå till Konfiguration → Betalningsmetoder
- Aktivera NoPayn Payment Gateway
- Klicka på Konfigurera för att öppna inställningarna
2. Konfigurera pluginet
Logga in på handlarportalen och navigera till Webbplatser, klicka sedan på den webbplats du vill ansluta. Klicka på Integration där du hittar din API-nyckel.
I plugin-konfigurationen, ange din API-nyckel och växla de betalningsmetoder du vill erbjuda:
| Inställning | Beskrivning |
|---|---|
| API Key | Din NoPayn API-nyckel |
| Enable Credit / Debit Card | Aktivera/inaktivera kortbetalningar |
| Enable Apple Pay | Aktivera/inaktivera Apple Pay-betalningar |
| Enable Google Pay | Aktivera/inaktivera Google Pay-betalningar |
| Enable Vipps MobilePay | Aktivera/inaktivera Vipps MobilePay-betalningar |
Aktivera bara de betalningsmetoder du har blivit godkänd för och fått bekräftelse på.
3. Betalningsflöde
- Kunden väljer NoPayn Payment Gateway i kassan
- Ett undermetodval visas (kreditkort, Apple Pay, etc.)
- Kunden väljer en metod och bekräftar ordern
- Ordern skapas med Väntande betalningsstatus
- Kunden omdirigeras direkt till den valda betalningsmetoden på NoPayn-betalningssidan
- Efter betalning:
- Lyckad — order markeras som Betald / Bearbetas
- Avbruten / Misslyckad / Utgången — order sätts till Avbruten
- NoPayn skickar en webhook för asynkron statusbekräftelse
Transaktioner löper ut efter 5 minuter. Om en kund inte slutför betalningen inom denna tidsram avbryts ordern automatiskt via webhook.
4. Orderstatusmappning
| NoPayn-status | nopCommerce betalningsstatus | nopCommerce orderstatus |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
Pluginet registrerar en webhook-endpoint på /NoPayn/Webhook. NoPayn skickar POST-data som innehåller orderidentifieraren vid statusändringar. Pluginet verifierar aktuell status via API-anrop innan ordern uppdateras.
Ingen manuell webhook-konfiguration krävs — pluginet hanterar registreringen automatiskt.
6. Testa och lansera
Gör några testtransaktioner för att säkerställa att allt fungerar smidigt. Vi rekommenderar att testa både lyckade och misslyckade betalningar för att bekräfta att alla scenarier hanteras korrekt.
Support
Behöver du hjälp? Kontakta vårt supportteam på support@costplus.io.