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"
}'

{
    "code": "202",
    "description": "Processing...",
    "data": {
        "amount": "50",
        "meta": {
            "merchantTxRef": "test1116",
            "rrn": "240626232937"
        },
        "timeCreated": "2024-06-26T22:29:37.649Z",
        "type": "topup",
        "status": "Processing..."
    }
}

Vend airtime via the parent account

​
POST /v1/bill/topup

​
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
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"
}'

{
    "code": "202",
    "description": "Processing...",
    "data": {
        "amount": "50",
        "meta": {
            "merchantTxRef": "test1116",
            "rrn": "240626232937"
        },
        "timeCreated": "2024-06-26T22:29:37.649Z",
        "type": "topup",
        "status": "Processing..."
    }
}