curl --request POST \
--url https://wallet.wearemarz.com/api/v1/send-money \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 10000,
"phone_number": "+256712345678",
"reference": "payout-2026-07-31-001",
"country": "UG",
"description": "Salary payment",
"callback_url": "https://your-app.com/webhooks/marzpay",
"metadata": [
{
"orderId": "ORD-123456789"
},
{
"customerId": "customer@email.com",
"isPII": true
}
]
}
'{
"status": "error",
"message": "<string>",
"error_code": "VALIDATION_ERROR",
"errors": {}
}Send money
Send money (disbursement)
Requires IP whitelist, API disbursement permission, and sufficient balance.
POST
/
send-money
curl --request POST \
--url https://wallet.wearemarz.com/api/v1/send-money \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 10000,
"phone_number": "+256712345678",
"reference": "payout-2026-07-31-001",
"country": "UG",
"description": "Salary payment",
"callback_url": "https://your-app.com/webhooks/marzpay",
"metadata": [
{
"orderId": "ORD-123456789"
},
{
"customerId": "customer@email.com",
"isPII": true
}
]
}
'{
"status": "error",
"message": "<string>",
"error_code": "VALIDATION_ERROR",
"errors": {}
}Authorizations
base64(api_key:api_secret)
Body
application/json
E.164 — Uganda +256…, Kenya +254…, Rwanda +250…, DRC +243…, Zambia +260…, Cameroon +237…, Benin +229…, Côte d'Ivoire +225…, Gabon +241…, Congo-Brazzaville +242…, Senegal +221…, Sierra Leone +232…
Pattern:
^\+[0-9]{10,15}$Example:
"+256712345678"
Maximum string length:
50UG (UGX), KE (KES), RW (RWF), CD (CDF/USD), ZM (ZMW), CM/GA/CG (XAF), BJ/CI/SN (XOF), or SL (SLE)
Available options:
UG, KE, RW, CD, ZM, CM, BJ, CI, GA, CG, SN, SL Optional. Array of objects echoed on create (data.withdrawal.metadata) and webhooks (top-level metadata).
Each item has exactly one field name + string/number value, plus optional isPII: true.
Maximum array length:
10Example:
[
{ "orderId": "ORD-123456789" },
{
"customerId": "customer@email.com",
"isPII": true
}
]
Response
Disbursement initiated