API Explorer
Purchase Airtime

Purchase Airtime

Test URL


Live URL


This gives an application the ability to purchase airtime from any telco :iphone: in East and Central Africa.

200 Success Response Schema

Field NameField TypeField Description
statusboolResponse status
codenumberResponse code
messagestringResponse message
dataobjectResponse data
referenceNumberstringreference number for the transaction
statusstringstatus of transaction

Example Request


In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula
Example Request
curl -X POST \
	-d '{
            "customer": {
                "countryCode": "KE",
                "mobileNumber": "0765555131"
            "airtime": {
                "amount": "100",
                "reference": "212194600777",
                "telco": "Safaricom"
        }'  \
	-H 'Authorization: Bearer {{token}}'  \
	-H 'Content-Type: application/json'  \
	-H 'signature: {{signature}}'  \
	-L 'https://uat.finserve.africa/v3-apis/airtime'

Example Response

Example Response
    "status": true,
    "code": 0,
    "message": "success",
    "reference": "212194600777",
    "data": {
        "referenceNumber": "212194600777",
        "status": "SUCCESS"