Balance Enquiry
Balance Enquiry
Postman Collection
URL
POST : /v1/service/aeps/getBalanceHeaders
Content-Type (String) required
application/json
application/json
Authorization (String) required
Basic Auth
Basic Auth
Accept (String) required
application/json
application/json
Body Params
merchantLoginId (String) Required
Merchant unique Code(You will get merchantLoginId from Merchant Onboarding API) (Max Length: 20)
Merchant unique Code(You will get merchantLoginId from Merchant Onboarding API) (Max Length: 20)
aadhaar (String) Required
Customer Aadhaar Number (Max Length: 12)
Customer Aadhaar Number (Max Length: 12)
txnType (String) Required
Api Service Type (Max Length: Fixed)
Api Service Type (Max Length: Fixed)
mobile (String) Required
Customer Mobile Number (Max Length: 10)
Customer Mobile Number (Max Length: 10)
rdRequest (String) Required
Biometric data details (Max Length: Pid Data)
Biometric data details (Max Length: Pid Data)
bankiin (String) Required
Unique bank identification number (You will get it from list of banks API) (Max Length: 10)
Unique bank identification number (You will get it from list of banks API) (Max Length: 10)
latitude (String) Required
Current location latitude (Max Length: 20)
Current location latitude (Max Length: 20)
longitude (String) Required
Current location latitude (Max Length: 20)
Current location latitude (Max Length: 20)
pan (String) Required
Merchant Pan Address (Max Length: 10)
Merchant Pan Address (Max Length: 10)
Request
Example Request
curl --location '/v1/service/aeps/getBalance' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data '{
"merchantLoginId" : "MID69374XXXXX",
"aadhaar": "4340005XXXXX",
"txnType": "be",
"mobile": "96518XXXXX",
"rdRequest": "<?xml version=\"1.0\"?>\n<PidData>\n <Resp errCode=\"0\" errInfo=\"Success.\" fCount=\"1\" fType=\"2\" nmPoints=\"38\" qScore=\"70\" \/>\n <DeviceInfo dpId=\"MANTRA.MSIPL\" rdsId=\"MANTRA.WIN.001\" rdsVer=\"1.0.8\" mi=\"MFS100\" mc=\"MIIEGDCCAwCgAwIBAgIEAs0pwDANBgkqXZP5TXJJrYweSzBkZQZ0i93EFqAeINUKwN5ajipFBG0YejZPaO6rXgZPpx2g6UarfW1ypna9q3b1xg0i30EUFHXmhxBYmLxv763fp94wgc8tMyCbNcVKISnqhbk79RqQDBjI0CUyv8cJFgSGoMaKMQzLLP3qAyJgraxE8=\" dc=\"650680e6-0611-430e-bd87-a277b42ba691\">\n <additional_info>\n <Param name=\"srno\" value=\"1693093\" \/>\n <Param name=\"sysid\" value=\"6C3FEBF50A7353BFBFF0\" \/>\n <Param name=\"ts\" value=\"2023-12-28T15:16:49+05:30\" \/>\n <\/additional_info>\n <\/DeviceInfo>\n <Skey ci=\"20250923\">k+\/ObpNPXrohhGsUKsM06ULVcdhX3AIKQRylVkVKFjAKN++nVPb\/0qlITPYG344E3y3b4ij6yvPQdTXXvlBbBHKQJjoICu\/pp9KpsxrOgX+36m1MN4OKfCBRznAQ9SsRr32tKDouQTcRHZXcTYl1y2\/SPLg1bW7ymyQhTJO6sbwcoEQwRsxFsyZAejLdphljyHDENxdQ==<\/Data>\n<\/PidData>",
"bankiin": "990xxx",
"latitude": "26.600000",
"longitude": "82.133904",
"pan": "ENGPKXXXXX"
}'
Response Samples
- SUCCESS
- FAILED
{
"code": "0x0200",
"message": "000: Balance fetched successfully.",
"status": "SUCCESS",
"data": {
"clientRefNo": "ABE1510312063584XXXXXX",
"routeType": "icici",
"bankiin": "608XXX",
"stanNo": "XTL92DE554FB0B6483A98152C8945XXXXXX",
"rrn": "1271158XXXXX",
"bankMessage": "Request Completed",
"bankCode": "10000",
"merchantCode": "MC0001XXXXX",
"merchantMobile": "99999XXXXX",
"aadhaarNumber": "9876XXXXXXXX1012",
"transactionType": "BE",
"transactionDateTime": "2022-02-07 12:15:34",
"transactionAmount": "0",
"availableBalance": "1000"
}
}
{
"code": "0x0202",
"status": "FAILURE",
"message": "Duplicate Biometric data"
}
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 |