Purchase Airtime
Test URL
POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/airtime
Live URL
POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/airtime
This gives an application the ability to purchase airtime from any telco :iphone: in East and Central Africa.
200 Success Response Schema
| Field Name | Field Type | Field Description |
|---|---|---|
status | bool | Response status |
code | number | Response code |
message | string | Response message |
data | object | Response data |
referenceNumber | string | reference number for the transaction |
status | string | status of transaction |
Example Request
⚠️
In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.
Signature Formula
airtime.telco+airtime.amount+airtime.referenceExample 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"
}
}