curl --location 'https://api.nomba.com/v1/bill/cabletv' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
--data '{
    "cableTvPaymentType": "dstv",
    "merchantTxRef": "{{$guid}}",
    "payerName": "{{$randomFullName}}",
    "amount": 2000,
    "customerId": "123909200"
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "bf6cd7cc-5952-4e66-abff-64032ce1a73a",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240803091832"
        },
        "fee": "",
        "timeCreated": "2024-08-03T08:18:34.201Z",
        "id": "API-DSTV-C1073-2d10909a-df07-4e95-9851-e5ebd5695040",
        "type": "dstv",
        "status": "SUCCESS"
    }
}

Subscribe to Cable TV via the Parent Account

​
POST /v1/bill/cabletv

​
Request body

​
amount
integer
required

Amount

​
cableTvPaymentType
string
required

The cable tv provider name id usually dstv or gotv

​
merchantTxRef
string
required

Merchant Transaction Reference (a unique reference to identify this transaction on your system)

​
payerName
string
required

The name of the person to be attached to this transaction

​
customerId
string
required

An unique id to identify the customer to which this payment belongsz

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
curl --location 'https://api.nomba.com/v1/bill/cabletv' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
--data '{
    "cableTvPaymentType": "dstv",
    "merchantTxRef": "{{$guid}}",
    "payerName": "{{$randomFullName}}",
    "amount": 2000,
    "customerId": "123909200"
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "bf6cd7cc-5952-4e66-abff-64032ce1a73a",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240803091832"
        },
        "fee": "",
        "timeCreated": "2024-08-03T08:18:34.201Z",
        "id": "API-DSTV-C1073-2d10909a-df07-4e95-9851-e5ebd5695040",
        "type": "dstv",
        "status": "SUCCESS"
    }
}