POST/api/v1/wallet/send-money
Required permission: wallet:send
Request Body
{
"recipient_phone": "256701234567",
"amount": 50000,
"description": "Payment for services",
"sender_pays_fee": true
}Copy
Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
recipient_phone | string | Yes | Uganda phone number (256701234567) |
amount | number | Yes | Amount in UGX (500 - 5,000,000) |
description | string | No | Transaction description |
sender_pays_fee | boolean | Yes | Whether sender covers the transaction fee |
Response Example
{
"success": true,
"message": "Money transfer initiated successfully",
"data": {
"transaction_id": 12345,
"reference": "SM_1642000000_123",
"recipient_name": "John Doe",
"recipient_phone": "256701234567",
"amount_sent": 50000,
"fee_amount": 3000,
"total_deducted": 53000,
"transfer_type": "external",
"status": "completed",
"new_balance": 97000,
"completed_at": "2025-01-12T10:30:00Z"
}
}