Balance Enquiry

AEPS Balance Enquiry

Postman Collection

AEPS

URL

POST : /v1/service/aeps/getBalance

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

merchantCode  (String)   Required
Merchant unique Code(You will get merchantCode from Merchant Onboarding API) (Max Length: 20)

mobile  (String)   Required
Customer Mobile Number (Max Length: 10)

aadhaarNo  (String)   Required
Customer Aadhaar Number (Max Length: 12)

routeType  (String)   Required
Api Service Type (Like ICICI) (Max Length: Fixed)

amount  (Number)   Required
Amount to be withdrawn (Max Length: 5)

ip  (String)   Required
Merchant IP Address (Max Length: 50)

rdRequest  (String)   Required
Biometric data details (Max Length: Pid Data)

latitude  (String)   Required
Current location latitude (Max Length: 20)

longitude  (String)   Required
Current location latitude (Max Length: 20)

bankiin  (String)   Required
Unique bank identification number (You will get it from list of banks API) (Max Length: 10)

Request

Example Request

curl --location --request POST '/v1/service/aeps/getBalance' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic e3tsb2NfdXNlcn19Ont7bG9jX3Bhc3N9fQ==' \
--data-raw '{
    "merchantCode": "MC000123123",
    "mobile": "9999999999",
    "aadhaarNo": "987654321012",
    "routeType": "icici",
    "ip": "117.96.7.205",
    "rdRequest":"<PidData><Resp errCode=\"0\" errInfo=\"\" fCount=\"1\" fType=\"0\" iCount=\"\" pCount=\"\" pgCount=\"\" pTimeout=\"\" nmPoints=\"36\" qScore=\"49\n\"/><DeviceInfo dpId=\"Morpho.SmartChip\" rdsId=\"SCPL.WIN.001\" rdsVer=\"1.0.8\" dc=\"6ff7b5c1-ae75-4965-b572-8af00133455c\" mi=\"MSO1300E3L0SW\" mc=\"MIIEGzCCCr+qHfUzZVwCnv9eX8fsW+mXa+24CVzcjOcOxxNloVhLAcXE490CTYrBP8WIXvIpIjcZQ</Data></PidData>",
    "latitude": "27.8230122",
    "longitude": "35.2121",
    "bankiin": "608032"
}'

Response Samples

SUCCESS

   {
       "code": "0x0200",
       "message": "000: Balance fetched successfully.",
       "status": "SUCCESS",
       "data": {
           "clientRefNo": "ABE151031206358471B60E",
           "routeType": "icici",
           "bankiin": "608032",
           "stanNo": "XTL92DE554FB0B6483A98152C89456264EF",
           "rrn": "127115858160",
           "bankMessage": "Request Completed",
           "bankCode": "10000",
           "merchantCode": "MC000123123",
           "merchantMobile": "9999999999",
           "aadhaarNumber": "9876XXXXXXXX1012",
           "transactionType": "BE",
           "transactionDateTime": "2022-02-07 12:15:34",
           "transactionAmount": "0",
           "availableBalance": "1000"
       }
   }

FAILED

    {
        "code":"0x0202",
        "status":"FAILURE",
        "message":"001: Failure",
        "data":{
            "clientRefNo":"ABE6628800000000000000",
            "routeType":"icici",
            "bankiin":"607094",
            "stanNo":"2090000000",
            "rrn":"",
            "bankMessage":"TRANSACTION AMOUNT EXCEED LIMIT",
            "bankCode":"UW",
            "statusCode":"",
            "merchantCode":"MC700000",
            "aadhaarNumber":"3700XXXX0000",
            "transactionType":"BE",
            "transactionDateTime":"2022-04-06T17:07:38",
            "transactionAmount":"0",
            "availableBalance":""
        }
    }

2FAUTH

   {
       "code":"0x0208",
       "status":"2FA",
       "message":"006: Please do 2 factor auth."
   }

Note :

When you receive 2FA status from API you need to hit 2FA API to complete 2-Factor Authentication.

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
0x0208	2FA	TWO FACTOR AUNTHENTICATION