Validate Biller

Validate a biller details

POST {{BASE_URL}}/v1/validate-biller

Body Parameters

Property	Data Type	Description	Example	Required
itemId	string or number	The bill item id you get from the List Bill Sub-Categories endpoint.	1465	Yes
customerId	string	The customer id for the bill. This can be for electricity or cableTv. For testing purposes, use 7032691481	"7032691481"	Yes
amount	number	The amount for the bill to be paid. This value comes alongside the bill sub-category details.	4125.00	Yes
billerId	string	The biller id. This comes alongside the bill sub-category details	"1465"	Yes

Node.js

import Axios from 'axios';

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

// define request body
const data = {
    itemId: 1465,
    customerId: "7032691481",
    amount: 4150.00,
    billerId: "1465"
}

// 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": {
        "status": true,
        "billerCode": "N/A0",
        "billerItem": {
            "itemId": 1465,
            "amount": "4150.00",
            "name": ""
        },
        "customer": {
            "id": "7032691481",
            "name": "OMO QUEEN-SE2207",
            "network": "",
            "phoneNumber": ""
        },
        "currency": "NGN"
    },
    "message": "successful",
    "status": 200
}