E-commerce11 min de lecture

Orange Money API : collecter les paiements au Sénégal en 2026

Mohamed Bah·Fondateur, Kolonell
30 août 2026
Partager :
Orange Money API : collecter les paiements au Sénégal en 2026

Orange Money API : collecter les paiements au Sénégal en 2026

E-commerce

Le verdict en trois phrases

Pour une boutique en ligne au Sénégal, Orange Money Web Payment est le canal d'encaissement le plus large en 2026, avec un flux par redirection puis push USSD validé en 120 secondes. Les frais marchand tournent autour de 1,5 % et la confirmation arrive par webhook, à condition de gérer proprement les statuts intermédiaires. En Ouganda, MTN MoMo Collections offre une logique équivalente via le endpoint RequestToPay, avec un sandbox complet et des frais de 1 à 2 %.

Le flux Orange Money Web Payment étape par étape

Le parcours d'un paiement Orange Money au Sénégal suit une séquence précise. Le client choisit Orange Money au checkout, votre serveur crée la transaction, l'utilisateur est redirigé vers la page opérateur, puis reçoit un push USSD ou un code à composer pour valider avec son code secret.

ÉtapeActeurActionDélai typique
1. CréationServeur marchandAppel API create payment, montant + référence< 1 s
2. RedirectionNavigateur clientPage de paiement Orange Money2-5 s
3. Push USSDOpérateurNotification sur le téléphone du client3-10 s
4. Saisie codeClientValidation code secret Orange Money10-90 s
5. WebhookOpérateur → serveurNotification de statut final1-5 s après validation
6. Redirect retourClientRetour sur la page de confirmationimmédiat

Le timeout global est de 120 secondes : si le client ne valide pas, la transaction expire et doit être marquée EXPIRED, jamais FAILED définitif tant que le webhook n'a pas tranché.

Statuts de transaction et délais de confirmation

Bien modéliser les statuts évite les commandes fantômes. Voici la table de référence combinée Orange Money Sénégal / MTN MoMo Ouganda.

StatutOrange Money (SN)MTN MoMo (UG)Action côté marchand
InitiéPENDINGPENDINGAttendre, ne rien livrer
En attente clientINITIATEDPENDINGAfficher "validez sur votre téléphone"
RéussiSUCCESSSUCCESSFULLivrer + marquer payé
ÉchouéFAILEDFAILEDProposer un autre moyen
ExpiréEXPIREDTIMEOUTRéinitier ou annuler
Confirmation moyenne8-20 s6-15 sPrévoir un polling de secours
Frais marchand~1,5 %1-2 %Intégrer à la marge

En ordre de grandeur 2026, 90 % des paiements Orange Money confirmés le sont en moins de 20 secondes. Le sandbox MTN MoMo permet de simuler chaque statut avant la production, un atout pour tester les cas limites.

Mini cas pratique

Awa, gérante d'une boutique de cosmétiques à Dakar, traite 400 commandes par mois à 12 000 FCFA en moyenne, soit 4 800 000 FCFA de volume. À 1,5 % de frais marchand Orange Money, elle paie 72 000 FCFA de commission mensuelle. En activant le polling de secours pour les webhooks manqués, elle récupère 3 % de commandes qui restaient bloquées en INITIATED, soit environ 144 000 FCFA de ventes sauvées chaque mois — deux fois le coût des frais.

Besoin d'un site web professionnel ?

Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.

FAQ

Quel est le timeout d'un paiement Orange Money ?

Le timeout global du flux Web Payment est de 120 secondes en 2026. Au-delà, la transaction passe en EXPIRED et doit être réinitiée par le client.

Quels sont les frais marchand Orange Money au Sénégal ?

En ordre de grandeur 2026, comptez environ 1,5 % par transaction encaissée. Le taux exact dépend de votre contrat marchand et du volume négocié.

Faut-il un webhook obligatoire ?

Oui, le webhook est la source de vérité du statut final. Prévoyez toujours un polling de secours (getStatus) pour les notifications perdues, sinon vous risquez des commandes payées non livrées.

MTN MoMo Collections fonctionne-t-il comme Orange Money ?

Le principe est identique : le endpoint RequestToPay déclenche une demande de validation sur le téléphone du client. Les frais sont de 1 à 2 % et le sandbox permet de tout tester avant la production.

Peut-on encaisser sans redirection ?

Orange Money privilégie la redirection + push USSD pour la sécurité. Un flux 100 % API sans redirection existe selon le contrat, mais la validation par code secret reste toujours requise côté client.

Discutons de votre projet. Nous intégrons Orange Money et MTN MoMo avec webhooks robustes et polling de secours testés. WhatsApp +221 77 596 93 33.

Tags :#Orange Money#MTN MoMo#collections#API#Senegal#Ouganda#USSD#paiement
Partager :

Mohamed Bah

Fondateur, Kolonell

Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.