Bill Payment Status

Bill Payment Status

Postman Collection

BBPS

URL

GET : /v1/service/bbps/bill/status

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

clientRefId  (String)   Required
Merchant Unique Reference Number (Max Length: 50)

Request

Example Request

    curl --location --request GET '/v1/service/bbps/bill/status' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "clientRefId": "Your request id"
        }'

Response Samples

SUCCESS

  {
        "code": "0x0200",
        "message": "Record fetched successfully.",
        "status": "SUCCESS",
        "data": {
                "agentNpciId": "FE41FE15INTU000XXXXX",
                "fundRespRemarks": "SUCCESS",
                "fundStatus": "FUND_TRANSFER_SUCCESS",
                "billStatus": "BILL_PAYMENT_SUCCESS",
                "fundTxnAmt": 3040,
                "fundTxnDate": "2025-09-07 00:00:00",
                "fundTxnReferenceId": "ESTB32PV8QA74BQ",
                "fundTxnRemarks": "BBPS-AGENT/ESTB32PV8QA74BQ",
                "fundUTR": "S31903XXX",
                "billerId": "LAMP00000NAT7E",
                "billerName": "L and T Finance Holdings Limited",
                "txnRefId": "a66506da-1813-45c8-b622-8ba67d038XXX",
                "customerMobNo": "8439737416",
                "txnNpciId": "FE415250IRPH8Ap0KXXX",
                "customerParamsDAO": [
                        {
                                "name": "Loan Account Number",
                                "paramsId": "e98e2a0f-09ce-47b0-b4fe-b32ed34dxxxx",
                                "value": "T1700807122402XXXX"
                        },
                        {
                                "name": "Mobile Number",
                                "paramsId": "99b33b9e-169e-4758-be2c-256c1b8xxxxx",
                                "value": "89231XXXX"
                        }
                ]
        }
}

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "We are currently experiencing technical issues. Please try again in 20 minutes. Thank you for your patience! BBP:",
        "data": {
                "agentNpciId": "FE41FE15INTU0000XXX",
                "fundRespRemarks": "Insufficient funds in account",
                "fundStatus": "FUND_TRANSFER_FAILED",
                "billStatus": "BILL_PAYMENT_FAILED",
                "fundTxnAmt": 4405,
                "fundTxnDate": "2025-09-06 00:00:00",
                "fundTxnReferenceId": "TZJTKU9CTGH9XXX",
                "fundTxnRemarks": "BBPS-AGENT/TZJTKU9CTXXXXX",
                "fundUTR": null,
                "billerId": "HDBF00000NATGJ",
                "billerName": "HDB Financial Services Limited",
                "txnRefId": "b3729237-7462-4f65-b744-652f0182222",
                "customerMobNo": "95208XXXX",
                "txnNpciId": null,
                "customerParamsDAO": [
                        {
                                "name": "Loan Number",
                                "paramsId": "6ccf7f04-8bff-4d90-863f-9758d0dcxxx",
                                "value": "53141XXX"
                        }
                ]
        }
}

Response Code

Status Code	Status	Message
0x0200	SUCCESS	TRANSACTION SUCCESSFULL
0x0201	UNAUTHORIZED	UNAUTHORIZED USER
0x0202	FAILURE	FAILURE USER
0x0203	MISSING_PARAMETER	MISSING PARAMETER
0x0204	CONNECTION_TIMEOUT	CONNECTION TIMEOUT
0x0205	SOMETHING_WENT_WRONG	SOMETHING WENT WRONG
0x0206	PENDING	TRANSACTION PENDING
0x0207	REVERSED	TRANSACTION REVERSED
0x0209	REDIRECT	REDIRECT URL