Magento

• Compte marchand Cost+ actif
• Installation Magento 2.4.6 – 2.4.8
• PHP 8.2 – 8.4
• Accès administrateur à votre panneau d'administration Magento
• Accès SSH à votre serveur (pour l'installation via Composer)

• Compte marchand Cost+ actif
• Magento 1.9.x ou OpenMage LTS 20+
• PHP 7.4 ou ultérieur
• Accès administrateur à votre panneau d'administration Magento
• Accès SSH ou FTP à votre serveur

Méthode A : Installation via Composer (recommandé)

Connectez-vous à votre serveur Magento via SSH et accédez au répertoire racine de Magento.

Installez le plugin :

composer require nopayn/nopayn-magento-2

Exécutez les commandes de configuration Magento :

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Si vous êtes en mode production, exécutez également :

php bin/magento setup:static-content:deploy

Méthode B : Installation manuelle

1. Accédez à votre répertoire app/code
2. Téléchargez et décompressez la release Cost+ depuis GitHub
3. Exécutez les commandes de configuration :

php bin/magento setup:upgrade
php bin/magento cache:clean

Si en mode production :

php bin/magento setup:static-content:deploy

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

Copiez le contenu de app/ dans le répertoire racine app/ de votre Magento :

cp -r app/* /path/to/magento/app/

Videz le cache Magento :

rm -rf var/cache/*

Connectez-vous au panneau d'administration Magento et accédez à System → Configuration → Sales → Payment Methods pour vérifier que la section NoPayn Payment Gateway apparaît.

1. Accédez à Stores → Configuration → Sales → Payment Methods → Cost+ Payments
2. Saisissez votre clé API (voir étape 3 ci-dessous)
3. Activez les méthodes de paiement pour lesquelles vous avez été approuvé
4. Enregistrez les modifications

1. Accédez à System → Configuration → Sales → Payment Methods
2. Localisez la section NoPayn Payment Gateway
3. Saisissez votre clé API (voir étape 3 ci-dessous)
4. Activez les méthodes de paiement individuelles (Carte de crédit/débit, Apple Pay, Google Pay, Vipps MobilePay)
5. Restreignez éventuellement par pays
6. Enregistrez la configuration

1. Le client sélectionne une méthode de paiement au checkout et passe la commande
2. Le client est redirigé vers la page de paiement hébergée NoPayn
3. Après le paiement, le client revient et le statut de la commande est mis à jour automatiquement
4. NoPayn envoie un webhook pour la confirmation asynchrone du statut

1. Le client sélectionne une méthode de paiement au checkout et passe la commande
2. La commande est créée avec le statut Pending Payment
3. Le client est redirigé vers la page de paiement sécurisée NoPayn
4. Après le paiement :
   • Succès — le client revient, le statut est vérifié via l'API, commande définie sur Processing
   • Annulé — le client revient, commande définie sur Canceled
   • Expiré (délai de 5 minutes) — le webhook se déclenche, commande définie sur Canceled
5. NoPayn envoie un webhook pour la confirmation asynchrone du statut

Correspondance des statuts de commande

Webhooks

Le module enregistre un point d'accès webhook à /nopayn/payment/webhook. Cette URL est automatiquement envoyée à NoPayn lors de la création des commandes. Le webhook vérifie toujours le statut de la commande via l'API NoPayn avant de mettre à jour la commande Magento.