Orange Money Integration
Orange Money is one of the mobile money gateways supported by ZoPay in Cameroon. You accept and send Orange Money payments through the standard Collections and Disbursements flow using the ORANGE_MONEY gateway identifier.
There is no separate Orange Money endpoint. It uses the same Collections and Disbursements APIs — you simply set gateway: "ORANGE_MONEY".
Gateway Details
| Gateway ID | ORANGE_MONEY |
| Country | Cameroon |
| Currency | XAF (Central African CFA franc) |
| Phone format | E.164, e.g. +237690000000 |
| Operations | Collections (cash-in) and Disbursements (cash-out) |
Accepting a Payment (Collection)
Orange Money collections follow the two-step quote then execute flow. First create a quote:
1POST /api/v1/wallets/quote
2
3{
4 "gateway": "ORANGE_MONEY",
5 "transaction_type": "COLLECTION",
6 "amount": "1000",
7 "currency": "XAF",
8 "payer": {
9 "msisdn": "+237690000000"
10 }
11}Then execute the collection with the returned quote_id:
1POST /api/v1/wallets/collect
2
3{
4 "quote_id": "quote-uuid",
5 "idempotency_key": "unique-key-123"
6}The customer receives a prompt on their phone to approve the payment. The transaction status will be PENDING/PROCESSING until they confirm. See the full Collections guide for request and response details.
Sending a Payout (Disbursement)
To send money to an Orange Money wallet, create a disbursement quote with gateway: "ORANGE_MONEY", then execute it:
1POST /api/v1/disbursements/quote
2
3{
4 "gateway": "ORANGE_MONEY",
5 "amount": "5000",
6 "currency": "XAF",
7 "recipientMsisdn": "+237690000000",
8 "reference": "Payout #123"
9}See the Disbursements guide for the complete flow.
Handling Results
Orange Money transactions are asynchronous. Rather than relying only on the synchronous response, subscribe to webhooks to receive the final status:
payment.succeeded/payment.failedfor collectionspayout.completed/payout.failedfor disbursements
Learn more in the Webhooks guide.
Testing in Sandbox
Use your sandbox API keys against the sandbox base URL to test Orange Money flows without moving real money. Sandbox and production are fully isolated. See Using the API.