Cash Withdrawal

AEPS Cash Withdrawal

Postman Collection

AEPS

URL

POST : /v1/service/aeps/withdrawal

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/withdrawal' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic e3tsb2NfdXNlcn19Ont7bG9jX3Bhc3N9fQ==' \
    --data-raw '{
        "merchantCode": "MC000123123",
        "mobile": "9999999999",
        "aadhaarNo": "987654321012",
        "routeType": "icici",
        "amount":50,
        "ip":"117.96.7.205",
        "rdRequest" : "<PidData><Resp errCode=\"0\" errInfo=\"\" fCount=\"1\" fType=\"0\" iCount=\"\" pCount=\"\" pgCount=\"\" pTimeout=\"\" nmPoints=\"44\" qScore=\"46\n\"\/><DeviceInfo dpId=\"Morpho.SmartChip\" rdsId=\"SCPL.WIN.001\" rdsVer=\"1.0.8\" dc=\"6ff7b5c1-ae75-4965-b572-8af00133455c\" mi=\"MSO1300E3L0SW\" mc=\"MIIEGzCCAwOgAwIBAgVxkyapXk=<\/Data><\/PidData>",
        "latitude": "27.8230122",
        "longitude": "35.2121",
        "bankiin":"607396"
    }'

Response Samples

SUCCESS

    {
        "code":"0x0200",
        "message":"000: Amount withdrawal successfully.",
        "status":"SUCCESS",
        "data":{
            "clientRefNo":"ACW151139071555879857C",
            "routeType":"icici",
            "bankiin":"607396",
            "stanNo":"XTL92DE554FB0B6483A98152C89456264EF",
            "rrn":"127115858160",
            "bankMessage":"Request Completed",
            "bankCode":"10000",
            "merchantCode":"MC000123123",
            "merchantMobile":"9999999999",
            "aadhaarNumber":"9876XXXXXXXX1012",
            "transactionType":"CW",
            "transactionDateTime":"2022-02-07 12:17:22",
            "transactionAmount":"100",
            "availableBalance":"900"
        }
    }

FAILED

    {
        "code":"0x0202",
        "status":"FAILURE",
        "message":"001: Failure",
        "data":{
            "clientRefNo":"ACW662511111111111111",
            "routeType":"icici",
            "bankiin":"606985",
            "stanNo":"209000000000",
            "rrn":"",
            "bankMessage":"FREEZE\/FROZEN ACCOUNT",
            "bankCode":"57",
            "statusCode":"",
            "merchantCode":"MC0000000",
            "aadhaarNumber":"2300XXXX0000",
            "transactionType":"CW",
            "transactionDateTime":"2022-04-06T16:18:23",
            "transactionAmount":"3000",
            "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