Aller au contenu

API Mobile Money Bénin — MTN MoMo & Moov Flooz

Résumé

Guide d'accès aux API Mobile Money des deux opérateurs GSM du Bénin (MTN MoMo et Moov Flooz). MTN dispose d'un portail développeur en libre-service avec sandbox gratuit ; Moov Africa exige un contrat commercial avant tout accès. L'approche recommandée est hybride : démarrer via un agrégateur (FedaPay) puis migrer vers les API natives.

Contenu structuré

1. MTN MoMo

Portail développeur : https://momodeveloper.mtn.com/ (sandbox gratuit, Postman collection incluse)

Inscription : Sign up → créer une application → obtenir API User, API Key, Subscription Key + certificats X.509.

Endpoints sandbox principaux

Fonction Méthode Endpoint
Request-to-Pay (paiement entrant) POST .../collection/v1_0/requesttopay
Transfer (paiement sortant) POST .../disbursement/v1_0/transfer
Balance GET .../collection/v1_0/accountholder/{partyId}/balance
Transaction status GET .../collection/v1_0/requesttopay/{referenceId}

Base sandbox : https://sandbox.momodeveloper.mtn.com

Passage en production : contrat commercial avec MTN Bénin ("MoMo for Business") → identifiants live fournis par MTN.

2. Moov Africa (Flooz)

Pas de portail libre-service. Accès uniquement via : - Demande de partenariat directe : moovmoney@moov.africa / +229 21 30 30 30 - Ou via un agrégateur (FedaPay, Flutterwave, PayDunya)

Étapes pour accès direct : 1. Contacter Moov Bénin → présenter le projet + volume estimé 2. Signer un contrat commercial → obtenir api_id, api_key, URL sandbox 3. Authentification : HMAC-SHA256 ou OAuth 2.0 selon version 4. Validation KYC/AML obligatoire avant production

Points de vigilance : - API versionnée — utiliser la version spécifiée au contrat - Sandbox avec plafonds de transaction faibles - KYC/AML requis pour la mise en production

3. Agrégateurs (approche hybride recommandée)

Agrégateur Couverture Docs
FedaPay MTN MoMo + Moov Flooz + autres https://fedapay.com/docs
Flutterwave Afrique de l'Ouest https://developer.flutterwave.com/docs/payments/mobile-money/
PayDunya Afrique francophone https://paydunya.com/docs/index.html

Stratégie : lancer avec FedaPay (intégration unique, quelques semaines) → migrer progressivement vers API natives (réduction de coûts, meilleur contrôle).

4. Pattern d'abstraction recommandé

interface MobileMoneyProvider {
  requestToPay(amount, phone, reference): Promise<PaymentResult>;
  transfer(amount, phone, reference): Promise<TransferResult>;
  getStatus(referenceId): Promise<TransactionStatus>;
}

class MTNMoMoProvider implements MobileMoneyProvider { ... }
class MoovFloozProvider implements MobileMoneyProvider { ... }
class AggregatorProvider implements MobileMoneyProvider { ... }  // FedaPay

5. Liens utiles

Objectif URL
MTN MoMo Developer Portal https://momodeveloper.mtn.com/
MTN MoMo page béninoise https://www.mtn.bj/momo/developpeurs/momo-api/
Moov Africa Bénin https://www.moov.africa/bj/
FedaPay docs https://fedapay.com/docs
Exemple code MTN (PHP/Node/Python) https://github.com/Chizzoz/mtn-momo-developer-basics
Exemple Flooz communautaire (PHP) https://github.com/Tech228/FloozAPI/blob/master/Procedures.md
Postman MTN MoMo https://www.postman.com/spacecraft-specialist-45488786/mtn-momo-developer-api/overview

Points clés

  • MTN MoMo : sandbox gratuit accessible immédiatement via https://momodeveloper.mtn.com/
  • Moov Flooz : accès direct uniquement sur contrat — passer par FedaPay pour démarrer
  • FedaPay couvre les deux opérateurs en une seule intégration REST
  • Concevoir une interface MobileMoneyProvider dès le départ pour isoler les implémentations
  • Authentification MTN : certificats X.509 — prévoir la gestion de leur rotation

Prochaines étapes concrètes

  1. Créer compte développeur MTN MoMo (sandbox gratuit, immédiat)
  2. Tester Request-to-Pay et Transfer en sandbox MTN
  3. Contacter Moov Bénin par email pour démarrer le processus de partenariat
  4. Évaluer FedaPay sandbox pour couverture rapide des deux opérateurs

Liens connexes