DocsnopCommerce
Cost+ über das offizielle Zahlungs-Plugin in Ihren nopCommerce-Shop integrieren
Integrieren Sie Cost+ als Zahlungsmethode in Ihren nopCommerce-Shop. Das offizielle NoPayn Payment Gateway Plugin unterstützt mehrere Zahlungsmethoden mit direkter Weiterleitung zur ausgewählten Zahlungsmethode — vollständig PCI-DSS-konform.
Voraussetzungen
- Aktives Cost+ Händlerkonto
- nopCommerce 4.90 oder neuer
- .NET 9
- Administratorzugang zu Ihrem nopCommerce Admin-Panel
- Zugang zum nopCommerce-Quellcode (für die Plugin-Installation)
Unterstützte Zahlungsmethoden
| Checkout-Anzeigename | NoPayn-Bezeichner |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Plugin installieren
Kopieren Sie den Plugin-Ordner in Ihr nopCommerce-Quellverzeichnis:
src/Plugins/Nop.Plugin.Payments.NoPayn/Fügen Sie das Projekt Ihrer Solution hinzu und bauen Sie:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildIm nopCommerce Admin-Panel:
- Gehen Sie zu Konfiguration → Lokale Plugins
- Finden Sie NoPayn Payment Gateway und klicken Sie auf Installieren
- Gehen Sie zu Konfiguration → Zahlungsmethoden
- Aktivieren Sie NoPayn Payment Gateway
- Klicken Sie auf Konfigurieren, um die Einstellungen zu öffnen
2. Plugin konfigurieren
Melden Sie sich im Händlerportal an und navigieren Sie zu Websites, klicken Sie dann auf die Website, die Sie verbinden möchten. Klicken Sie auf Integration, wo Sie Ihren API-Schlüssel finden.
Geben Sie in der Plugin-Konfiguration Ihren API-Schlüssel ein und schalten Sie die gewünschten Zahlungsmethoden ein:
| Einstellung | Beschreibung |
|---|---|
| API Key | Ihr NoPayn API-Schlüssel |
| Enable Credit / Debit Card | Kredit-/Debitkartenzahlungen ein-/ausschalten |
| Enable Apple Pay | Apple Pay Zahlungen ein-/ausschalten |
| Enable Google Pay | Google Pay Zahlungen ein-/ausschalten |
| Enable Vipps MobilePay | Vipps MobilePay Zahlungen ein-/ausschalten |
Aktivieren Sie nur die Zahlungsmethoden, für die Sie freigeschaltet wurden und eine Bestätigung erhalten haben.
3. Zahlungsablauf
- Der Kunde wählt NoPayn Payment Gateway an der Kasse
- Eine Untermethoden-Auswahl erscheint (Kreditkarte, Apple Pay usw.)
- Der Kunde wählt eine Methode und bestätigt die Bestellung
- Die Bestellung wird mit dem Zahlungsstatus Pending erstellt
- Der Kunde wird direkt zur ausgewählten Zahlungsmethode auf der NoPayn-Zahlungsseite weitergeleitet
- Nach der Zahlung:
- Erfolg — Bestellung als Paid / Processing markiert
- Storniert / Fehlgeschlagen / Abgelaufen — Bestellung auf Cancelled gesetzt
- NoPayn sendet einen Webhook zur asynchronen Statusbestätigung
Transaktionen laufen nach 5 Minuten ab. Wenn ein Kunde die Zahlung nicht innerhalb dieses Zeitfensters abschließt, wird die Bestellung automatisch per Webhook storniert.
4. Bestellstatus-Zuordnung
| NoPayn-Status | nopCommerce Zahlungsstatus | nopCommerce Bestellstatus |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
Das Plugin registriert einen Webhook-Endpunkt unter /NoPayn/Webhook. NoPayn sendet POST-Daten mit dem Bestellbezeichner bei Statusänderungen. Das Plugin verifiziert den aktuellen Status über einen API-Aufruf, bevor es die Bestellung aktualisiert.
Keine manuelle Webhook-Konfiguration erforderlich — das Plugin übernimmt die Registrierung automatisch.
6. Testen und starten
Führen Sie einige Testtransaktionen durch, um sicherzustellen, dass alles reibungslos funktioniert. Wir empfehlen, sowohl erfolgreiche als auch fehlgeschlagene Zahlungen zu testen, um alle Szenarien korrekt zu bestätigen.
Support
Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team unter support@costplus.io.