PrestaShop

Prérequis

• PrestaShop 1.7.6+, 8.x ou 9.x, PHP 7.4+.
• Devises : EUR, XPF (converties en unité mineure automatiquement).
• Une clé API Mobupay (sk_test_… / sk_live_…) et le secret whsec_…, depuis votre espace marchand.

Installation

Le module embarque le SDK PHP mobupay/mobupay-php. Construisez le paquet avec ses dépendances, puis téléversez-le.

cd connectors/prestashop/mobupay
composer install --no-dev --optimize-autoloader
# puis zippez le dossier mobupay/ (avec vendor/)

1. 1Zippez le dossier mobupay/ (en incluant vendor/).
2. 2PrestaShop, Modules, Gestionnaire de modules, Téléverser un module, puis Installer.
3. 3Cliquez Configurer sur le module Mobupay.

Configuration

• Mode test pour démarrer, clé sk_test_… et 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 (…/index.php?fc=module&module=mobupay&controller=webhook) est affichée en haut de la page de configuration et transmise automatiquement à chaque paiement.

Fonctionnement

1. 1Le client choisit « Carte bancaire (Mobupay) » et valide.
2. 2La commande est créée à l'état « En attente du paiement Mobupay », une session est créée, le client est redirigé vers la page hébergée.
3. 3Le client paie par carte (widget Monext) sur la page Mobupay.
4. 4Le webhook signé fait passer la commande à « Paiement accepté » (ou « Erreur », « Annulée », « Remboursée » selon l'événement), après vérification de la signature et rapprochement via externalId.

Remboursement

Depuis PrestaShop, Commandes, ouvrez la commande, « Avoir partiel / remboursement » : la création d'un avoir appelle l'API Mobupay (total ou partiel) et passe la commande en « Remboursée ».

Tester

Avec une clé sk_test_…, passez une commande et payez avec la carte de test Monext 5476 4309 9999 9892 (CVV 123, expiration future). La commande doit passer « Paiement accepté » après le webhook. Validé de bout en bout sur PrestaShop 9.1.4.