Fetch Biller by BillerId

Fetch Biller by BillerId

Postman Collection

BBPS

URL

GET : /v1/service/bbps/quickbill/fetch/biller/fetchByBillerId

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

billerId  (String)   Required
Merchant Biller Id (Max Length: 30)

Request

Example Request

    curl --location --request GET '/v1/service/bbps/quickbill/fetch/biller/fetchByBillerId' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "billerId" : "UPPC00000UTPAH"
        }'

Response Samples

SUCCESS

   {
    "code": "0x0200",
    "message": "Record fetched successfully.",
    "status": "SUCCESS",
    "data": [
        {
            "billerId": "UPPC00000UTPAH",
            "billerAliasName": "UPPCL-Postpaid and Smart Prepaid Meter Recharge",
            "billerName": "UPPCL-Postpaid and Smart Prepaid Meter Recharge",
            "billerCategory": "Electricity",
            "billerAdhoc": "false",
            "billerCoverage": "IND-UTP",
            "billerFetchRequiremet": "MANDATORY",
            "billerPaymentExactness": "Exact and above",
            "billerSupportBillValidation": "NOT_SUPPORTED",
            "billerInputParams": [
                {
                    "paramsList": [
                        {
                            "paramName": "Consumer Number",
                            "dataType": "NUMERIC",
                            "isOptional": "false",
                            "minLength": "10",
                            "maxLength": "10",
                            "regEx": "^[0-9]{10}$",
                            "visibility": "true"
                        },
                        {
                            "paramName": "District-Discom",
                            "dataType": "ALPHANUMERIC",
                            "isOptional": "false",
                            "minLength": "5",
                            "maxLength": "250",
                            "regEx": "^[0-9A-Za-z\\s\\-\\,\\.]{5,250}$",
                            "values": "Agra-DVVNL,Aligarh-DVVNL,Ambedkar Nagar-MVVNL,Amethi-MVVNL,Amroha-PVVNL,Auraiya-DVVNL,Ayodhya-MVVNL,Azamgarh-PUVNL,Bagpat-PVVNL,Bahraich-MVVNL,Ballia-PUVNL,Balrampur-MVVNL,Banda-DVVNL,Barabanki-MVVNL,Bareilly-MVVNL,Basti-PUVNL,Bijnor-PVVNL,Budaun-MVVNL,Bulandshahr-PVVNL,Chandauli-PUVNL,Chitrakoot-DVVNL,Deoria-PUVNL,Etah-DVVNL,Etawah-DVVNL,Farrukhabad-DVVNL,Fatehpur-PUVNL,Firozabad-DVVNL,Gautam Buddha Nagar-PVVNL,Ghaziabad-PVVNL,Ghazipur-PUVNL,Gonda-MVVNL,Gorakhpur-PUVNL,Hamirpur-DVVNL,Hapur District-PVVNL,Hardoi-MVVNL,Hathras-DVVNL,Jalaun-DVVNL,Jaunpur-PUVNL,Jhansi-DVVNL,Kannauj-DVVNL,Kanpur Dehat-DVVNL,Kanpur Nagar-DVVNL,Kanpur Nagar-KESCO,Kasganj-DVVNL,Kaushambi-PUVNL,Kushinagar-PUVNL,Lakhimpur Kheri-MVVNL,Lalitpur-DVVNL,Lucknow-MVVNL,Maharajganj-PUVNL,Mahoba-DVVNL,Mainpuri-DVVNL,Mathura-DVVNL,Mau-PUVNL,Meerut-PVVNL,Mirzapur-PUVNL,Moradabad-PVVNL,Muzaffarnagar-PVVNL,Pilibhit-MVVNL,Pratapgarh-PUVNL,PrayagRaj-PUVNL,Raebareli-MVVNL,Rampur-PVVNL,Saharanpur-PVVNL,Sambhal-PVVNL,Sant Kabir Nagar-PUVNL,Sant Ravidas Nagar-Bhadohi-PUVNL,Shahjahanpur-MVVNL,Shamli-PVVNL,Shravasti-MVVNL,Siddharthnagar-PUVNL,Sitapur-MVVNL,Sonbhadra-PUVNL,Sultanpur-MVVNL,Unnao-MVVNL,Varanasi-PUVNL",
                            "visibility": "true"
                        }
                    ]
                }
            ],
            "billerAmountOptions": "BASE_BILL_AMOUNT,,,",
            "billerPaymentModes": "Internet Banking, Debit Card, Credit Card, Prepaid Card, Cash, UPI, Wallet, AEPS, Account Transfer",
            "rechargeAmountInValidationRequest": "",
            "billerDescription": "",
            "supportPendingStatus": "No",
            "supportDeemed": "Yes",
            "billerTimeout": "",
            "billerPaymentChannels": [
                {
                    "paymentChannelList": [
                        {
                            "paymentChannelName": "INT",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "INTB",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "MOB",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "MOBB",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "POS",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "MPOS",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "ATM",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "BNKBRNCH",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "KIOSK",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "AGT",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        },
                        {
                            "paymentChannelName": "BSC",
                            "minAmount": "100",
                            "maxAmount": "5000000000"
                        }
                    ]
                }
            ],
            "billerAdditionalInfo": [
                {}
            ],
            "billerAdditionalInfoPayment": [
                {}
            ],
            "planAdditionalInfo": [
                {}
            ],
            "planMdmRequirement": "NOT_SUPPORTED",
            "billerResponseType": "SINGLE",
            "billerPlanResponseParams": [
                {}
            ],
            "interchangeFeeCCF1": {
                "feeCode": "CCF1",
                "feeDirection": "C2B",
                "flatFee": "0",
                "percentFee": "0.00",
                "feeMinAmt": "0",
                "feeMaxAmt": "999999999"
            },
            "billerStatus": "ACTIVE"
        }
    ]
}

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "No Record found",
        "data": "Please use valid billerId"
    }

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