Orange Money Max It API: Integrating Web Payments in Senegal (2026 Guide)

Orange Money Max It: Orange Senegal's web payment gateway

Orange Money is Senegal's second-largest mobile money platform, with millions of active users. For merchants who want to reach this audience online, Orange Money provides a web payment API called Max It. This guide covers the full integration journey — from merchant onboarding to production-ready API calls.

Understanding the Max It architecture

Max It uses a redirect-based payment model identical to Wave's checkout flow. Your server initiates a transaction, Orange Money hosts the payment confirmation page, and a callback is posted to your server once the customer completes (or cancels) the payment.

Two key API environments:

• Sandbox: api-test.maxitpay.orange.sn — for development and testing with no real money.
• Production: api.maxitpay.orange.sn — only accessible after merchant approval.

Authentication uses a merchant_key and secret pair obtained during onboarding.

Step 1: Merchant onboarding

To get Orange Money Max It merchant access:

• Visit maxitpay.orange.sn and click "Become a merchant."
• Fill in your company details: business name, NINEA, RCCM, address, phone, professional email.
• Upload required documents: NINEA certificate, RCCM extract, managing director's ID.
• Submit. An Orange Money advisor contacts you within 5–15 business days to validate the account.
• Upon approval, you receive your merchant_key, secret, and merchant back-office login by email.

Practical tip: submit a complete dossier on the first attempt. Missing documents add 5–10 extra business days to the process.

Step 2: Initiating a payment

With credentials in hand, the basic API call to create a payment session:

`

POST https://api.maxitpay.orange.sn/webpayment

Content-Type: application/json

{

"merchant_key": "YOUR_MERCHANT_KEY",

"currency": "XOF",

"order_id": "ORDER_2026_042",

"amount": 45000,

"return_url": "https://yoursite.sn/confirmation",

"cancel_url": "https://yoursite.sn/cancel",

"notif_url": "https://yoursite.sn/webhook/orangemoney"

}

`

The response includes a payment_url to which you redirect the customer. On Orange Money's hosted page, the customer enters their phone number and confirms with their secret PIN.

Sample response:

`json

{

"status": "SUCCESS",

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

"order_id": "ORDER_2026_042"

}

`

Step 3: Handling the payment notification

After a successful payment, Orange Money POSTs to your notif_url:

`json

{

"status": "SUCCESS",

"txnid": "OM20260609103211",

"order_id": "ORDER_2026_042",

"amount": "45000",

"currency": "XOF",

"payment_date": "2026-06-09T10:32:11Z"

}

`

Always verify the notification before fulfilling the order. Check that the amount matches your order's expected total — a discrepancy could indicate manipulation. Respond HTTP 200 immediately, then process the order asynchronously.

Testing in the sandbox environment

The Max It sandbox lets you simulate payments using test phone numbers documented in Orange Money's developer portal. Sandbox credentials are separate from production credentials — never mix them.

Required test scenarios:

• Successful payment with the correct amount and a valid test phone number.
• User-initiated cancellation.
• Timeout: user does not complete payment within the session window.
• Amount mismatch: your system detects the discrepancy and rejects the notification.

Fees and commercial conditions

Orange Money Max It charges approximately 1.5% per transaction to the merchant. Settlements to your UEMOA bank account arrive within 48–72 business hours. Merchants processing over 5,000,000 FCFA per month can negotiate better rates directly with an Orange Business advisor.

FAQ

Can I access the sandbox without completing merchant onboarding?

No. Sandbox credentials require registration on the Max It portal. However, sandbox approval is faster (24–48 hours) than full production onboarding.

Does the Max It API support programmatic refunds?

Not through the public API as of 2026. Refunds must be initiated manually from the merchant back-office or by contacting Orange Money support.

What is the per-transaction limit?

The standard Orange Money account cap is 1,000,000 FCFA per transaction. Premium (verified identity) accounts may have higher limits.

How do I integrate Max It into a Next.js project?

Create a server-side API route (e.g., /api/payments/orange-money) to make the Max It call — never from the client side, as that would expose your credentials. Return the payment_url to the frontend and redirect with router.push(paymentUrl).

Let's talk about your project. Kolonell integrates Orange Money Max It into your Next.js or any other stack, end to end. WhatsApp +221 77 596 93 33.