DocsnopCommerce
Integreer Cost+ met uw nopCommerce-winkel via de officiele betalingsplugin
Integreer Cost+ als betaalmethode in uw nopCommerce-winkel. De officiele NoPayn Payment Gateway-plugin ondersteunt meerdere betaalmethoden met directe doorverwijzing naar de geselecteerde betaalmethode — volledig PCI DSS-conform.
Vereisten
- Actief Cost+ handelaarsaccount
- nopCommerce 4.90 of hoger
- .NET 9
- Beheerderstoegang tot uw nopCommerce-beheerpaneel
- Toegang tot de nopCommerce-broncode (voor plugin-installatie)
Ondersteunde betaalmethoden
| Weergavenaam bij afrekenen | NoPayn-identifier |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. De plugin installeren
Kopieer de pluginmap naar uw nopCommerce-broncodedirectory:
src/Plugins/Nop.Plugin.Payments.NoPayn/Voeg het project toe aan uw solution en bouw:
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildIn het nopCommerce-beheerpaneel:
- Ga naar Configuration → Local plugins
- Zoek NoPayn Payment Gateway en klik op Install
- Ga naar Configuration → Payment methods
- Activeer NoPayn Payment Gateway
- Klik op Configure om de instellingen te openen
2. De plugin configureren
Log in op het handelaarsportaal en navigeer naar Websites, klik vervolgens op de website die u wilt verbinden. Klik op Integration waar u uw API-sleutel vindt.
Voer in de pluginconfiguratie uw API Key in en schakel de betaalmethoden in die u wilt aanbieden:
| Instelling | Beschrijving |
|---|---|
| API Key | Uw NoPayn API-sleutel |
| Enable Credit / Debit Card | Credit-/betaalkaartbetalingen in-/uitschakelen |
| Enable Apple Pay | Apple Pay-betalingen in-/uitschakelen |
| Enable Google Pay | Google Pay-betalingen in-/uitschakelen |
| Enable Vipps MobilePay | Vipps MobilePay-betalingen in-/uitschakelen |
Activeer alleen de betaalmethoden waarvoor u bent goedgekeurd en een bevestiging heeft ontvangen.
3. Betalingsflow
- Klant selecteert NoPayn Payment Gateway bij het afrekenen
- Er verschijnt een submethodeselectie (Credit Card, Apple Pay, enz.)
- Klant kiest een methode en bevestigt de bestelling
- Bestelling wordt aangemaakt met betalingsstatus Pending
- Klant wordt rechtstreeks doorverwezen naar de geselecteerde betaalmethode op de NoPayn-betaalpagina
- Na betaling:
- Geslaagd — bestelling gemarkeerd als Paid / Processing
- Geannuleerd / Mislukt / Verlopen — bestelling ingesteld op Cancelled
- NoPayn stuurt een webhook voor asynchrone statusbevestiging
Transacties verlopen na 5 minuten. Als een klant de betaling niet binnen dit tijdvenster voltooit, wordt de bestelling automatisch geannuleerd via webhook.
4. Bestellingsstatusmapping
| NoPayn-status | nopCommerce-betalingsstatus | nopCommerce-bestellingsstatus |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
De plugin registreert een webhook-eindpunt op /NoPayn/Webhook. NoPayn stuurt POST-gegevens met de bestelidentificatie bij statuswijzigingen. De plugin verifieert de huidige status via een API-aanroep voordat de bestelling wordt bijgewerkt.
Handmatige webhookconfiguratie is niet nodig — de plugin handelt de registratie automatisch af.
6. Testen en live gaan
Doe een paar testtransacties om te controleren of alles soepel werkt. We raden aan om zowel geslaagde als mislukte betalingen te testen om te bevestigen dat alle scenario's correct worden afgehandeld.
Ondersteuning
Hulp nodig? Neem contact op met ons supportteam via support@costplus.io.