Validate Bill Status

Get the status of an already paid bill

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

Body Parameters

Property	Data Type	Description	Example	Required
reference	string	The transaction reference returned from performing a bill payment transaction	"VPX014ba225-00914672"	Yes

Node.js

import Axios from 'axios';

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

// define request body
const data = {
    reference: "VPX014ba225-00914672"
}

// make request using axios
Axios({
    method: "GET",
    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": {
        "reference": "VPX014ba225-00914672",
        "status": "completed",
        "amount": "4150.00",
        "billerCode": "N/A0",
        "billerName": "OMO QUEEN-SE2207",
        "token": "",
        "customer": {},
        "category": {
            "mainCategory": "Cable TV Subscription",
            "subCategory": "GOTv (MultiChoice) Subscription Payment",
            "categoryId": 0,
            "name": ""
        },
        "createdAt": "2023-12-31T14:16:17.195332Z",
        "vasType": "Bills Payment"
    },
    "message": "successful",
    "status": 200
}