Drupal Commerce

Intégrez Cost+ comme méthode de paiement dans votre boutique Drupal Commerce. Le module officiel NoPayn Payment Gateway utilise le flux de page de paiement hébergée, de sorte qu'aucune donnée de carte ne transite par votre serveur — entièrement conforme PCI DSS.

Prérequis

• Compte marchand Cost+ actif
• Drupal 10 ou 11
• Drupal Commerce 3.x
• PHP 8.1 ou ultérieur
• Accès administrateur à votre site Drupal

Méthodes de paiement prises en charge

• Credit / Debit Card — Visa, Mastercard et plus
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Installer le module

Copiez le module commerce_nopayn dans votre installation Drupal et activez-le :

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Ajouter une passerelle de paiement

1. Accédez à Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Cliquez sur Add payment gateway
3. Sélectionnez NoPayn Payment Gateway comme plugin

3. Configurer la passerelle

Saisissez les paramètres suivants :

• NoPayn API Key — Votre clé API marchand depuis le Portail marchand
• Payment Methods — Activez ou désactivez Carte de crédit, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Définissez sur Test lors de l'utilisation d'une clé API d'un site web sandbox, ou Live lors de l'utilisation d'une clé de site web de production

Paramètres optionnels

• Manual Capture — Autoriser les paiements par carte sans capture immédiate (les fonds sont réservés, puis capturés lorsque la commande est traitée)
• Debug Logging — Activez pour journaliser toutes les requêtes et réponses API dans le journal Drupal pour le dépannage

Cliquez sur Save lorsque vous avez terminé.

4. Flux de paiement

Une fois configuré, le flux de paiement fonctionne comme suit :

1. Le client ajoute des produits au panier et procède au checkout
2. À l'étape de paiement, les méthodes Cost+ activées sont affichées comme boutons radio
3. Le client sélectionne une méthode et confirme la commande
4. Le module crée une commande via l'API Cost+ et redirige vers la page de paiement hébergée
5. Le client finalise le paiement sur la page Cost+
6. Le client revient vers la boutique — le paiement est vérifié via l'API
7. Un webhook de Cost+ confirme de manière asynchrone le résultat du paiement

5. Configuration du webhook

L'URL du webhook est automatiquement générée par Drupal Commerce :

https://your-store.com/payment/notify/{gateway_machine_name}

Par exemple : https://your-store.com/payment/notify/nopayn

Cette URL doit être accessible depuis Internet sans authentification. Le module vérifie toujours le statut du paiement via l'API — il ne fait jamais confiance au payload du webhook seul.

Capture manuelle

Lorsque la capture manuelle est activée pour les cartes :

1. La carte du client est autorisée (fonds réservés) lors du checkout
2. La capture s'effectue automatiquement lorsque la commande passe en statut Fulfilled
3. Si la commande est annulée, l'autorisation est annulée via webhook

Remboursements

Les remboursements peuvent être traités directement depuis le panneau d'administration Commerce. Les remboursements totaux et partiels sont pris en charge.

Tables de base de données

Le module crée deux tables pour le suivi :

Désinstallation

drush pmu commerce_nopayn -y
drush cr

Tester et lancer

Effectuez quelques transactions tests pour vous assurer que tout fonctionne correctement. Définissez le Mode de la passerelle sur Test et vérifiez les paiements réussis et échoués avant de passer en Live.

Support

Besoin d'aide ? Contactez notre équipe de support à support@costplus.io.