Magento 2 / Adobe Commerce

Prérequis

• Magento 2.3+ ou Adobe Commerce, PHP 7.4+.
• Une clé API Mobupay (sk_test_… / sk_live_…) et le secret whsec_….
• Pour publier le module sur le Marketplace Adobe : des clés d'accès Adobe (repo.magento.com). Non requis pour une installation manuelle.

Installation

Via Composer (recommandé) :

composer require mobupay/module-payment
bin/magento module:enable Mobupay_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Le SDK mobupay/mobupay-php est tiré automatiquement. En installation manuelle, copiez le module dans app/code/Mobupay/Payment/ et le SDK dans son sous-dossier lib/mobupay-php/, puis lancez module:enable et setup:upgrade.

Configuration

Admin, Stores, Configuration, Sales, Payment Methods, Mobupay (carte bancaire) :

• Activer, libellé client, mode test pour démarrer.
• Clé API (sk_test_…, chiffrée en base) et secret whsec_….
• Base API : https://api.mobupay.nc (le mode test se pilote par la clé sk_test_…).

URL de webhook : https://votre-boutique/mobupay/webhook, transmise automatiquement à chaque paiement.

Fonctionnement

1. 1Le client place la commande avec « Carte bancaire (Mobupay) ».
2. 2Le navigateur est redirigé vers mobupay/redirect, qui crée la session et renvoie vers la page hébergée. La commande reste en attente de paiement.
3. 3Le client paie par carte (widget Monext).
4. 4Le webhook signé crée la facture offline et passe la commande « en traitement » (ou « annulée » selon l'événement), après vérification de signature et rapprochement via externalId.

Remboursement

Admin, Sales, Orders, ouvrez la commande, Credit Memo, Refund (en ligne) : appelle l'API Mobupay (total ou partiel). Nécessite une facture.

Statut

Module code-complet (client + vérification de signature mutualisés avec WooCommerce et PrestaShop). Validation e2e navigateur en attente d'un environnement Magento 2.4 / PHP 8, qui requiert des clés Marketplace Adobe. Carte de test Monext : 5476 4309 9999 9892.