Skip to main content
Mobipurse Disbursements allows you to send money directly to your customers’ mobile wallets. This is useful for payouts, refunds, commissions, or any scenario where you need to transfer funds to your users.

​
How It Works

  • From your infrastructure/application, call our Disbursements API with the recipient and payment details.
  • We will process the disbursement and send the funds to the recipient’s mobile wallet.
  • You’ll receive a webhook notification once the disbursement is completed or if it fails.

​
1. Prepare the disbursement details

First, you need to assemble the disbursement details. Here are the details you’ll need:
FieldTypeDescriptionRequired
amountNumberThe amount to disburse to the recipient. This should be in the lowest currency denomination (e.g., 10000 for 100.00)True
phoneNumberStringThe recipient’s phone number in international format without the + sign (e.g., “2257038102473”)True
currencyStringThe currency in which you would like to disburse (e.g., “XOF”, “USD”, “NGN”)True
countryStringThe 2-character country code for the recipient’s country (e.g., “CI” for Côte d’Ivoire, “NG” for Nigeria)True
referenceStringA unique reference code to identify this disbursement. This must be unique for every disbursement to prevent duplicate sendsTrue
webhookURLStringA URL where we will send disbursement event notifications. Highly recommended for tracking disbursement statusFalse

​
2. Call the disbursements endpoint

To initiate the disbursement, call our Disbursements API with the collected details. Ensure you authorize the API call using your x-api-key header.

​
API Endpoints

Sandbox (Testing): https://staging-api.mobipurse.com/v1/disbursements Production: https://api.mobipurse.com/v1/disbursements

​
Request Headers

HeaderDescriptionRequired
x-api-keyYour Mobipurse API key from the dashboardTrue

​
Example Request

curl --location 'https://staging-api.mobipurse.com/v1/disbursements' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
    "reference": "b712dd9e-6899-470c-b93d-761a10034c57",
    "amount": 10000,
    "phoneNumber": "2257038102473",
    "country": "CI",
    "currency": "XOF",
    "webhookURL": "https://webhook.site/540ae29a-97bb-4090-8463-6bc64a9ac28e"
}'
Response: 
{
    "statusCode": 200,
    "data": {
        "reference": "DMBD20251110155014KVAZR",
        "merchantsReference": "5f86ad3c-2d4a-401e-959c-3e0db463b175",
        "amount": 10000,
        "fee": 480,
        "status": "success"
    }
}

​
Currency & Country Codes

Common currency and country code combinations:
CountryCodeCurrencyExample Amount
Côte d’IvoireCIXOF200000 (2000.00 XOF)
NigeriaNGNGN50000 (500.00 NGN)
GhanaGHGHS10000 (100.00 GHS)
KenyaKEKES100000 (1000.00 KES)

​
Need Help?

If you encounter any issues with the checkout integration:
  • 📧 Email: [email protected]
  • 💬 Contact us through your merchant dashboard
  • 📚 Browse our complete API documentation