BILL VALIDATE API

Bill Validate API is a request which is sent from the NPCI through BOU to the biller portal in order to check if the bill exists or not.

Request Parameters

The various parameters are explained below:

Parent Property/Element	Property/Element Name	Mandatory	Data Type	Description
[ROOT] (No parent property / element)	refID	M	String	Unique identification assigned by the initiating BBPOU to unambiguously identify the transaction which is passed on, unchanged, throughout the entire end-to-end chain, binding the Fetch and Payment messages Status of the bill fetch response Successful/Failure
	billerId	M	String	Unique identification code allocated to the Biller
	customerParams	M	Array	Customer bill fetch related details
	customerParams.tags	M	Object	Contains name and value pair which describes details about the customer to the biller
	tenantId	M	String Fixed length - 4	OU ID of request originating BOU

Expected Acknowledgement Parameters

The various parameters are explained below:

Parent Property/Element	Property/Element Name	Mandatory	Data Type	Description
[ROOT] (No parent property / element)	reason	M	String Min Length – 1, Max Length – 100	Reason of the Status
	code	M	String Fixed Length 3	Response code for a request
	status	M	String Min Length – 1, Max Length – 100	Status of given request

Json Formatted Request Example

    {
    "refId": "String",
    "billerId:": "String", "customerParams": [
    {
    "name": "String",
    "value": "String"
    }
    ],
    "tenantId" : "String"
    }

Json Formatted Response Example

    {
    "reason":"String",
    "code":"Integer", "status":"String"
    }