get https://api.instantpay.in/fi/aeps/banks
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client ID | M | Y |
| X-Ipay-Client-Secret | String | Unique secret key | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | Y |
| X-Ipay-Outlet-Id | String | Merchant Unique ID | M | Y |
Sample Request
curl --location --request GET 'https://api.instantpay.in/fi/aeps/banks' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'X-Ipay-Outlet-Id: {{Outletid}}'
GET /fi/aeps/banks HTTP/1.1
Host: api.instantpay.in
Content-Type: application/json
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
X-Ipay-Outlet-Id: {{Outletid}}
Response Parameters
| Name | Type | Description |
|---|---|---|
| statuscode | String | InstantPay Status Code |
| actcode | String | Action Code |
| status | String | Status message |
| data | Array | Response Data (If Present) |
| timestamp | String | Current time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id ( If transaction otherwise it is null ) |
| environment | String | Live |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Banks fetched successfully",
"data": [
{
"bankId": 109005,
"name": "STATE BANK OF INDIA",
"iin": "607094",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "27",
"aadhaarpayFailureRate": "67"
},
{
"bankId": 74984,
"name": "Punjab National Bank",
"iin": "607027",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "21",
"aadhaarpayFailureRate": "67"
},
{
"bankId": 91606,
"name": "UNION BANK OF INDIA",
"iin": "607161",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "20",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 20500,
"name": "INDIAN BANK",
"iin": "607105",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "72",
"aadhaarpayFailureRate": "71"
},
{
"bankId": 47267,
"name": "BANK OF INDIA",
"iin": "508505",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "23",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 53201,
"name": "CANARA BANK",
"iin": "607396",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "20",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 23061,
"name": "INDIAN OVERSEAS BANK",
"iin": "607126",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "24",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134125,
"name": "BARODA UP BANK",
"iin": "606993",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "36",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134157,
"name": "INDIA POST PAYMENTS BANK",
"iin": "608314",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "21",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 3487,
"name": "CENTRAL BANK OF INDIA",
"iin": "607264",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "61",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134414,
"name": "UTTAR BIHAR GRAMIN BANK",
"iin": "607069",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 96035,
"name": "UCO BANK",
"iin": "607066",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "25",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134126,
"name": "DAKSHIN BIHAR GRAMIN BANK",
"iin": "607136",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "30",
"aadhaarpayFailureRate": "67"
},
{
"bankId": 134120,
"name": "BARODA RAJASTHAN KSHETRIYA GRAMIN BANK",
"iin": "607280",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "19",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 27970,
"name": "BANK OF MAHARASHTRA",
"iin": "607387",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "48",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134550,
"name": "PRATHAMA UP GRAMIN BANK",
"iin": "607135",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "25",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 30301,
"name": "ARYAVART BANK",
"iin": "607024",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "43",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 30273,
"name": "ANDHRA PRADESH GRAMEENA VIKAS BANK",
"iin": "607198",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "29",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 106167,
"name": "PUNJAB AND SIND BANK",
"iin": "607087",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "15",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 1,
"name": "AIRTEL PAYMENTS BANK",
"iin": "990320",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 64597,
"name": "IndusInd Bank",
"iin": "607189",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "31",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 38669,
"name": "ANDHRA PRAGATHI GRAMEENA BANK",
"iin": "607121",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "43",
"aadhaarpayFailureRate": "33"
},
{
"bankId": 74138,
"name": "KARNATAKA GRAMIN BANK",
"iin": "607400",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "17",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 31652,
"name": "RAJASTHAN MARUDHARA GRAMIN BANK",
"iin": "607509",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "33",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 15910,
"name": "ICICI Bank",
"iin": "508534",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 11263,
"name": "HDFC BANK",
"iin": "607152",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "57",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 62431,
"name": "IDBI BANK",
"iin": "607095",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134133,
"name": "MADHYA PRADESH GRAMIN BANK",
"iin": "607022",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134137,
"name": "PUNJAB GRAMIN BANK",
"iin": "607138",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134138,
"name": "SAPTAGIRI GRAMEENA BANK",
"iin": "607053",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134142,
"name": "TELANGANA GRAMEENA BANK",
"iin": "607195",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 30728,
"name": "FINO PAYMENTS BANK",
"iin": "608001",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "36",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 130878,
"name": "Axis Bank",
"iin": "607153",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "50",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134139,
"name": "SARVA HARYANA GRAMIN BANK",
"iin": "607139",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134135,
"name": "TAMIL NADU GRAMA BANK",
"iin": "607052",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 33975,
"name": "JHARKHAND RAJYA GRAMIN BANK",
"iin": "607210",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "11",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 68286,
"name": "KERALA GRAMIN BANK",
"iin": "607399",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "50",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 30520,
"name": "CHHATTISGARH RAJYA GRAMIN BANK",
"iin": "607214",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "50",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 52599,
"name": "CITY UNION BANK",
"iin": "607324",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 64460,
"name": "IDFC FIRST BANK",
"iin": "608117",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 69808,
"name": "KARNATAKA VIKAS GRAMEENA BANK",
"iin": "607122",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "83",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134123,
"name": "BANGIYA GRAMIN VIKASH BANK",
"iin": "607063",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134168,
"name": "VIDHARBHA KONKAN GRAMIN BANK",
"iin": "607020",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "60",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 60588,
"name": "FEDERAL BANK",
"iin": "607363",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134127,
"name": "CHAITANYA GODAVARI GRAMEENA BANK",
"iin": "607080",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "67",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134223,
"name": "FINCARE SMALL FINANCE BANK",
"iin": "817304",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "33",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 31197,
"name": "Kotak Mahindra Bank",
"iin": "990309",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 82074,
"name": "RBL BANK",
"iin": "607393",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 33945,
"name": "UTKAL GRAMEEN BANK",
"iin": "607234",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134167,
"name": "UTTAR BANGA KSHETRIYA GRAMIN BANK",
"iin": "607073",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "67",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 66009,
"name": "KARNATAKA BANK",
"iin": "607270",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134134,
"name": "ODISHA GRAMYA BANK",
"iin": "607060",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "50",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134124,
"name": "BARODA GUJARAT GRAMIN BANK",
"iin": "606995",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "67",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 60446,
"name": "EQUITAS SMALL FINANCE BANK",
"iin": "508998",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 27476,
"name": "LAKSHMI VILAS BANK",
"iin": "607058",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 127783,
"name": "SOUTH INDIAN BANK",
"iin": "607439",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "50",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134154,
"name": "SURYODAY SMALL FINANCE BANK",
"iin": "608022",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 31276,
"name": "MADHYANCHAL GRAMIN BANK",
"iin": "607232",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134155,
"name": "AU SMALL FINANCE BANK",
"iin": "608087",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134132,
"name": "MANIPUR RURAL BANK",
"iin": "607062",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134655,
"name": "THE PUDUKKOTTAI DISTRICT CENTRAL CO-OP BANK",
"iin": "508656",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134608,
"name": "THE VILLUPURAM DISTRICT CENTRAL CO-OP BANK",
"iin": "508737",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134152,
"name": "UJJIVAN SMALL FINANCE BANK",
"iin": "508991",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 134153,
"name": "ESAF SMALL FINANCE BANK",
"iin": "652254",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 86997,
"name": "SARASWAT BANK",
"iin": "652150",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 26523,
"name": "JAMMU AND KASHMIR BANK",
"iin": "607440",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 130362,
"name": "TAMILNAD MERCANTILE BANK",
"iin": "607187",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
{
"bankId": 33950,
"name": "UTTARAKHAND GRAMIN BANK",
"iin": "607197",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "0",
"aadhaarpayFailureRate": "0"
},
{
"bankId": 134119,
"name": "Yes Bank",
"iin": "607618",
"aepsEnabled": true,
"aadhaarpayEnabled": true,
"aepsFailureRate": "100",
"aadhaarpayFailureRate": "100"
},
"timestamp": "2022-09-02 17:47:58",
"ipay_uuid": "h005972b45a4-8787-4306-9714-8c68581b422e",
"orderid": null,
"environment": "LIVE",
"internalCode": null
}
Please Note :
Call this API once an hour to sync the data in your application.