Lipisha REST APIs


Send Airtime


Recharges or tops up the airtime credit on your customer's phone from the float in your airtime account. The customer gets an airtime topup SMS confirmation on their phone on recharge.

Once completed, it sends an Instant Transaction Notification or webhook event to your callback URL for you to process the transaction.


Endpoints

http://developer.lipisha.com/index.php/v2/api/send_airtime TEST
https://api.lipisha.com/v2/send_airtime 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 00600
mobile_number Mobile number of the customer 254712345678
amount Amount of airtime to topup 100
currency Currency of the transaction KES
reference Your identifier for the transaction TOPUP000001

Example Request
curl "http://developer.lipisha.com/index.php/v2/api/send_airtime" \
  -X POST \
  --data-urlencode "api_key=3aa67677e86a38c03a860" \
  --data-urlencode "api_signature=SYetmwsNnb5bwaZRyeQKhZNNkCoEx+5x=" \
  --data-urlencode "account_number=00600" \
  --data-urlencode "mobile_number=254712345678" \
  --data-urlencode "amount=100" \
  --data-urlencode "currency=KES" \
  --data-urlencode "reference=TOPUP000001"

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 00600
mobile_number Mobile number of the customer 254712345678
amount Amount of airtime to topup 100
currency Currency of the transaction KES
reference Your identifier for the transaction TOPUP000001

Example Response
{
  "status": {
    "status_code": "0000",
    "status_description": "Payout Submitted",
    "status": "SUCCESS"
  },
  "content": {
    "transaction": "ABC12345QR",
    "account_number": "00600",
    "mobile_number": "254712345678",
    "amount": "100",
    "currency": "KES",
    "reference": "TOPUP000001"
  }
}

Fork me on GitHub