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_…), depuis votre espace marchand. C'est le seul secret à saisir : le secret de signature des webhooks est récupéré automatiquement.

Où récupérer le module

Le module n'est pas encore publié sur PrestaShop Addons. L'archive installable est publique et prête à l'emploi : elle embarque déjà le SDK PHP, vous n'avez rien à construire ni aucune commande à lancer sur votre serveur.

Télécharger le module Mobupay pour PrestaShop. Le lien vous donne toujours la dernière version. Le code source est public, si vous souhaitez auditer ce que le module fait avant de l'installer.

Installation

1. 1PrestaShop, Modules, Gestionnaire de modules, Téléverser un module, choisir l'archive.
2. 2Cliquez Installer, puis Configurer sur le module Mobupay.

Configuration

• Mode test pour démarrer, puis la clé sk_test_…. À l'enregistrement, le module vérifie la clé, récupère le secret de signature et vous confirme dans quel environnement vous êtes.
• Détail de la commande et coordonnées du client : actifs par défaut. Tout est déduit de la commande, vous n'avez aucun champ à remplir. C'est ce qui permet à vos factures Mobupay de détailler chaque ligne et de porter 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 facture reste en brouillon, à compléter depuis votre espace marchand : 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.
• 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.