Skip to main content

Payment integration

Orange Money Payment Gateway

Senegal & UEMOA (XOF) hosted mobile-money checkout via the Orange Money Web Payment API. Customer is redirected to an Orange-hosted page, dials a USSD code for an OTP, and confirms on the web page. Payment status is always re-verified via API before crediting.

Read the payment gateway setup guide

Supported markets

  • Senegal
  • Mali
  • Ivory Coast
  • Burkina Faso
  • Niger
  • Togo
  • Benin
  • Guinea-Bissau

Setup guidance

  1. Register a merchant account with Orange Money and register as a developer at developer.orange.com to obtain OAuth Client ID/Secret and a Merchant Key.
  2. Use sandbox credentials for testing (transactions settle in the placeholder OUV currency), then switch to production when ready.
  3. Production requests are routed to your selected market below - confirm this matches the country segment Orange issued your merchant account for.
  4. The Notification URL below is sent automatically as notif_url/return_url/cancel_url on every payment request - no manual dashboard registration needed.

Configuration requirements

Enter these values in the matching gateway settings. Obtain credentials from the provider and keep them private.

OAuth Client ID Required
OAuth Client Secret Required
Merchant Key Required
From your Orange Money merchant dashboard - separate from the OAuth client credentials above.
Environment Required
Use sandbox credentials until you are ready for live collections.
Market Required
Only used in production - determines the API region for your merchant account. Ignored in sandbox.
Currency Required
All supported markets share the CFA Franc BCEAO. Ignored in sandbox, which always settles in the OUV test currency.
Notification URL Optional
Sent automatically as notif_url on every payment request.