Intégrer le Mobile Money en Côte d'Ivoire : guide technique

Pourquoi le Mobile Money est incontournable

En Côte d'Ivoire, le taux de bancarisation est d'environ 20% (Banque Mondiale, Global Findex 2021), contre un taux de pénétration Mobile Money bien supérieur. Concrètement : vos utilisateurs paient avec Wave et Orange Money, pas avec des cartes bancaires.

Si vous développez une application ou un service en CI, l'intégration du paiement mobile n'est pas optionnelle.

Les opérateurs et leurs APIs

Wave

Wave est l'opérateur qui a le plus disrupté le marché ivoirien. Leur API développeur est accessible via developer.wave.com :

• API REST avec documentation complète
• Paiements marchands (checkout)
• Webhooks pour notifications de transaction
• Sandbox pour tester

Orange Money

Orange expose ses APIs via Orange Developer (developer.orange.com) :

• Orange Money Payment API
• SMS API (pour les OTP)
• Sandbox disponible

L'intégration nécessite un contrat marchand avec Orange Côte d'Ivoire.

MTN MoMo

MTN offre une API ouverte via la plateforme MTN MoMo Developer Portal (momodeveloper.mtn.com) :

• API RESTful pour les paiements marchands et les décaissements
• Sandbox pour les tests
• Webhooks pour les callbacks

Architecture recommandée

Principes de base

• Backend-to-backend uniquement — N'appelez jamais les APIs de paiement depuis le frontend. Votre serveur doit servir de proxy.
• Webhooks obligatoires — Ne vous fiez pas au retour synchrone pour confirmer une transaction. Utilisez les callbacks webhook.
• Idempotence — Chaque transaction doit avoir un ID unique côté client pour éviter les doublons en cas de retry.
• Timeouts longs — Les APIs Mobile Money peuvent être lentes. Prévoyez des timeouts de 60 secondes minimum.

Sécurité

• Clés API en variables d'environnement, jamais dans le code source
• Validation des webhooks avec les signatures cryptographiques fournies par l'opérateur
• HTTPS obligatoire pour toutes les communications
• Logs de toutes les transactions pour la réconciliation

Cas concrets d'utilisation

• E-commerce — Checkout avec choix d'opérateur (Wave, Orange Money, MTN MoMo)
• SaaS — Paiement récurrent d'abonnement via Mobile Money (pas de prélèvement automatique disponible — il faut envoyer une demande de paiement à chaque échéance)
• Marketplace — Collecte du paiement puis décaissement vers le vendeur (nécessite les APIs de disbursement)
• Services à la demande — Paiement à l'acte (transport, livraison, services)

Limites à connaître

• Pas de prélèvement automatique (SEPA-like) — chaque paiement nécessite la validation explicite de l'utilisateur via son PIN
• Les plafonds de transaction varient par opérateur et par type de compte
• Les APIs sont parfois instables lors des pics de trafic (fin de mois, jours de paye)
• Les délais de settlement (transfert vers le compte bancaire du marchand) varient : 24h à 72h selon l'opérateur

Si vous développez des solutions intégrant le Mobile Money, créez votre profil sur ivoire.io. C'est l'une des compétences les plus recherchées par les startups ivoiriennes.