DocsnopCommerce
Intégrez Cost+ avec votre boutique nopCommerce via le plugin de paiement officiel
Intégrez Cost+ comme méthode de paiement dans votre boutique nopCommerce. Le plugin officiel NoPayn Payment Gateway prend en charge plusieurs méthodes de paiement avec redirection directe vers la méthode de paiement sélectionnée — entièrement conforme PCI DSS.
Prérequis
- Compte marchand Cost+ actif
- nopCommerce 4.90 ou ultérieur
- .NET 9
- Accès administrateur à votre panneau d'administration nopCommerce
- Accès au code source nopCommerce (pour l'installation du plugin)
Méthodes de paiement prises en charge
| Nom affiché au checkout | Identifiant NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
1. Installer le plugin
Copiez le dossier du plugin dans votre répertoire source nopCommerce :
src/Plugins/Nop.Plugin.Payments.NoPayn/Ajoutez le projet à votre solution et compilez :
dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet buildDans le panneau d'administration nopCommerce :
- Accédez à Configuration → Local plugins
- Trouvez NoPayn Payment Gateway et cliquez sur Install
- Accédez à Configuration → Payment methods
- Activez NoPayn Payment Gateway
- Cliquez sur Configure pour ouvrir les paramètres
2. Configurer le plugin
Connectez-vous au Portail marchand et accédez à Sites web, puis cliquez sur le site web que vous souhaitez connecter. Cliquez sur Intégration où vous trouverez votre clé API.
Dans la configuration du plugin, saisissez votre clé API et activez/désactivez les méthodes de paiement souhaitées :
| Paramètre | Description |
|---|---|
| API Key | Votre clé API NoPayn |
| Enable Credit / Debit Card | Activer/désactiver les paiements par carte |
| Enable Apple Pay | Activer/désactiver les paiements Apple Pay |
| Enable Google Pay | Activer/désactiver les paiements Google Pay |
| Enable Vipps MobilePay | Activer/désactiver les paiements Vipps MobilePay |
N'activez que les méthodes de paiement pour lesquelles vous avez été approuvé et avez reçu confirmation.
3. Flux de paiement
- Le client sélectionne NoPayn Payment Gateway au checkout
- Une sélection de sous-méthode apparaît (Carte de crédit, Apple Pay, etc.)
- Le client choisit une méthode et confirme la commande
- La commande est créée avec le statut de paiement Pending
- Le client est redirigé directement vers la méthode de paiement sélectionnée sur la page de paiement NoPayn
- Après le paiement :
- Succès — commande marquée comme Paid / Processing
- Annulé / Échoué / Expiré — commande définie sur Cancelled
- NoPayn envoie un webhook pour la confirmation asynchrone du statut
Les transactions expirent après 5 minutes. Si un client ne finalise pas le paiement dans ce délai, la commande est automatiquement annulée via webhook.
4. Correspondance des statuts de commande
| Statut NoPayn | Statut de paiement nopCommerce | Statut de commande nopCommerce |
|---|---|---|
new | Pending | Pending |
processing | Pending | Pending |
completed | Paid | Processing |
cancelled | Voided | Cancelled |
expired | Voided | Cancelled |
error | Voided | Cancelled |
5. Webhooks
Le plugin enregistre un point d'accès webhook à /NoPayn/Webhook. NoPayn envoie des données POST contenant l'identifiant de la commande lors des changements de statut. Le plugin vérifie le statut actuel via un appel API avant de mettre à jour la commande.
Aucune configuration manuelle du webhook n'est nécessaire — le plugin gère l'enregistrement automatiquement.
6. Tester et lancer
Effectuez quelques transactions tests pour vous assurer que tout fonctionne correctement. Nous recommandons de tester les paiements réussis et échoués pour confirmer que tous les scénarios sont gérés correctement.
Support
Besoin d'aide ? Contactez notre équipe de support à support@costplus.io.