Orange Money Max It : integrer l API de paiement sur votre site senegalais en 2026

Orange Money Max It : la passerelle de paiement d Orange Senegal

Orange Money reste le deuxieme acteur du mobile money au Senegal apres Wave, avec plusieurs millions d utilisateurs actifs. Pour les marchands qui veulent capter cette base, Orange Money propose une API de paiement web baptisee Max It (anciennement Web Payment). Ce guide detaille le processus d integration de bout en bout, des demarches d onboarding jusqu aux premiers appels en production.

Comprendre l architecture Max It

L API Max It fonctionne sur un modele de redirection similaire a Wave : votre serveur initie une transaction, Orange Money heberge la page de confirmation, et un callback est envoye a votre serveur une fois le paiement finalise.

Deux endpoints importants :

• Sandbox : api-test.maxitpay.orange.sn — pour vos tests sans argent reel.
• Production : api.maxitpay.orange.sn — une fois l onboarding valide.

L authentification se fait par un couple merchant_key / secret transmis dans les headers ou dans le corps de la requete selon l endpoint.

Etape 1 : onboarding marchand Orange Money

Pour obtenir un acces 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, telephone, email professionnel.
• Chargez les documents requis : copie NINEA, extrait RCCM, piece d identite du gerant.
• Soumettez le dossier. Un conseiller Orange Money vous contacte sous 5 a 15 jours ouvrables pour valider le compte.
• A 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 des le premier envoi. Les documents manquants peuvent allonger le delai de 5 a 10 jours supplementaires.

Etape 2 : initier un paiement via l API

Une fois vos credentials en main, l appel de base pour creer 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 reponse contient un payment_url vers lequel vous redirigez l utilisateur. Sur cette page Orange Money, l utilisateur saisit son numero de telephone et valide avec son code secret.

Reponse type :

`json

{

"status": "SUCCESS",

"payment_url": "https://pay.maxitpay.orange.sn/session/abc123",

"order_id": "CMD_2026_001"

}

`

Etape 3 : gerer la notification de paiement

Une fois le paiement effectue, 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 mecanisme de verification par signature (consultez la documentation pour les details de la version en cours). Verifiez aussi que le amount correspond bien au montant attendu — une difference peut indiquer une manipulation.

Tester en environnement sandbox

L environnement sandbox Orange Money Max It permet de simuler des paiements avec des numeros de telephone fictifs fournis dans la documentation. Les credentials sandbox sont differents des credentials production — ne confondez pas les deux.

Scenarios a tester obligatoirement :

• Paiement reussi (montant exact, numero de test valide).
• Paiement annule par l utilisateur.
• Timeout : l utilisateur ne complete pas le paiement dans le delai imparti.
• Montant incorrect : votre systeme 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 effectues sous 48 a 72 heures ouvrables. Pour les volumes superieurs a 5 000 000 FCFA par mois, des conditions negociees sont possibles — contactez directement votre conseiller Orange Business.

FAQ

Peut-on tester l API Orange Money Max It sans etre un marchand enregistre ?

Non. L acces a l environnement sandbox necessite des credentials de test, qui sont delivres apres 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 (identite verifiee), la limite peut etre plus elevee.

Comment integrer Orange Money Max It dans un projet Next.js ?

Creez une API route /api/payments/orange-money qui effectue l appel Max It cote serveur (jamais cote client pour ne pas exposer vos credentials), retourne le payment_url, et redirigez avec router.push(paymentUrl).

Discutons de votre projet. Kolonell integre Orange Money Max It dans votre site Next.js ou toute autre stack. WhatsApp +221 77 596 93 33.