Accept Orange Money payments at your captive portal

How it works

Orange Money connects to Powerlynx via the Client ID and Client secret of your application on the Orange Sonatel developer portal, plus your six-digit merchant code. Navigate to Config / Finance / Payment gateways / Orange Money in Powerlynx, enter the credentials, the merchant name shown to customers, and choose the Sandbox or Production environment. The system currency must be set to XOF.

Each location uses one of two checkout methods. OM Pay Link sends the customer to Orange’s own payment page and is the method for hotspots and captive portals. Webpayment shows a QR code with Open Orange Money and Open Max it buttons and is meant for customers who are already online, such as the customer portal or reseller top-ups.

Access starts as soon as Orange confirms the payment for the exact amount charged. Orange Money is then enabled per location in the Payment Gateways tab.

What this integration provides

• Payment from an Orange Money or Max it wallet for Wi-Fi plans and vouchers.
• Two checkout methods: Orange’s payment page for hotspots and a QR code with app links for online customers.
• Client ID, Client secret and merchant code setup, with the secret stored encrypted.
• Payments settled in XOF.
• Purchase completed only after Orange confirms the exact amount.
• Payment window of 15 minutes, with no double charges when the page is reloaded.
• Cancelled or failed attempts can be retried.
• Sandbox and Production environments.

Credentials required

Client ID and Client secret from your application on the Orange Sonatel developer portal, and your six-digit Orange Money merchant code. Orange issues sandbox keys first, and live keys after it approves your business.

Who uses this

Hotspot operators in Senegal who sell Wi-Fi plans and vouchers and want customers to pay from their Orange Money wallet.

Requirements

• Orange Money merchant account with Orange Sonatel.
• System currency set to XOF.
• Plan prices in whole francs, because Orange Money Senegal does not accept decimals.
• Orange Money enabled for the location in the Payment Gateways tab.
• Orange Money domains added to the Walled Garden on the hotspot router.

How to connect Orange Money to Powerlynx and accept payments from Wi-Fi hotspots — step-by-step guide.