Skip to main content
POST
/
v1
/
disbursements
Request a disbursement
curl --request POST \
  --url https://staging-api.mobipurse.com/v1/disbursements \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "reference": "2a59004d-72a9-4bdc-9893-abff8fa6ffb4",
  "amount": 10000,
  "phoneNumber": "2257038102473",
  "country": "CI",
  "currency": "XOF",
  "webhookURL": "https://webhook.site/100ebe83-961d-4096-8741-05772dafcfa1"
}
'
{
  "statusCode": 200,
  "data": {
    "reference": "DMBD20251110155014KVAZR",
    "merchantsReference": "5f86ad3c-2d4a-401e-959c-3e0db463b175",
    "amount": 10000,
    "fee": 480,
    "status": "success"
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate this from your Mobipurse dashboard under Settings → API Keys.

Body

application/json
​
reference
string
required

Unique merchant reference for the disbursement. Must be unique for each disbursement.

Example:

"2a59004d-72a9-4bdc-9893-abff8fa6ffb4"

​
amount
integer
required

The amount to disburse in the lowest currency denomination (e.g., 10000 for 100.00)

Required range: x >= 1
Example:

10000

​
phoneNumber
string
required

Recipient's phone number in international format without the + sign

Example:

"2257038102473"

​
country
string
required

The 2-character ISO country code

Example:

"CI"

​
currency
string
required

The 3-character ISO currency code

Example:

"XOF"

​
webhookURL
string<uri>

URL to receive webhook notifications for disbursement events

Example:

"https://webhook.site/100ebe83-961d-4096-8741-05772dafcfa1"

Response

Disbursement created successfully

​
statusCode
integer
Example:

200

​
data
object