Lipisha REST APIs


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"
  }
}

Fork me on GitHub