MobupayMobupayDocumentation
Chargement de vos clés API…

WooCommerce

Extension de paiement pour WordPress / WooCommerce.

Validé de bout en bout

Prérequis

  • WordPress 6.0+, WooCommerce actif, PHP 7.4+.
  • Une clé API Mobupay (sk_test_… pour tester, sk_live_… en production) et le secret webhook whsec_…, depuis votre espace marchand, rubrique Développeurs, Clés API.

Installation

L'extension embarque le SDK PHP mobupay/mobupay-php. Construisez le paquet avec ses dépendances, puis téléversez-le dans WordPress.

cd connectors/woocommerce/mobupay-for-woocommerce
composer install --no-dev --optimize-autoloader
# puis zippez le dossier mobupay-for-woocommerce/ (avec vendor/)
  1. 1Zippez le dossier mobupay-for-woocommerce/ (en incluant vendor/).
  2. 2WordPress, Extensions, Ajouter, Téléverser une extension, puis Activer.
  3. 3WooCommerce, Réglages, Paiements, ouvrez Mobupay.

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_…) et le secret whsec_….
  • 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.

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é.