📍 Article principal : EdTech francophone open-source 2026
Introduction
Une école de formation à Conakry voulait monétiser ses cours en ligne mais les apprenants guinéens n’ont massivement pas de carte bancaire — ils paient en Orange Money ou MTN Mobile Money. Sans intégration mobile money, l’école excluait 90 % de son marché potentiel. La mise en place d’un plugin PayDunya sur Moodle, qui agrège plusieurs PSP de la sous-région, a transformé l’opération : les apprenants paient en un tap depuis leur smartphone, l’inscription au cours est validée automatiquement par webhook, plus aucune intervention manuelle. Ce tutoriel détaille l’intégration des paiements mobile money sur Moodle pour les structures EdTech ouest-africaines : choix de l’agrégateur, configuration du plugin, gestion des webhooks, réconciliation, et patterns spécifiques aux différents pays UEMOA.
Prérequis
- Plateforme Moodle 4.5 fonctionnelle
- Compte marchand chez un agrégateur PSP (PayDunya, CinetPay, ou Wave Direct selon stratégie)
- Domaine HTTPS configuré pour Moodle
- Niveau : intermédiaire — Temps : 2 heures
Étape 1 — Choisir agrégateur ou intégration directe
Deux stratégies coexistent en 2026 pour accepter les paiements mobile money. L’agrégateur regroupe plusieurs PSP sous une seule API : PayDunya supporte Wave, Orange Money, MTN, Moov sur 8 pays UEMOA. CinetPay couvre les mêmes PSP avec une interface différente. Avantage : une seule intégration technique pour couvrir tous les moyens de paiement. Inconvénient : commission plus élevée (typiquement 2-3 %) et dépendance à un tiers. L’intégration directe avec chaque PSP individuellement (Wave Direct, Orange Money API, etc.) demande plusieurs intégrations distinctes mais réduit les frais à 0-1,5 % selon le PSP. Pour les MVP et démarrages, l’agrégateur est généralement préférable : déploiement rapide en une journée. Pour les structures matures avec gros volumes, l’intégration directe optimise la marge.
PayDunya est l’agrégateur dominant chez les structures EdTech ouest-africaines en 2026 grâce à sa couverture multi-pays et sa documentation française complète. Compte marchand validé en 5 jours ouvrés après vérification d’identité. Tarification transparente, support technique en français accessible. CinetPay est une alternative crédible, particulièrement présente en Côte d’Ivoire. Pour cibler principalement le Sénégal et la Côte d’Ivoire avec optimisation marge, intégration directe Wave Direct plus Orange Money API peut être plus rentable.
Étape 2 — Installer le plugin PayDunya
Le plugin PayDunya pour Moodle se télécharge depuis le marketplace officiel ou le repo GitHub PayDunya. Installation via Administration → Plugins → Installer un plugin → uploader le ZIP. Moodle détecte le nouveau plugin et propose la mise à jour automatique de la base.
# Installation manuelle alternative
cd /srv/moodle/moodle_html/enrol
git clone https://github.com/paydunya/moodle-paydunya.git paydunya
chown -R www-data:www-data paydunya
# Puis dans Moodle : Administration → Notifications → Mettre à jourUne fois installé, le plugin apparait dans Administration → Plugins → Méthodes d’inscription. L’activer et le configurer avec les credentials API PayDunya récupérés depuis le tableau de bord PayDunya : master key, public key, private key, token. En mode test, configurer le mode sandbox PayDunya pour valider l’intégration sans transactions réelles. En mode production, basculer vers les credentials de production une fois validé.
Étape 3 — Configuration du plugin par cours
Dans chaque cours payant, l’enseignant active la méthode d’inscription « PayDunya » depuis Paramètres du cours → Méthodes d’inscription. Configuration : devise (XOF pour la zone CFA), montant (par exemple 25 000 FCFA), durée d’accès au cours (3 mois, 1 an, illimité), rôle attribué après paiement (généralement « Étudiant »). Le bouton « S’inscrire via PayDunya » apparait alors sur la page du cours pour les utilisateurs non-inscrits.
Pour les structures avec catalogue de cours diversifiés, on peut combiner plusieurs méthodes : PayDunya pour les paiements mobile money, Stripe pour les cartes bancaires internationales (diaspora), et inscription manuelle gratuite pour les boursiers ou partenariats. Cette flexibilité couvre tous les segments de clientèle sans complexifier l’expérience apprenant.
Étape 4 — Webhooks et inscription automatique
Quand l’apprenant paye via PayDunya, l’agrégateur notifie Moodle via un webhook IPN. Moodle vérifie la signature, valide le paiement, et inscrit automatiquement l’apprenant au cours. Tout cela sans intervention manuelle. La configuration du webhook se fait dans le tableau de bord PayDunya : URL de notification pointant vers https://cours.example.sn/enrol/paydunya/ipn.php.
Pour la sécurité, le plugin Moodle vérifie la signature de chaque webhook reçu pour s’assurer qu’il vient bien de PayDunya et n’a pas été falsifié. Les webhooks acceptés sont enregistrés dans la table de logs Moodle pour traçabilité. En cas de litige avec un apprenant qui dit avoir payé sans inscription validée, on peut retrouver l’historique complet de la transaction depuis l’IPN PayDunya jusqu’à l’inscription Moodle.
Étape 5 — Réconciliation et rapports
Pour la comptabilité de l’école, on configure un rapport Moodle qui liste pour chaque période les inscriptions PayDunya réussies avec leurs montants et apprenants. Ce rapport facilite la facturation des prestations et la déclaration fiscale. PayDunya expose aussi son propre rapport via leur tableau de bord ou API : montants reçus, frais prélevés, virements bancaires effectués vers le compte de l’école.
La règle pratique de réconciliation : croiser mensuellement les inscriptions Moodle PayDunya avec les transactions PayDunya côté agrégateur. Toute divergence (paiement reçu sans inscription, ou inscription sans trace de paiement) signale un problème à investiguer immédiatement. Avec le pattern bien configuré, les divergences sont rares (typiquement 0,1-0,5 % des transactions) et toujours résolues sous 48h via le support PayDunya.
Étape 6 — Optimiser l’UX de paiement
L’expérience de paiement influence directement le taux de conversion. Quatre optimisations qui font la différence. Premièrement, afficher clairement le prix avant le clic d’inscription, avec mention « TTC » et durée d’accès. Pas de surprise au moment de payer. Deuxièmement, proposer un choix visuel des moyens de paiement (logos Wave, Orange Money, MTN, Visa) plutôt qu’une liste textuelle. Le visuel rassure et accélère le choix. Troisièmement, simplifier le tunnel : minimum d’écrans entre clic et paiement effectué. Plus de 3 écrans intermédiaires, on perd des conversions. Quatrièmement, envoyer un email immédiat de confirmation avec accès au cours et instructions claires pour démarrer. Premier message déterminant pour l’engagement.
Pour les apprenants qui hésitent, proposer un cours d’introduction gratuit ou les premiers chapitres en accès libre baisse considérablement la friction d’achat. Cette stratégie freemium augmente typiquement le taux de conversion final de 30-50 % par rapport à un paywall strict.
Erreurs fréquentes
| Erreur | Cause | Solution |
|---|---|---|
| Paiement reçu mais inscription non validée | Webhook bloqué par firewall | Vérifier que /enrol/paydunya/ipn.php est accessible publiquement |
| Erreur signature webhook | Master key incorrecte | Vérifier les credentials dans Administration plugin |
| Tarif affiché en mauvaise devise | Configuration cours en EUR au lieu de XOF | Configurer XOF dans paramètres cours |
| Apprenant ne reçoit pas l’email confirmation | SMTP Moodle mal configuré | Tester via Administration → Email |
| Dashboard PayDunya hors ligne | Maintenance PayDunya | Vérifier statut sur status.paydunya.com |
Adaptation au contexte ouest-africain
Trois aspects pratiques. Premièrement, les frais d’agrégateur sont à intégrer dans la marge : typiquement 2-3 % chez PayDunya. Pour un cours à 25 000 FCFA, frais 500-750 FCFA. Acceptable face au volume débloqué. Deuxièmement, la latence de virement de PayDunya vers le compte bancaire de l’école est typiquement T+2 à T+5 jours ouvrés. Prévoir cette trésorerie dans les flux de l’école pour ne pas être surpris. Troisièmement, pour les apprenants de la diaspora qui paient en EUR ou USD, accepter aussi Stripe ou un agrégateur international (RemitlyPay, Wise) en plus du mobile money local. Cette double offre couvre tous les profils.
Pour les coûts, le plugin PayDunya est gratuit, l’inscription au compte marchand est gratuite, seuls les frais par transaction s’appliquent. Le ROI sur l’intégration est immédiat dès le premier cours vendu via mobile money.
Tutoriels frères
Pour aller plus loin
- 🔝 Pilier : EdTech francophone 2026
- Articles : Hono Wave Orange Money webhooks
- Doc : PayDunya API
FAQ
Combien de temps pour ouvrir un compte marchand PayDunya ?
5 à 10 jours ouvrés après dépôt du dossier (justificatifs structure, identité gérant, RIB).
PayDunya supporte-t-il les remboursements ?
Oui via leur API. À implémenter en plus du plugin Moodle de base si besoin de gérer des remboursements automatiques.
Comment gérer les abonnements récurrents ?
PayDunya supporte les paiements récurrents en bêta en 2026. Pour des abonnements mensuels stables, possible mais demande quelques ajustements.
Existe-t-il un mode boutique multi-cours ?
Le plugin Moodle Shopping Cart combiné à PayDunya permet d’acheter plusieurs cours en une transaction. Configuration plus complexe mais utile pour cross-selling.
Comparaison détaillée des agrégateurs et PSP directs
Pour aider à choisir, voici un comparatif synthétique des options principales en 2026. PayDunya : couverture 8 pays UEMOA, commission 2-3 %, validation marchand 5-10 jours, support français mature. CinetPay : forte présence Côte d’Ivoire, commission similaire, intégration WordPress mature complétant Moodle. Wave Direct : gratuit pour le marchand au Sénégal et Côte d’Ivoire jusqu’à seuils élevés, intégration directe API, mais limité à Wave uniquement. Orange Money API directe : commission ~1 %, intégration officielle nécessitant signature contrat avec Sonatel/Orange CI/Orange BF selon pays. Stripe : pour cartes bancaires internationales, commission 2,9 % plus 0,30 dollar, idéal diaspora.
Stratégie recommandée pour démarrer : PayDunya en agrégateur principal pour couvrir tous les mobile money de la sous-région. Ajouter Wave Direct en complément pour réduire les frais sur les transactions Wave qui sont souvent majoritaires. Ajouter Stripe pour la diaspora et clients internationaux. Cette triple offre couvre 99 % des cas d’usage avec optimisation marge sur les volumes les plus importants.
Conformité paiement et facturation
Les paiements numériques sont soumis à plusieurs obligations administratives en Afrique de l’Ouest. Premièrement, la facturation : chaque transaction doit générer une facture conforme à la fiscalité du pays. Pour le Sénégal, mention TVA 18 %, numéro NINEA, en-tête conforme. Pour la Côte d’Ivoire, équivalent avec numéro CC. Le plugin Moodle peut générer automatiquement ces factures au format PDF. Deuxièmement, la traçabilité comptable : toutes les transactions doivent être journalisées avec leur preuve (IPN PayDunya, transaction ID PSP). Conservation 7 ans pour audit fiscal. Troisièmement, la TVA et impôts associés : chaque transaction génère TVA collectée à reverser mensuellement à l’administration fiscale. Le plugin de comptabilité Moodle ou un export vers un logiciel comptable (Sage, Wave Accounting) gère cette comptabilité.
Pour les structures qui démarrent, externaliser la comptabilité à un cabinet local pendant les premiers mois est rentable : éviter les erreurs administratives qui coûtent cher en pénalités. Une fois le pattern stable, internaliser la comptabilité avec un assistant comptable formé.
Cas concrets de monétisation EdTech 2025-2026
Trois cas de plateformes EdTech ouest-africaines qui monétisent via mobile money. Premier cas : une école de bureautique à Dakar qui propose 30 cours individuels à 5 000 FCFA chacun. Volume mensuel 800 inscriptions, soit 4 millions FCFA bruts dont environ 100 000 FCFA en frais PayDunya. Marge nette confortable, modèle économique viable. Deuxième cas : un institut de formation professionnelle à Abidjan avec abonnement mensuel à 25 000 FCFA donnant accès au catalogue complet. 200 abonnés actifs, 5 millions FCFA de revenus mensuels récurrents, taux de churn maîtrisé à 8 % grâce à un contenu régulièrement renouvelé. Troisième cas : une plateforme de tutorat scolaire à Cotonou qui combine cours gratuits accessibles à tous et certification payante (15 000 FCFA) pour ceux qui veulent valoriser leurs acquis. Volume freemium massif (plusieurs milliers d’apprenants), conversion de 5-8 % vers le payant, génère un revenu suffisant pour soutenir la création de contenu gratuit destiné aux familles modestes. Ces cas illustrent que l’intégration mobile money rend immédiatement viables des modèles économiques très diversifiés.
Synthèse
L’intégration des paiements mobile money sur Moodle débloque l’accès au marché ouest-africain pour les structures EdTech. La technique est mature et accessible, les coûts sont raisonnables, le retour sur investissement est immédiat dès les premières ventes. Pour les structures qui démarrent, démarrer avec PayDunya en agrégateur principal donne le meilleur compromis simplicité-couverture-coût. L’optimisation marge via intégration directe des PSP majeurs viendra naturellement quand le volume justifiera l’investissement technique supplémentaire.
Pour les structures qui hésitent, le ROI immédiat constaté chez les pionniers ouest-africains est un argument fort à prendre en compte.
Cette dynamique se confirme année après année avec une accélération notable depuis 2024 grâce à la maturité croissante des outils techniques et à la pénétration mobile money qui dépasse désormais 60 % de la population adulte urbaine dans plusieurs pays UEMOA selon les rapports BCEAO récents.