Quickbill Bill Payment

Fetch Bill

Postman Collection

BBPS

URL

POST : /v1/service/bbps/quickbill/bill/payment

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: 30)

amount  (String)   Required
Bill Payment Amount (Max Length: 10)

billId  (String)   Required
Merchant Bill Id (Max Length: 50)

customerInfo  (object)   Required
All param of customers (Max Length: 5000)

billerId  (String)   Required
Merchant biller Id (Max Length: 50)

customerParams  (object)   Required
Customer Request Parameter (Max Length: 5000)

billerResponse  (object)   Required
fetch bill response billerResponseList (Max Length: 5000)

paymentMethod  (object)   Required
Payment Method Object (Max Length: 5000)

paymentInfo  (object)   Required
Payment info Object (Max Length: 5000)

Request

Example Request

    curl --location --request POST '/v1/service/bbps/quickbill/bill/payment' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "billId": "BILL5632112345678818224XXXXXXXXXXX",
            "clientRefId": "CRF56321124567811142XX",
            "customerInfo": {
                "customerMobile": "965180XXXX",
                "customerEmail": "kumaxxxx@gmail.com",
                "customerAdhaar": "",
                "customerPan": ""
            },
            "billerId": "UPPC00000UTPAH",
            "customerParams": {
                "tags": [
                    {
                        "name": "Consumer Number",
                        "value": "8236XXXXX"
                    },
                    {
                        "name": "District-Discom",
                        "value": "Ayodhya-MVVNL"
                    }
                ]
            },
            "billerResponse": {
                "billAmount": "100",
                "billDate": "2025-08-04",
                "billNumber": "82332390XXX",
                "billPeriod": "MONTHLY",
                "customerName": "NAME KUMAR",
                "dueDate": "2025-08-18"
            },
            "amount": 100,
            "paymentMethod": {
                "paymentMode": "Cash",
                "quickPay": "N",
                "splitPay": "N"
            },
            "paymentInfo": {
                "info": [
                    {
                        "infoName": "Remarks",
                        "infoValue": "Received"
                    }
                ]
            }
        }'

Response Samples

SUCCESS

   {
    "code": "0x0200",
    "message": "Payment successfully.",
    "status": "SUCCESS",
    "data": {
        "agentNpciId": "",
        "orderRefId": "BPS1019057492047XXXXX",
        "fundRespRemarks": "Successful",
        "fundStatus": "",
        "billStatus": "BILL_PAYMENT_SUCCESS",
        "fundTxnAmt": 100,
        "fundTxnDate": "2025-08-04",
        "fundTxnReferenceId": "CC015244CBAA328XXXX",
        "fundTxnRemarks": "Successful",
        "fundUTR": "OEBYDXX4",
        "billerId": "UPPC00000UTPAH",
        "billerName": "Uttar Pradesh Power Corp Ltd (UPPCL) - URBAN",
        "txnRefId": "CC015244CBAA328XXXX",
        "customerMobNo": "9651807986",
        "txnNpciId": "CC015244CBAA328XXXX",
        "customerParamsDAO": []
    }
}

FAILED

    {
    "code": "0x0202",
    "status": "FAILURE",
    "message": "The client ref id has already been taken.",
    "data": {
        "clientRefId": [
            "The client ref id has already been taken."
        ],
        "billId": [
            "The bill id has already been taken."
        ],
        "customerInfo": [
            "The customer info field is required."
        ]
    }
}

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