Pay Bill

Pay electricity or cableTv bills

POST {{ BASE_URL }}/v1/corporate/bill

Body Parameters

Property	Data Type	Description	Example	Required
type	string	The label of the bill category you get from List Bill Categories endpoint.	"cable"	Yes
amount	number	The airtime amount you want to buy	2000	Yes
phoneNumber	string	The recipient 11-digit phone number.	"08137031202"	Yes
phoneCode	string	The recipient phone number country call code.	"+234"	Yes
itemId	string or number	The bill item id from the List Bill Sub-Categories endpoint	1465	Yes
customerId	string	The customer id for the specific bill category. Use cable: 7032691481 for testing purposes	"7032691481"	Yes
billerId	string	The biller id you get from List Bill Sub-Categories endpoint	"1456"	Yes
pin	string	Your 4-digit transaction PIN	"0000"	Yes
reference	string	Your preferred transaction reference	"txref_0937638BCC"	No

Node.js

import Axios from 'axios';

// set the api url
const API_URL = `${BASE_URL}/v1/corporate/bill`;

// define request data
const data = {
    amount:4150.00,
    phoneNumber: "08137031202",
    phoneCode: "+234",
    itemId: 1465,
    pin:"3662",
    customerId: "7032691481",
    type: "cable",
    billerId: "1465",
    reference: "txref_0937638BCC"
}

// make request using axios
Axios({
    method: "POST",
    url: `${API_URL}`,
    headers: {
        lg: 'en',
        ch: 'web'
        Authorization: `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
    },
    data: data
}).then((resp) => {
    console.log(resp)
}).catch((err) => {
    console.log(err)
})

Response

{
    "error": false,
    "errors": [],
    "data": {
        "amount": 4150,
        "reference": "VPXc3731ffc-7c9d4e3a"
    },
    "message": "successful",
    "status": 200
}