Burkina Faso
Mobile money payouts in XOF — Orange, Moov, Wave
Before you start
Authorization
How to sign your requests with the API token.
Payouts overview
Common request format, response fields and statuses.
This payout destination is not enabled for all merchants. Check availability with your manager, and make sure your merchant balance is sufficient before creating a payout.
Overview
| Currency | Country code | Destination | paymentType |
|---|---|---|---|
XOF | BF | Mobile money: Orange, Moov, Wave | SIM |
Every operator or bank method is a separate payout service. Get the services enabled for you with GET /v1/payouts/services and pass the serviceId of the one you need; without it your default service is used.
The recipient must be a client of the operator of the selected service: a payout through an MTN service cannot reach an Orange wallet.
The required set depends on the service enabled for you. If a field it needs is missing, the phone does not match the country or the payment type does not match the service, the payout is rejected with 400 before it is created and nothing is debited. Send userEmail whenever you have it.
account fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ Yes | Recipient name |
requisites | string | ✅ Yes | Recipient requisites: card number, phone number, PIX key, etc., depending on paymentType |
userId | string | ✅ Yes | User ID in your system |
| Field | Type | Required | Description |
|---|---|---|---|
requisites | string | ✅ Yes | Recipient wallet phone in the international format, digits only, without +: 22670123456 |
userEmail | string | ⚠️ Depends on the service | Recipient email |
userIp | string | ❌ No | Recipient IP address |
Request example
curl -X POST "https://api.1capital.capital/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 10000,
"currency": "XOF",
"paymentType": "SIM",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "22670123456",
"userId": "user_12345",
"userEmail": "john.doe@example.com"
},
"note": "Payout for order #1234"
}'Amounts in XOF must be whole numbers in multiples of 5, otherwise the payout is rejected with 400.
Response
The response is a standard payout object with the CREATED status. Store the id to track the payout.
Payout object fields
The final status usually arrives within a few minutes.