Orange Money Max It : la passerelle de paiement d'Orange Sénégal
Orange Money reste le deuxième acteur du mobile money au Sénégal après Wave, avec plusieurs millions d'utilisateurs actifs. Pour les marchands qui veulent capter cette base, Orange Money propose une API de paiement web baptisée Max It (anciennement Web Payment). Ce guide détaille le processus d'intégration de bout en bout, des démarches d'onboarding jusqu'aux premiers appels en production.
Comprendre l'architecture Max It
L'API Max It fonctionne sur un modèle de redirection similaire à Wave : votre serveur initie une transaction, Orange Money héberge la page de confirmation, et un callback est envoyé à votre serveur une fois le paiement finalise.
Deux endpoints importants :
- Sandbox : api-test.maxitpay.orange.sn — pour vos tests sans argent réel.
- Production : api.maxitpay.orange.sn — une fois l'onboarding validé.
L'authentification se fait par un couple merchant_key / secret transmis dans les headers ou dans le corps de la requête selon l'endpoint.
Étape 1 : onboarding marchand Orange Money
Pour obtenir un accès marchand Orange Money Max It :
- Rendez-vous sur le portail Max It (maxitpay.orange.sn) et cliquez sur "Devenir marchand".
- Remplissez le formulaire avec les informations de votre entreprise : raison sociale, NINEA, RCCM, adresse, téléphone, email professionnel.
- Chargez les documents requis : copie NINEA, extrait RCCM, pièce d'identité du gérant.
- Soumettez le dossier. Un conseiller Orange Money vous contacte sous 5 à 15 jours ouvrables pour valider le compte.
- À l'approbation, vous recevez par email vos credentials :
merchant_key,secret, et les informations de connexion au back-office marchand.
Conseil pratique : soumettez un dossier complet dès le premier envoi. Les documents manquants peuvent allonger le délai de 5 à 10 jours supplémentaires.
Étape 2 : initier un paiement via l'API
Une fois vos credentials en main, l'appel de base pour créer une transaction :
`
POST https://api.maxitpay.orange.sn/webpayment
Content-Type: application/json
{
"merchant_key": "YOUR_MERCHANT_KEY",
"currency": "XOF",
"order_id": "CMD_2026_001",
"amount": 30000,
"return_url": "https://votresite.sn/confirmation",
"cancel_url": "https://votresite.sn/annulation",
"notif_url": "https://votresite.sn/webhook/orangemoney"
}
`
La réponse contient un payment_url vers lequel vous redirigez l'utilisateur. Sur cette page Orange Money, l'utilisateur saisit son numéro de téléphone et valide avec son code secret.
Réponse type :
`json
{
"status": "SUCCESS",
"payment_url": "https://pay.maxitpay.orange.sn/session/abc123",
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.
"order_id": "CMD_2026_001"
}
`
Étape 3 : gérer la notification de paiement
Une fois le paiement effectué, Orange Money poste un payload sur votre notif_url :
`json
{
"status": "SUCCESS",
"txnid": "OM20260609145532",
"order_id": "CMD_2026_001",
"amount": "30000",
"currency": "XOF",
"payment_date": "2026-06-09T14:55:32Z"
}
`
Validez ce payload avant de confirmer la commande. Orange Money fournit un mécanisme de vérification par signature (consultez la documentation pour les détails de la version en cours). Vérifiez aussi que le amount correspond bien au montant attendu — une différence peut indiquer une manipulation.
Tester en environnement sandbox
L'environnement sandbox Orange Money Max It permet de simuler des paiements avec des numéros de téléphone fictifs fournis dans la documentation. Les credentials sandbox sont différents des credentials production — ne confondez pas les deux.
Scénarios à tester obligatoirement :
- Paiement réussi (montant exact, numéro de test validé).
- Paiement annulé par l'utilisateur.
- Timeout : l'utilisateur ne complète pas le paiement dans le délai imparti.
- Montant incorrect : votre système re-interroge l'API pour confirmer le montant.
Frais et conditions commerciales
Orange Money Max It facture environ 1,5 % du montant de la transaction au marchand. Les virements vers votre compte bancaire UEMOA sont effectués sous 48 à 72 heures ouvrables. Pour les volumes supérieurs à 5 000 000 FCFA par mois, des conditions négociées sont possibles — contactez directement votre conseiller Orange Business.
FAQ
Peut-on tester l'API Orange Money Max It sans être un marchand enregistré ?
Non. L'accès à l'environnement sandbox nécessite des credentials de test, qui sont délivrés après inscription sur le portail. En revanche, l'inscription sandbox est plus rapide (24-48 h) que l'onboarding production complet.
L'API Max It supporte-t-elle les remboursements programmatiques ?
Pas directement via l'API publique en 2026. Les remboursements se font manuellement depuis le back-office marchand ou en contactant le support Orange Money.
Quelle est la limite de transaction par paiement ?
La limite standard est de 1 000 000 FCFA par transaction pour les comptes Orange Money classiques. Pour les comptes Premium (identité vérifiée), la limite peut être plus élevée.
Comment intégrer Orange Money Max It dans un projet Next.js ?
Créez une API route /api/payments/orange-money qui effectue l'appel Max It côté serveur (jamais côté client pour ne pas exposer vos credentials), retourne le payment_url, et redirigez avec router.push(paymentUrl).
Discutons de votre projet. Kolonell intègre Orange Money Max It dans votre site Next.js ou toute autre stack. WhatsApp +221 77 596 93 33.
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.