osCommerce

Intégrez Cost+ comme méthode de paiement dans votre boutique osCommerce 4. Le module officiel NoPayn Payments 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
• osCommerce 4.x
• PHP 8.1 ou ultérieur
• Extension cURL activée
• Certificat SSL (HTTPS requis)
• Accès administrateur à votre panneau d'administration osCommerce

Méthodes de paiement prises en charge

Chaque méthode peut être activée ou désactivée individuellement depuis le panneau d'administration.

1. Installer le module

Téléchargez ou clonez le module depuis GitHub.

Copiez le répertoire lib/ dans le répertoire racine de votre osCommerce 4 :

cp -r lib/ /path/to/oscommerce/

Cela place les fichiers du module à :

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

Dans votre panneau d'administration osCommerce :

1. Accédez à Modules → Payment → Online
2. Activez les filtres "Show inactive" et "Show not installed" si nécessaire
3. Trouvez NoPayn Payments et cliquez sur Install

2. Configurer le module

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.

Saisissez votre clé API et configurez les paramètres suivants :

3. Mettre à jour les libellés du checkout (recommandé)

Les libellés de boutons de checkout par défaut d'osCommerce supposent un flux en une étape. Pour une meilleure expérience avec la redirection de paiement externe, mettez à jour ces traductions dans Admin → Localisation → Languages → English → Define :

4. Flux de paiement

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

1. Le client sélectionne une méthode de paiement Cost+ au checkout
2. Le client confirme la commande
3. Le module crée une commande en attente et appelle l'API Cost+
4. Le client est redirigé vers la page de paiement hébergée Cost+ (HPP)
5. Le client finalise le paiement sur la HPP sécurisée
6. Le client est redirigé vers la boutique
7. Le module vérifie le statut du paiement via l'API Cost+
8. Le statut de la commande est mis à jour en conséquence

5. Webhooks

Le module enregistre une URL de webhook auprès de Cost+ pour les mises à jour de statut serveur à serveur. Lorsqu'un statut de paiement change, Cost+ envoie une notification et le module :

1. Reçoit le POST du webhook
2. Vérifie le statut du paiement via l'API (ne fait jamais confiance au payload du webhook)
3. Met à jour le statut de la commande dans osCommerce

Capture manuelle

Lorsqu'elle est activée pour les paiements par carte :

• Le paiement est autorisé mais non capturé au checkout
• Les fonds sont capturés lorsque la commande passe au statut completed
• Si la commande est annulée, l'autorisation est automatiquement annulée

Journalisation de débogage

Lorsque la journalisation de débogage est activée, le module écrit dans nopayn_debug.log dans le répertoire de logs osCommerce. Les entrées de journal incluent :

• Toutes les requêtes et réponses API
• Les événements webhook et résultats de traitement
• Les opérations de capture et d'annulation
• Les erreurs (toujours journalisées, quel que soit le paramètre de débogage)

Toutes les entrées sont préfixées par NoPayn_ pour un filtrage facile.

Désinstallation

1. Accédez à Modules → Payment → Online dans le panneau d'administration
2. Sélectionnez NoPayn Payments
3. Cliquez sur Remove

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.