Get Category

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code - 1 (Fixed)MY
X-Ipay-Client-IdStringUnique Client IDMY
X-Ipay-Client-SecretStringUnique secret keyMY
X-Ipay-Outlet-IdStringMerchant unique IDMY
X-Ipay-Endpoint-IpStringEnd Customer IP AddressMN

Sample Request

curl --location --request GET 'https://api.instantpay.in/marketplace/utilityPayments/category' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825' \
--header 'X-Ipay-Endpoint-Ip: 45.115.105.205' \
--header 'X-Ipay-Outlet-Id: 72762' \
--data-raw '
'
GET /marketplace/utilityPayments/category HTTP/1.1
Host: api.instantpay.in
Accept: application/json
Content-Type: application/json
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 45.115.105.205
X-Ipay-Outlet-Id: 72762

Response Parameters

NameTypeDescription
statuscodeStringInstantPay Status Code
actcodeStringAction Code
statusStringStatus Message
dataArrayResponse Data (If Present)
timestampStringCurrent time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id ( If transaction otherwise it is null )
environmentStringLive

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Biller Category fetched successfully",
    "data": [
        {
            "categoryKey": "C05",
            "categoryName": "Broadband"
        },
        {
            "categoryKey": "C06",
            "categoryName": "Cable TV"
        },
        {
            "categoryKey": "C22",
            "categoryName": "Clubs & Associations"
        },
        {
            "categoryKey": "C27",
            "categoryName": "Combination Plan"
        },
        {
            "categoryKey": "C15",
            "categoryName": "Credit Card"
        },
        {
            "categoryKey": "C26",
            "categoryName": "Dairy - B2B"
        },
        {
            "categoryKey": "C03",
            "categoryName": "DTH"
        },
        {
            "categoryKey": "C09",
            "categoryName": "Education Fee"
        },
        {
            "categoryKey": "C04",
            "categoryName": "Electricity"
        },
        {
            "categoryKey": "C10",
            "categoryName": "FASTag"
        },
        {
            "categoryKey": "C14",
            "categoryName": "Gas Cylinder"
        },
        {
            "categoryKey": "C21",
            "categoryName": "Hospital & Pathology"
        },
        {
            "categoryKey": "C17",
            "categoryName": "Housing Society"
        },
        {
            "categoryKey": "C11",
            "categoryName": "Insurance"
        },
        {
            "categoryKey": "C02",
            "categoryName": "Landline"
        },
        {
            "categoryKey": "C13",
            "categoryName": "Loan EMI"
        },
        {
            "categoryKey": "C23",
            "categoryName": "Metro Recharge"
        },
        {
            "categoryKey": "C01",
            "categoryName": "Mobile Postpaid"
        },
        {
            "categoryKey": "C00",
            "categoryName": "Mobile Prepaid"
        },
        {
            "categoryKey": "C19",
            "categoryName": "Municipal Taxes"
        },
        {
            "categoryKey": "C16",
            "categoryName": "Mutual Funds"
        },
        {
            "categoryKey": "C25",
            "categoryName": "Payments - B2B"
        },
        {
            "categoryKey": "C07",
            "categoryName": "Piped Gas"
        },
        {
            "categoryKey": "C20",
            "categoryName": "Recurring Deposit"
        },
        {
            "categoryKey": "C24",
            "categoryName": "Rental"
        },
        {
            "categoryKey": "C18",
            "categoryName": "Subscription"
        },
        {
            "categoryKey": "C08",
            "categoryName": "Water"
        }
    ],
    "timestamp": "2022-12-16 12:08:09",
    "ipay_uuid": "h00597fe0573-f719-434d-b6dc-f3ebfea5a1e2",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}
Language
Click Try It! to start a request and see the response here!