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) 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). Liens affiliés : Fosia Ltd peut toucher une commission, sans surcoût pour vous. Comment nous choisissons nos outils (en anglais).
2. Installer l’extension
Lite : dans WordPress, allez dans Extensions › Ajouter, cherchez Fosia Pay Lite, puis Installer et Activer (page WordPress.org), ou prenez le ZIP gratuit dans la boutique. Formules payantes : après le paiement, votre clé de licence arrive par e-mail et le téléchargement Pro est dans Mon compte.
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.
Recevoir des dons Mobile Money
Des pages de collecte gratuites pour les églises, écoles, associations et familles.
Lancer un programme d’affiliation
Liens partenaires, codes promo et versements mensuels par Mobile Money.
Lire le guide (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, 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.
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).
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
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.
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.
Guide développeur
Routes de l’API REST, authentification et serveur MCP pour les agents IA.
Ouvrir le guide (en anglais)
Formules et limites
Ce que comprend Lite, ce qu’ajoute chaque formule payante, et ce qui se passe à l’expiration.
Hébergement, constructeur de site, cours en ligne, e-mail : les outils que nous recommandons (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 (en anglais)