Send Money
Credits the mobile money wallet e.g M-pesa, of your customer from the float in your payout account. The customer gets a mobile money SMS confirmation on their phone on receiving the money.
Once completed, it sends an Instant Transaction Notification or webhook event to your callback URL for you to process the transaction.
Endpoints
https://developer.lipisha.com/index.php/v2/api/send_money TEST
https://api.lipisha.com/v2/send_money LIVE
Request POST application/x-www-form-urlencoded
Parameter |
Description |
Example |
api_key |
Your Lipisha API key. |
3aa67677e8bf1d4c8fe886a38c03a860 |
api_signature |
Your Lipisha API signature. |
SYetmwsNnb5bwaZRyeQKhZNNkCoEx+5x= |
account_number |
Account number of the transaction account |
00500 |
mobile_number |
Mobile number of the customer |
254712345678 |
amount |
Amount of money to send to customer |
1000 |
currency |
Currency of the transaction |
KES |
reference |
Your identifier for the transaction |
LOAN000001 |
Example Request
curl "https://developer.lipisha.com/index.php/v2/api/send_money" \
-X POST \
--data-urlencode "api_key=3aa67677e86a38c03a860" \
--data-urlencode "api_signature=SYetmwsNnb5bwaZRyeQKhZNNkCoEx+5x=" \
--data-urlencode "account_number=00500" \
--data-urlencode "mobile_number=254712345678" \
--data-urlencode "amount=1000" \
--data-urlencode "currency=KES" \
--data-urlencode "reference=LOAN000001"
Response application/json
Parameter |
Description |
Example |
Status |
status |
Status of the API call |
SUCCESS |
status_code |
Status code of the API call |
0000 |
status_description |
Description of the API call |
Balance Found |
Content |
transaction |
Lipisha identifier for the transaction |
ABC12345QR |
account_number |
Account number of the transaction account |
00500 |
mobile_number |
Mobile number of the customer |
254712345678 |
amount |
Amount of money to send to customer |
1000 |
currency |
Currency of the transaction |
KES |
reference |
Your identifier for the transaction |
LOAN000001 |
Example Response
{
"status": {
"status_code": "0000",
"status_description": "Payout Queued",
"status": "SUCCESS"
},
"content": {
"transaction": "ABC12345QR",
"account_number": "00500",
"mobile_number": "254712345678",
"amount": "1000",
"currency": "KES",
"reference": "LOAN000001"
}
}