This is the endpoint for airtime purchase.

Request Message Description

Field#	Field name	Data type	Required	Max Length	Description	Options
1	walletIdType	Map	yes		wallet identifier type
2	channel	String	yes	30	channel sending request	“WEB” or “USSD” or “SERVICE” or “MOBILE”
3	walletId	String	yes		wallet identifier
4	amount	String	yes		amount
5	encryptedPin	String	yes		encrypted Pin
6	domain	String	yes		domain
7	txnRef	String	yes		transaction reference
8	beneficiaryPhoneNumber	String	yes		beneficiary Phone Number

Endpoint

Base URL : https://api-gateway.interswitchng.com

Request: POST /generic-wallet/api/v1/transaction/airtime

Header

Content-Type: application/json
Authorization: {passport generated bearer token}

Sample Request

{
"txnRef":"1122323",
"walletIdType":"NIN",
"walletId":"9999",
"domain":"ISW",
"beneficiaryPhoneNumber":"08099999999",
"amount":"100",
"encryptedPin":"31d7e6e95aa309fc21127391833733eb",
"networkCode": "MTN",
"channel":"WEB"
}

Sample Response (success)

{
"statusCode": "200",
"responseCode": "00",
"responseMessage": "Successful",
"errors": null,
"modelList": null,
"count": 0
}