Skip to main content

C.3.3.1 — Vue d'ensemble du circuit M-Pesa

3.1 Vue d'ensemble du circuit M-Pesa

Le circuit M-Pesa gère les paiements mobile money destinés aux tuteurs des élèves bénéficiaires (ou directement aux élèves si elles sont désignées comme perceptrices autonomes dans leur fiche). Ces paiements correspondent à la part « tuteur/élève » de la bourse, versée directement sur le compte M-Pesa enregistré dans la plateforme.

La transmission des instructions M-Pesa repose sur une API B2C (Business-to-Consumer) de Vodacom Congo. Contrairement au circuit Equity (traitement asynchrone par fichiers H2H), les paiements M-Pesa sont soumis en temps quasi-réel : chaque paiement est initié individuellement via un appel API, et le résultat (succès ou échec) est disponible rapidement.

📸 Capture d'écran à insérer : Schéma du flux technique M-Pesa : laravel-pigbf (Validateur valide et envoie) → api-pigbf (appels API B2C Vodacom, un appel par paiement individuel) → Vodacom M-Pesa → crédit immédiat sur le compte mobile du tuteur → confirmation API → mise à jour statuts laravel-pigbf en temps réel

En tant que Validateur de Paiement PAAF, votre intervention dans le circuit M-Pesa couvre les mêmes étapes 2 et 3 que pour Equity :

Étape Qui Action
Étape 1 — Génération Admin PAAF / Admin Plateforme Sélection des tuteurs éligibles, calcul des montants par élève, création des lots
Étape 2 — Validation Vous (Validateur PAAF) Contrôle des lots par tuteur, approbation ou rejet
Étape 3 — Envoi Vous (Validateur PAAF) Soumission des paiements à l'API Vodacom (sans OTP)
Étape 4 — Suivi Vous (Validateur PAAF) Monitoring des statuts de paiement en temps réel

Différence clé avec Equity : L'envoi M-Pesa ne nécessite pas de code OTP. La sécurisation repose ici sur la stricte séparation des rôles (génération d'un côté, validation et envoi de l'autre) et sur la traçabilité complète de chaque action. La rapidité d'exécution API M-Pesa justifie cette conception.