Airtime & Data Vending
Vend data bundles via parent account
You can use this endpoint to vend data via parent account
POST
/
v1
/
bill
/
data
Authorizations
Authorization
string
headerrequiredNomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN
. You need to use an "Authorization"
HTTP header to provide your ACCESS_TOKEN
. For example: Authorization: {ACCESS_TOKEN}
.
Headers
accountId
string
requiredThe parent accountId of the business.
Body
application/json
amount
number
requiredThe data amount to be vended
phoneNumber
string
requiredRecipient phone number
Required string length:
11 - 13
network
enum<string>
requiredRecipient network (telco). It can also come as lowercased values e.g. glo, mtn etc.
Available options:
GLO
, MTN
, 9MOBILE
, AIRTEL
merchantTxRef
string
requiredMerchant Transaction Identifier reference (Unique to merchant)
senderName
string
A name to describe the sender of the data
Response
200 - application/json
code
string
requiredResponse Code
description
string
requiredResponse description
data
object
required