# Documentation URL: https://pay.fosiarw.com/fr/documentation/ Updated: 2026-11-02 Site: Fosia Pay Bien démarrer # Installer le Mobile Money sur WooCommerce : de l’installation au premier paiement Cinq étapes pour accepter MTN MoMo, Orange Money, Wave, Moov Money, Airtel Money et M-Pesa avec Fosia Pay. Faites-les d’abord en mode sandbox (test), puis passez en production. Vous utilisez **Fosia Collect**, le formulaire gratuit de don et de paiement ? Aller au guide Fosia Collect ### 1. Vérifier les prérequis WordPress 5.8 ou plus récent, WooCommerce 5.0 ou plus récent, PHP 7.4 ou plus récent, HTTPS sur votre boutique, et un compte marchand PawaPay (l’inscription est gratuite sur pawapay.io ; demandez-leur d’activer les pays et les opérateurs dont vous avez besoin). Pas encore d’hébergement ? L’hébergement web [Hostinger (lien affilié, s’ouvre dans un nouvel onglet)](https://www.hostinger.com?REFERRALCODE=1FRANCISFOK10) comprend le certificat SSL dont vous avez besoin, et nos modules Divi demandent le [thème Divi d’Elegant Themes (lien affilié, s’ouvre dans un nouvel onglet)](https://www.elegantthemes.com/affiliates/idevaffiliate.php?id=51656). Liens affiliés : Fosia Ltd peut toucher une commission, sans surcoût pour vous. [Comment nous choisissons nos outils](/recommended-tools/) (en anglais). ### 2. Installer l’extension **Lite :** dans WordPress, allez dans Extensions › Ajouter, cherchez *Fosia Pay Lite*, puis Installer et Activer ([page WordPress.org](https://wordpress.org/plugins/fosia-pay-lite/)), ou prenez le ZIP gratuit dans la [boutique](/shop/). **Formules payantes :** après le paiement, votre clé de licence arrive par e-mail et le téléchargement Pro est dans [Mon compte](/my-account/). Dans WordPress, allez dans Extensions › Ajouter › Téléverser une extension, choisissez le ZIP, installez et activez. ### 3. Ajouter votre jeton PawaPay (et votre clé de licence) Allez dans WooCommerce › Réglages › Paiements et ouvrez Fosia Pay. Collez votre jeton API (le jeton sandbox pour les tests). Avec une formule payante, collez aussi votre clé de licence. Sans clé valide, Fosia Pay fonctionne en mode Lite. ### 4. Déclarer l’adresse de callback chez PawaPay Copiez l’adresse de callback affichée dans les réglages de Fosia Pay dans votre tableau de bord PawaPay, sous System Configuration › Callback URLs (Deposits). Les callbacks signés y sont facultatifs : dans tous les cas, Fosia Pay vérifie chaque paiement auprès de PawaPay avant qu’une commande change de statut. Plusieurs boutiques sur un seul compte ? Le routeur de callbacks de la formule Agency s’en charge avec une seule adresse. ### 5. Tester, puis passer en production Passez une commande de test avec un numéro sandbox et vérifiez que la commande passe toute seule en « En cours » (Processing). Passez ensuite à votre jeton de production. C’est tout. Guides ## Guides pas à pas ### Accepter Orange Money et MTN MoMo sur WooCommerce Installer l’extension gratuite, relier votre compte de paiement, tester en sandbox et passer en production. [Lire le guide](/fr/plugin-orange-money-mtn-momo-woocommerce/) ### Recevoir des dons Mobile Money Des pages de collecte gratuites pour les églises, écoles, associations et familles. [Lire le guide](/fr/recevoir-des-dons-mobile-money-wordpress/) ### Lancer un programme d’affiliation Liens partenaires, codes promo et versements mensuels par Mobile Money. [Lire le guide](/woocommerce-affiliate-program-mobile-money/) (en anglais) Fosia Collect ## Fosia Collect : un formulaire de don ou de paiement sur n’importe quelle page L’extension gratuite pour les ONG, églises, écoles, associations et indépendants : pas besoin de WooCommerce. Cinq étapes, d’abord en mode sandbox. ### 1. Installer Fosia Collect Téléchargez le zip gratuitement depuis la [page Fosia Collect](/fr/fosia-collect/), puis dans WordPress allez dans Extensions › Ajouter › Téléverser une extension, choisissez le zip, installez et activez. La configuration guidée s’ouvre. Il faut WordPress 6.3 ou plus récent et PHP 7.4 ou plus récent ; WooCommerce n’est pas nécessaire. ### 2. Relier votre compte de paiement Choisissez Sandbox (test) ou Live (production) et collez votre jeton API PawaPay : il est testé avant d’être enregistré, stocké chiffré et plus jamais affiché. Indiquez ensuite le nom et le pays de votre organisation. Tout se modifie plus tard dans Fosia Collect › Réglages. ### 3. Coller l’adresse de callback (facultatif) Copiez l’adresse de callback affichée dans les réglages dans votre tableau de bord PawaPay, sous System Configuration › Callback URLs (Deposits, et Refunds si vous remboursez depuis WordPress). La confirmation est alors plus rapide. Votre compte garde une seule adresse par type : si votre boutique l’utilise déjà, laissez-la ; Fosia Collect confirme quand même chaque paiement en interrogeant lui-même votre compte de paiement. ### 4. Ajouter le formulaire à une page Cliquez sur « Create a donation page » à la fin de la configuration, ou modifiez n’importe quelle page et ajoutez le bloc **Fosia Collect form**. Ses réglages sont dans la barre latérale : Faire un don ou Payer, les montants, la monnaie, les champs et le message ou la page de remerciement. ### 5. Tester, puis passer en production En mode sandbox, le formulaire affiche un bandeau « Test mode: no real money ». Payez avec un des numéros de test sandbox de PawaPay et vérifiez que le paiement apparaît payé dans Fosia Collect › Transactions. Passez ensuite en Live avec votre jeton de production. [Télécharger Fosia Collect](/product/fosia-collect/) Le formulaire ## Bloc ou shortcode Le bloc fonctionne dans l’éditeur WordPress. Avec un autre constructeur de pages (Divi, Elementor…), collez le shortcode. **Options :** type (donation ou payment), title (titre), text (texte), amount (un montant fixe) ou amounts (séparés par ; ou |), other (yes/no : montant libre), min, max, currency (monnaie), country (pays), name et email (off, optional ou required), message (yes/no), anonymous (yes/no : don anonyme), field (intitulé d’un champ en plus) et field_required (yes/no), button (bouton), thanks, thanks_url (remerciement), id (garde les totaux d’un formulaire ensemble quand vous changez son titre). Exemples de shortcode ``` Soutenez notre école Le paiement en ligne n'est pas encore disponible. Revenez bientôt. Frais du 1er trimestre Le paiement en ligne n'est pas encore disponible. Revenez bientôt. ``` Remboursements ## Rembourser un paiement - NOuvrez le paiement dans Fosia Collect › Transactions, puis « Details and refund » - NTotal ou partiel : l’argent retourne au numéro Mobile Money qui a payé - NJamais plus que ce qui a été payé, moins les remboursements déjà faits - NUn remboursement fait ailleurs (espèces, tableau de bord de votre compte de paiement) peut être noté sur le même écran - NChaque remboursement est confirmé avant l’envoi et suivi jusqu’à son statut final ; les notes gardent qui a remboursé, quand et combien Cache de pages ## Mettre la page en cache Le formulaire fonctionne sur des pages en cache, et les pages de statut ne sont jamais mises en cache. Si votre cache garde les adresses avec paramètres, excluez `fcol_payment`, ou excluez la page qui contient le formulaire. FAQ ## Questions sur Fosia Collect ### Est-ce que ça marche avec un cache de pages (LiteSpeed Cache, WP Rocket, cache Hostinger) ? Oui. La page du formulaire peut rester en cache : juste avant l’envoi, le formulaire demande à votre site un code de sécurité neuf, et les pages de statut (adresses avec `fcol_payment`) sont marquées « ne pas mettre en cache ». Si votre extension de cache garde quand même les adresses avec paramètres, excluez `fcol_payment`. Vous pouvez aussi exclure la page qui contient le formulaire, comme nous le faisons sur ce site. ### Beaucoup de personnes paient depuis le même Wi-Fi. Seront-elles bloquées ? Non. Seuls les paiements qui démarrent vraiment sont comptés, par numéro de téléphone, par navigateur et par connexion, et un numéro mal saisi ou un « Réessayer » ne comptent jamais. Vous pouvez relever les limites dans Réglages › Protection contre les abus. ### Comment savoir pour quel élève, quelle facture ou quel membre est un paiement ? Ajoutez un champ au formulaire : dans le panneau Champs du bloc, tapez son intitulé (par exemple « Nom et classe de l’élève ») et choisissez Obligatoire. La réponse apparaît dans Transactions, dans l’export CSV, dans votre e-mail et sur le reçu du payeur. ### Un payeur sans adresse e-mail demande ses données ou leur suppression. Les outils d’export et d’effacement de WordPress cherchent par adresse e-mail. Pour un payeur sans e-mail, cherchez dans Fosia Collect › Transactions par son numéro Mobile Money, son nom ou la référence, et répondez à partir de là. FAQ ## Questions d’installation ### Où trouver l’adresse de callback ? Dans WordPress, WooCommerce › Réglages › Paiements › Fosia Pay l’affiche avec un bouton Copier. Collez-la dans votre tableau de bord PawaPay, sous System Configuration › Callback URLs (Deposits). ### Comment tester sans argent réel ? Choisissez le mode Sandbox (bac à sable) et collez votre jeton API sandbox, puis passez une commande avec un des numéros de test de PawaPay. La commande doit passer toute seule en « En cours » (Processing). Passez à votre jeton de production quand c’est le cas. ### La commande reste « En attente de paiement ». Que vérifier ? Que l’adresse de callback est bien enregistrée dans votre tableau de bord PawaPay, que votre site est en HTTPS, et qu’aucune extension de sécurité ni pare-feu ne bloque les requêtes vers `/wp-json/`. Le bouton « Test Connection » des réglages vérifie votre jeton. Toujours bloqué ? [Réservez un appel d’installation gratuit](/fr/support/). ### Quels pays et quels réseaux puis-je accepter ? Ceux activés sur votre compte PawaPay, parmi 21 pays africains et 43 réseaux (MTN MoMo, Orange Money, Wave, Moov Money, Airtel Money, M-Pesa et d’autres). Demandez à PawaPay d’activer ceux dont vous avez besoin. ### Puis-je garder les prix de ma boutique en dollars ou en euros ? Oui. Fosia Pay convertit le montant dans la monnaie Mobile Money du client au moment du paiement, au taux du jour. Aide ## Besoin d’un coup de main ? ### Appel d’installation Chaque licence payante comprend un appel gratuit pour installer Fosia Pay avec vous. [Réserver un appel](/fr/support/#book) ### Guide développeur Routes de l’API REST, authentification et serveur MCP pour les agents IA. [Ouvrir le guide](/developers/) (en anglais) ### Formules et limites Ce que comprend Lite, ce qu’ajoute chaque formule payante, et ce qui se passe à l’expiration. [Voir les tarifs](/fr/tarifs/) Hébergement, constructeur de site, cours en ligne, e-mail : [les outils que nous recommandons](/recommended-tools/) (en anglais) **Fosia Pay Lite vous plaît ? Il reste gratuit.** S’il vous aide, vous pouvez nous remercier par un petit don en Mobile Money. [Soutenir Fosia Pay](/support-fosia-pay/) (en anglais)