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"
    }

Last updated