Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.nomba.com/llms.txt

Use this file to discover all available pages before exploring further.

Vend airtime via the parent account

​
POST /v1/bill/topup

  curl --location 'https://api.nomba.com/v1/bill/topup' \
  --header 'accountId: <accountId>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
      "amount": 50,
      "phoneNumber": "08012345678",
      "network": "MTN",
      "merchantTxRef": "test1116",
      "senderName": "Testing"
  }'

​
Request body

​
amount
integer
required
Amount
​
phoneNumber
string
required
Phone number of the user who is to receive the value
​
network
string
required
Network (e.g. MTN, AIRTEL, GLO, 9MOBILE, etc)
​
merchantTxRef
string
required
Merchant Transaction Reference (a unique reference to identify this transaction on your system)

​
Response body

​
code
string
required
Response code
​
description
string
required
Response description
​
data
object