C.4.4.3 — Suivi des paiements M-Pesa
4.3 Suivi des paiements M-Pesa
4.3.1 Accéder à l'écran de suivi M-Pesa
📸 Capture d'écran à insérer : Page de suivi M-Pesa : zone de filtres (Recherche par référence ou numéro de compte, Statut — liste déroulante, Dates "Du" / "Au", bouton Réinitialiser), tableau "Suivi des paiements M-Pesa" avec colonnes Référence du lot / Tuteur (nom + numéro masqué) / Date d'envoi / Montant total / Compteurs (Total / Payé / En cours / Échoué ou Annulé) / Actions
4.3.2 Description des filtres disponibles
| Filtre |
Type |
Description |
| Recherche |
Champ texte |
Recherche par référence de lot ou numéro de compte M-Pesa |
| Statut global |
Liste déroulante |
Filtre par statut global du lot (Envoyé / En cours / Partiellement payé / Payé / Échoué) |
| Du |
Sélecteur de date |
Date de début de la période de suivi |
| Au |
Sélecteur de date |
Date de fin de la période de suivi |
| Réinitialiser |
Bouton |
Efface tous les filtres actifs |
4.3.3 Description des colonnes du tableau de suivi M-Pesa
| Colonne |
Description |
| Référence du lot |
Identifiant unique du lot M-Pesa |
| Tuteur / Compte |
Nom complet du tuteur + numéro M-Pesa partiellement masqué |
| Date d'envoi |
Date et heure de la soumission à l'API Vodacom |
| Montant total |
Montant total du lot en CDF |
| Total paiements |
Nombre total de paiements individuels dans le lot (un par élève) |
| Payé |
Nombre de paiements individuels confirmés comme réussis (badge vert) |
| En cours |
Nombre de paiements en attente de confirmation Vodacom (badge bleu) |
| Échoué / Annulé |
Nombre de paiements en échec ou annulés (badge rouge) |
| Actions |
Bouton Voir les détails |
📸 Capture d'écran à insérer : Tableau de suivi M-Pesa avec plusieurs lots : lot 1 "REF-MPESA-0023" / "HUDISA MUSUKISA JULLIE — 243984****83" / "25/11/2025 21h45" / "15 000 CDF" / Total : 1 / Payé : 1 (vert) / En cours : 0 / Échoué : 0. Lot 2 similaire avec Payé : 0 / En cours : 0 / Échoué : 1 (rouge). Les badges colorés ressortent visuellement
4.3.4 Comprendre les statuts globaux d'un lot M-Pesa
| Statut global |
Signification |
| Envoyé |
Lot soumis à l'API Vodacom, traitement en cours |
| En cours |
Certains paiements du lot sont encore en attente de confirmation |
| Partiellement payé |
Certains paiements du lot ont réussi, d'autres ont échoué |
| Payé |
Tous les paiements du lot ont été confirmés comme réussis par Vodacom |
| Échoué |
Tous les paiements du lot ont échoué |
4.3.5 Consulter le détail d'un lot M-Pesa
Cliquez sur Voir les détails sur la ligne du lot.
📸 Capture d'écran à insérer : Fenêtre modale "Détails du lot M-Pesa REF-MPESA-0023" : bloc "Informations du lot" (Tuteur : HUDISA MUSUKISA JULLIE, Référence, Compte M-Pesa, Agent, Prestataire : Vodacom M-Pesa, Date d'envoi, Envoyé par : nom du Validateur, Montant total, Statut global), séparateur, bloc "Paiements individuels" — tableau avec colonnes : N° / UID Élève / Nom de l'élève / Montant unitaire / Statut individuel (badge Payé vert / Échoué rouge avec motif / En attente gris) / Date de confirmation. Bouton "Fermer"
Cette vue permet d'identifier précisément :
- Quelles élèves ont été payées avec succès
- Quelles élèves n'ont pas reçu leur paiement et pourquoi
- La date et l'heure exacte de chaque confirmation Vodacom
4.3.6 Comprendre les statuts individuels des paiements M-Pesa
| Statut individuel |
Couleur |
Signification |
Action recommandée |
| En attente |
Gris |
Paiement soumis à Vodacom, pas encore de réponse |
Patienter, le résultat arrive sous quelques minutes |
| Payé |
Vert |
Vodacom confirme que le montant a été crédité sur le compte du tuteur |
Aucune action requise |
| Échoué |
Rouge |
Vodacom a rejeté le paiement (motif disponible) |
Voir motif, corriger données tuteur, régénérer via Admin PAAF |
| Annulé |
Gris foncé |
Paiement annulé suite au rejet du lot par le Validateur (étape 2) |
N/A |
📸 Capture d'écran à insérer : Vue détaillée d'un lot M-Pesa partiellement échoué : tableau "Paiements individuels" montrant 3 lignes — ligne 1 badge vert "Payé" (15 000 CDF, confirmé le 25/11/2025 à 21h46) / ligne 2 badge rouge "Échoué — Compte inactif ou inexistant" (15 000 CDF) / ligne 3 badge vert "Payé". Le problème est clairement identifiable sur la ligne 2
4.3.7 Gestion des paiements M-Pesa en échec
Contrairement aux fichiers Equity (qui peuvent être renvoyés directement), un paiement M-Pesa individuel en échec ne peut pas être "relancé" directement depuis l'écran de suivi. La procédure est la suivante :
- Identifiez le motif de l'échec dans la vue détaillée du lot (colonne Statut individuel).
- Transmettez l'information à l'Admin Plateforme ou Admin ONG pour correction des données du tuteur concerné (numéro M-Pesa invalide, compte bloqué, nom différent, etc.).
- L'Admin PAAF régénère un nouveau lot pour le ou les tuteurs concernés, ciblant uniquement les élèves dont le paiement a échoué.
- Le nouveau lot suit le cycle complet : validation par le Validateur → envoi → suivi.
📸 Capture d'écran à insérer : Processus de correction après échec M-Pesa : diagramme en 4 étapes — Étape 1 "Identifer l'échec dans Suivi M-Pesa" → Étape 2 "Transmettre le motif à l'Admin (correction fiche tuteur)" → Étape 3 "Admin PAAF régénère un nouveau lot ciblé" → Étape 4 "Valider et envoyer le nouveau lot"
Motifs d'échec M-Pesa les plus courants et corrections associées :
| Motif d'échec Vodacom |
Cause probable |
Correction dans la fiche tuteur |
| Compte inactif ou inexistant |
Numéro M-Pesa non activé ou erroné |
Vérifier et corriger le numéro M-Pesa dans la fiche tuteur |
| Nom du bénéficiaire ne correspond pas |
Le nom enregistré en PIGBF diffère du nom enregistré chez Vodacom |
Corriger le nom du tuteur ou le numéro de compte |
| Solde insuffisant (opérateur) |
Problème technique côté Vodacom |
Relancer le lot, généralement résolu automatiquement |
| Compte bloqué |
Le tuteur a son compte M-Pesa bloqué |
Le tuteur doit contacter Vodacom pour débloquer son compte |
| Montant hors limites |
Montant inférieur au minimum ou supérieur au maximum M-Pesa |
Vérifier la configuration des tranches (Admin Plateforme) |