DR Congo
Mobile money payouts in CDF, USD — Vodacom, Orange, Airtel, Africell
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 |
|---|---|---|---|
CDF, USD | CD | Mobile money: Vodacom, Orange, Airtel, Africell | 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 +: 243812345678 |
userEmail | string | ❌ No | Recipient email |
userIp | string | ❌ No | Recipient IP address |
Always send the number with the country code 243: the local format some operators require (0812345678 for Orange and Africell, 812345678 for Airtel) is applied automatically. USD payouts are available for Orange only.
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": 50000,
"currency": "CDF",
"paymentType": "SIM",
"serviceId": 123,
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "243812345678",
"userId": "user_12345"
},
"note": "Payout for order #1234"
}'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.