# 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.

`<callout class="info">📸 <strong>Capture d'écran à insérer :</strong> 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</callout>`

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 :

<table id="bkmrk-%C3%89tape-qui-action-%C3%89ta"><thead><tr><th>Étape</th><th>Qui</th><th>Action</th></tr></thead><tbody><tr><td>Étape 1 — Génération</td><td>Admin PAAF / Admin Plateforme</td><td>Sélection des tuteurs éligibles, calcul des montants par élève, création des lots</td></tr><tr><td>**Étape 2 — Validation**</td><td>**Vous (Validateur PAAF)**</td><td>Contrôle des lots par tuteur, approbation ou rejet</td></tr><tr><td>**Étape 3 — Envoi**</td><td>**Vous (Validateur PAAF)**</td><td>Soumission des paiements à l'API Vodacom (sans OTP)</td></tr><tr><td>Étape 4 — Suivi</td><td>Vous (Validateur PAAF)</td><td>Monitoring des statuts de paiement en temps réel</td></tr></tbody></table>

**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.

---