Introduction à MafPay
MafPay est une API de paiement : elle permet à votre site ou à votre application d’encaisser de l’argent par mobile money (Wave, Orange Money…) sans avoir à intégrer chaque opérateur séparément. Vous parlez à MafPay, MafPay parle aux opérateurs.
Cette documentation est écrite pour qu’un·e débutant·e puisse réaliser une intégration complète. Si vous savez envoyer une requête HTTP, vous savez tout ce qu’il faut : les exemples sont fournis en curl, JavaScript (Node.js), Python et PHP.
Comment ça marche, en une image
Votre client Votre serveur MafPay Wave / Orange Money │ 1. clique « Payer » │ │ │ │ ─────────────────────────► │ 2. POST /payments/initiate/ │ │ │ ───────────────────────► │ 3. crée le paiement │ │ │ │ ───────────────────────► │ │ │ ◄─────────────────────── │ │ │ │ 4. lien + QR code │ │ │ ◄───────────────────────── │ │ │ │ 5. paie dans son appli mobile (Wave, Orange Money) │ │ │ ──────────────────────────────────────────────────────────────────────────────► │ │ │ │ 6. l'opérateur confirme │ │ │ 7. notification │ ◄─────────────────────── │ │ │ ◄─────────────────────── │ │ │ 8. « Merci, commande validée » (vous livrez) │ │En résumé, votre serveur :
- demande un paiement à MafPay (étape 2) ;
- montre le lien ou le QR code à votre client (étape 4) ;
- attend la notification de MafPay qui confirme que l’argent est bien arrivé (étape 7) ;
- seulement alors, livre la commande.
Le vocabulaire à connaître
| Mot | Ce que ça veut dire |
|---|---|
| Entreprise (company) | Votre compte MafPay. Elle a un identifiant public appelé endpoint_key (24 caractères) qui apparaît dans les adresses de l’API. |
| Application | Un « produit » de votre entreprise (ex : votre boutique en ligne). Chaque application a ses propres clés. |
| Clés API | Un couple pk_… (clé publique) et sk_… (secret) qui prouve que c’est bien votre application qui appelle. |
| Sandbox | Le mode test : aucun argent réel, MafPay simule l’opérateur. |
| Live | Le mode production : de vrais paiements. |
| Provider | Un opérateur de paiement : WAVE_SN, ORANGE_MONEY_SN… |
| Référence | L’identifiant d’un paiement, de la forme MAFPAY-XXXXXXXX. À conserver. |
| Webhook | Un appel que MafPay fait vers votre serveur pour vous prévenir qu’un paiement a changé d’état. |
Ce dont vous avez besoin
- Un compte MafPay et une application (voir Démarrage rapide).
- Un serveur qui peut envoyer des requêtes HTTPS (Node.js, Python, PHP, Java… n’importe quoi).
- Pour recevoir les notifications : une adresse HTTPS publique sur votre serveur (en local, un outil comme ngrok convient pour les tests).
Adresse de l’API
Toutes les requêtes commencent par :
https://api.mafpay.metalafrique-it.com/api/v1/{endpoint_key}/