WooCommerce

Prérequis

• WordPress 6.0+, WooCommerce actif, PHP 7.4+.
• Une clé API Mobupay (sk_test_… pour tester, sk_live_… en production), depuis votre espace marchand, rubrique Développeurs, Clés API. C'est le seul secret à saisir : depuis la version 1.2.0, le secret de signature des webhooks est récupéré automatiquement.

Installation

L'archive est prête à installer : le SDK PHP mobupay/mobupay-php y est déjà inclus, vous n'avez rien à construire ni aucune commande à lancer sur votre serveur.

1. 1Télécharger l'extension Mobupay pour WooCommerce. Le lien vous donne toujours la dernière version.
2. 2WordPress, Extensions, Ajouter, Téléverser une extension, choisir l'archive, Installer, puis Activer.
3. 3WooCommerce, Réglages, Paiements, ouvrez Carte bancaire (Mobupay).

L'extension fonctionne avec le tunnel de commande en blocs comme avec le tunnel classique, sans réglage particulier.

Configuration

Dans les réglages de la passerelle Mobupay :

• Activer la passerelle, cocher le mode test pour démarrer.
• Renseigner la clé API (sk_test_…), puis enregistrer. Le plugin vérifie la clé, récupère le secret de signature et vous confirme dans quel environnement vous êtes, test ou production.
• Base API : https://api.mobupay.nc. Le mode test (bac à sable) se pilote par la clé sk_test_…, pas par une URL différente.

L'URL de webhook (https://votre-boutique/?wc-api=mobupay) est transmise automatiquement à chaque paiement : aucun enregistrement manuel côté Mobupay.

Trois réglages décident de ce que votre boutique transmet. Tout est déduit de la commande, vous n'avez aucun champ à remplir, et ce que votre tunnel ne collecte pas est simplement omis.

• Détail de la commande, actif par défaut : articles, quantités, taxes par ligne, frais de port et remises. Le client voit le récapitulatif de son panier sur la page de paiement, et vos factures détaillent chaque ligne.
• Coordonnées du client, actif par défaut : nom, téléphone, adresse de facturation et de livraison. Nécessaire pour qu'une facture porte les mentions obligatoires.
• Facture Mobupay, inactif par défaut : établit une facture à chaque encaissement, avec envoi au client si vous le souhaitez. Si une facture ne peut pas être établie, le paiement aboutit quand même et la raison est inscrite dans les notes de la commande : un paiement n'est jamais refusé pour un motif de facturation.
• Nature de l'opération : livraison de biens, prestation de services, ou les deux. C'est une mention obligatoire de la facture, et sans elle une facture ne peut pas être émise. « Livraison de biens » convient à une boutique qui vend des produits ; ce choix ne vous est demandé qu'une fois.

Fonctionnement

1. 1Le client choisit « Carte bancaire (Mobupay) » et valide le panier.
2. 2L'extension crée une session Mobupay et redirige vers la page hébergée ; la commande passe en attente (on-hold).
3. 3Le client paie par carte sur la page Mobupay (widget Monext).
4. 4Mobupay envoie un webhook signé ; l'extension vérifie la signature, rapproche la commande via externalId et met le statut à jour (payée, échouée, annulée, remboursée).

Remboursement

Depuis WooCommerce, Commandes, ouvrez la commande, puis « Rembourser » : l'appel API Mobupay gère le remboursement total ou partiel.

Tester

Avec une clé sk_test_…, passez une commande et payez sur la page Mobupay avec la carte de test Monext 5476 4309 9999 9892 (CVV 123, date d'expiration future). La commande doit passer « en traitement » après le webhook payment.captured. Testez les checkouts classique et blocks, ainsi qu'avec HPOS activé.