Buy Data Bundle

How to Buy Data Bundle using this API

Buy Data Bundle via the parent account

To successfully buy a data bundle using our endpoints, it is necessary to undergo the following steps:

1. Fetch available data plans — this returns a list of available data plans, each with a productId.

2. Buy the data bundle, passing the productId of the plan you want in the purchase request. productId is required.

Purchasing by amount alone is deprecated and only still works for merchants already integrated against it. All new integrations must select a plan from step 1 and pass its productId — this is the only reliable way to get the exact bundle you intended, since more than one plan on the same network can share the same price.

POST /v2/bill/data

Request body

productId · string · required

The product ID of the data plan to purchase (obtained from fetch data plans endpoint)

phoneNumber · string · required

Phone number of the user who is to receive the data bundle

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)

senderName · string · required

The name of the person to be attached to this transaction

Response body

code · string · required

Response code

description · string · required

Response description

data · object

Hide object

amount · string · required

Amount

meta · object

Show object

merchantTxRef · string

Merchant Transaction Reference

rrn · string

Retrieval Reference Number (RRN)

timeCreated · string · required

Date and Time of the transaction

type · string · required

The type of this transaction.

status · string · required

The status of this transaction

Request

curl --location 'https://api.nomba.com/v2/bill/data' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "productId": "mtn47",
    "phoneNumber": "08123456788",
    "network": "MTN",
    "merchantTxRef": "REF-29-07-2026-12",
    "senderName": "John Doe"
}'

Success response (200)

{
    "code": "200",
    "description": "SUCCESS",
    "message": "Transaction completed Successfully",
    "status": true,
    "data": {
        "id": "API-DATA-AAA1A-36dc6c70-5cf2-4592-93be-9bccc23df7f5",
        "status": "SUCCESS",
        "type": "data",
        "amount": 100,
        "source": "api",
        "sourceUserId": null,
        "customerBillerId": "08123456788",
        "productId": "mtn47",
        "meta": {
            "api_rrn": "260926204701",
            "rrn": "260926204701",
            "api_account_id": "0167288-d989-460a-bbde-9842f2b4320f",
            "api_client_id": "2167288-d989-460a-bbde-9842f2b4320f",
            "user_id": "0167288-d989-460a-bbde-9842f2b4320f",
            "merchantTxRef": "REF-29-07-2026-12",
            "allowDuplicate": true,
            "sender_name": "John Doe",
            "idempotentKey": "0167288-d989-460a-bbde-9842f2b4320f_REF-29-07-2026-12",
            "pos_withdrawal_id": "0167288-d989-460a-bbde-9842f2b4320f_REF-29-07-2026-12",
            "userName": "John Doe",
            "isCorporate": "true",
            "currency": "NGN",
            "hooksEligible": "true",
            "isSubscribedToSavingsService": false,
            "isSubscribedToLoanService": false,
            "txnAlertEligible": true,
            "banking_entity_id": 189585760,
            "banking_entity_user_id": 188595905,
            "banking_entity_type": "CORPORATE",
            "transactionCategory": "Bills & Utility",
            "network": "mtn",
            "subscriberNumber": "08123456788",
            "amount_charged": "100.0",
            "wallet_balance": "610.55",
            "wallet_currency": "NGN",
            "phoneNumber": "08123456788"
        },
        "userId": null,
        "timeCreated": "2026-09-26T19:47:01.514+00:00"
    }
}