post
https://api.instantpay.in/fi/aeps/miniStatement
A mini statement in AEPS (Aadhaar Enabled Payment System) typically provides a brief overview of recent transactions associated with a bank account linked to an Aadhaar card. This statement usually includes details such as the date, time, transaction type, and amount of the transactions.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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-Outlet-Id | String | Merchant Unique ID | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | N |
Request Parameters
| Name | Type | Mandatory (M) , Optional (O) | Description |
|---|---|---|---|
| bankiin | String | M | Unique bank identification number (You will get it from list of banks API) |
| latitude | String | M | Current location latitude |
| longitude | String | M | Current location longitude |
| mobile | String | M | User Mobile no |
| externalRef | String | M | Unique Reference number |
| captureType | String | O | It will be FINGER, FACE or IRIS |
| biometricData | Array | M | Biometric data details |
| biometricData.encryptedAadhaar | String | M | Aadhar details in encrypted form. |
| biometricData.dc | String | M | Returned by RD Service when using biometric authentication. Registered Device code. |
| biometricData.ci | String | M | Returned by RD Service when using biometric authentication. Public key certificate identifier of UIDAI using which skey was encrypted. |
| biometricData.hmac | String | M | Returned by RD Service when using biometric authentication. SHA -256 Hash of PID XML and then encrypted and base 64 encoded |
| biometricData.dpId | String | M | Returned by RD Service when using biometric authentication. Device provider Id. |
| biometricData.mc | String | M | Returned by RD Service when using biometric authentication. encrypted registered device public key certificate |
| biometricData.pidDataType | String | M | Returned by RD Service when using biometric authentication. Protobuff format or XML format. |
| biometricData.sessionKey | String | M | Returned by RD Service when using biometric authentication. AES session key generated dynamically for every txn. |
| biometricData.mi | String | M | Returned by RD Service when using biometric authentication. RD model Id. |
| biometricData.rdsId | String | M | Returned by RD Service when using biometric authentication. RD Service Id. |
| biometricData.errCode | String | O | 0(Default)- Request success |
| biometricData.errInfo | String | O | Information about the error |
| biometricData.fCount | String | O | Total number of FIR records which was part of input. |
| biometricData.fType | String | M | When connecting the Device to RD service send ftype 2 in the request. |
| biometricData.iCount | String | M | Total number of IIR records which was part of input. |
| biometricData.iType | String | O | ISO format (0 for IIR), 0 (IIR) is default. |
| biometricData.pCount | String | O | Number of face photo records to be captured (0 to 1). |
| biometricData.pType | String | M | Face format |
| biometricData.srno | String | M | Serial Number of biometric device. |
| biometricData.sysid | String | O | System Id |
| biometricData.ts | String | O | Current Timestamp. |
| biometricData.pidData | String | M | Returned by RD Service when using biometric authentication. |
| biometricData.qScore | String | M | If quality check is done, send a normalized score that is between 0 and 100. Device providers may allow configuration within RD service to use specific quality check algorithms to be enabled. |
| biometricData.nmPoints | String | M | Number of minutiae points when FMR is captured. Applications may use this for accepting or retrying the capture. |
| biometricData.rdsVer | String | M | Returned by RD Service when using biometric authentication. RD Service version. |
Sample Request
curl --location --request POST 'https://api.instantpay.in/fi/aeps/miniStatement' \
--header 'Accept: application/json' \
--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}}' \
--data-raw ' {
"bankiin": "109104",
"latitude": "21.3241",
"longitude": "70.1321",
"mobile": "9999999999",
"externalRef": "1672908701918",
"captureType" : "FINGER"
"biometricData": {
"encryptedAadhaar": "GWFDLdnHmGF7Am6oG4F6X6GNyO02eQj24hlOiK/Y+js=",
"dc": "81cfa394-d641-44cf-835d-cb65532bbc20",
"ci": "20221021",
"hmac": "B1q0v2t9Ebv+ubVCRSBV/9drAQCyvBv0Hw7mwuhxZ3eUp5DjfD1dAl0ovaaVGwOl",
"dpId": "STARTEK.ACPL",
"mc": "MIIDgDCCAmigAwIBAgIFAAZeW+IwDQYJKoZIhvcNAQELBQAwdDEdMBsGA1UEAxMUQklKQVkgQU1BUk5BVEggU0lOSEExEDAOBgNVBAgTB0dVSkFSQVQxETAPBgNVBAsTCERJUkVDVE9SMSEwHwYDVQQKExhBQ0NFU1MgQ09NUFVURUNIIFBWVCBMVEQxCzAJBgNVBAYTAklOMB4XDTIyMDQyNjA2MDg0M1oXDTIyMDUyNjA2MDg0M1owUTELMAkGA1UEBhMCSU4xEDAOBgNVBAgMB0d1amFyYXQxDTALBgNVBAoMBFVTRVIxDTALBgNVBAsMBFVTRVIxEjAQBgNVBAMMCVBST0RfVVNFUjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMk3kObEzchV/cithqKtBslzmafe4ky0mpPYwp4zTwt/d5RJ2JbtKnWYYLHJ8IUCXbhGPMtAmiZAG3fA6tlCw71z0rimo11g8GUQasfkKZE93V0cO8zW+V4Mi/V27mNfduZBGeGRyf5YPq4JDA3GnKrW7kSiHpUJ+KMp8QWZA5vqam0kknqGO06Zpx0x8jOmV27z3XN8Xh/3nDOfTh+NelQ6dkrLCkHpN4oWYPmj+uIF/JrTfPtgYe9+54z6LO/K3zNfHSsZtuO7IWWvC3DYFRoDLzc9pVAQ5DP0xxrEUYwJJu258NNrd4ouZel+EIEFg73FM9fTV5VxmmGxaQQugLECAwEAAaM8MDowDAYDVR0TBAUwAwEB/zALBgNVHQ8EBAMCAYYwHQYDVR0OBBYEFIuDs650JC9y2NFbmYq8mLXQLmEDMA0GCSqGSIb3DQEBCwUAA4IBAQAT9FUmGdDb9f1BpIhk0Ak3Zko2sggSMD9ORg7veRKTUEvX5xUNowDT37jgXWPRIn3lZ9pHIbJOL4oDLPQACpL2GReagcwGWyhm9J9ICO7Z0mocXhc/M101fWlpX0qEUhpNgaz+AqXWmM5vj6eeGd50xTXKirVmlzlnqwzc+1RNu3fP0h5HQhxd2HIroffLHLBEzVZMIaLZ7NBuMdCdfSfYa9fFAyFJ/WhT4hskcRNecZLoH89Bk1fgJMd7MnFXpe1JQqgZqE1REp+wDQom0DRxtyLT8a8HndP/1Fn/PiXP+AaJOmGiJMNZ66QBirdAxfQUhozPlich2KVFeOagTmyB",
"pidDataType": "X",
"sessionKey": "KAebH/4NCyDdrXVu7H6FVamT4mZnwl8peHNzyx46KG6c9YMtyd652MeRsr9HX6tFa5t9BPH0l4VzVALFMK6AD5Ql2+gOEY0i+CwlvoDuMGNIJTP8uqvm1fy8iG1VXTBnUevPQqKqIZrd+fnc0Tzts4C38YPW3hH2yWzZyKgii3OPw6KXtPp2j8/7Z71lnJkt6FlhyLhtmzE03o7Dbq5BunpdAYKNarXMxYGUy2ECGBKd995+nCUyDDl/g+fQuHHRhV7goVRE/btsihX3X9Oe9ccraKdsOoh917wI8IYrakGivV5hmn85kplD4AcS0wE4QFS1nNvXUxBOocL+1MwuiQ==",
"mi": "FM220U",
"rdsId": "ACPL.WIN.001",
"errCode": "0",
"errInfo": "",
"fCount": "1",
"fType": "2",
"iCount": 0,
"iType": "",
"pCount": 0,
"pType": "",
"srno": "N00115075",
"sysid": "MDAyNTM4ODU4MUI0OTgwNU4wQ1YxODM4TUIwMDU0NDk3SkFOMENWMDM2MjM3NDEw",
"ts": "2022-04-27T18:43:29+05:30",
"pidData": "MjAyMi0wNC0yN1QxODo0MzoyOSUxMT0lLsc/TjgrIhSnqQuLIVotyxAtu0vn8Lhcb0qLiL1cyIdapva5YwdQIyqCSDl8MYb1c95LPdiOygsskq8/HOWthwez+YfR/w6CKIbmeETOeMPOS8iuM0pdtCeWpSLy6iSKm1fay57WhceMyVGH7rg7Mh2QZyWr65ddiNJrUESWGXbRACZLPt6yCLGbPHy06qQE9Nl8rPpsBoxZWfjPp6fc+uBndoTHoHDirOPV29tbewLHCv0gPMPEFkRRhq7Rul7wksFpP1qJdZWGTLwIzDEo8C4S7E1sR7uthtE+X1frN/zLl1M8gCRkwg+bdtMrYlTGf753368y2D7+zeTUKNTfCeVOFyaPz6zP3wm6IuVM3HBQ49pFZNR1nlWRCGgS+5xqyUdgJTJS/6s/fxLi/PcsFz2Ul4BGyhcGqKEKYEa3ufdyDIf1sTXJHE5N7VmJT8Fa9UNwBClrTji6jdbEW8lhoVuHP1FptcyVT7UZ12c8Vheo+uSpcpZeeQlUWUBAXkMsnl/NTYdTLuBdaY2D9LdyuWHzZwj2U2Sluu5zSLgszEAL5qztSnVjtW/yq+YWVFfvOzSdxHx59Rrt0JF5vDMRfokIfKEIzO/7C84xxe4bY15PqxRWEJiXmfMkYpUxi+2Fbec9cHygzVgK3wP2IWhT/8ksENXNp0FjEPIfhMtxG5PeqyKNwgew5Lzt7tBjL3FLEqg8MHfSLizcjuew/QzR8zUMPeSOcX3ByvuLGEluVJ8RM8sQdoiVv3ALewBSEUie+Vo6x/Kio6mR27sLbfUuD+q+jCYKSdDq4gpYGO46qzDa5YVzO1DTf20Quwz122s32ICGQ49U1MoMSRPOCwMoroIbMF1qvCRUa83amj95fk/7Xi7VJh2zneAlLhx7imRyp+mdAVG46jGbXgMDKC3Y2OL/GVYY6yEudgfyObfV80icK57vy6rQ0Q9FS+EdsWbxlX68Hje+JpidUwiaaquhqAz+GjOZjJPGirYFVN0n7SNqMqvzOh/lcWBwlhVoKA/YZrMEn5gtyXKY7/ecaOtc9+bCqExt+uCXOdJLRUTarKUran60fN5wurBHzMoZTeOTesG9UdM175c4bCN8BAVLu1TLUG7fuqm5oZ+VyFXmkMMrMhNLnPLaeExrTp0APDnwxs/xcONiBlMKKCR5qoftsalfc9W1HWvhv5BnAgM1JMtisQK88BccmGWsb9g4fzQtlbHoUR/mHP5O8YDRQ8bsWfB2wkS5p8s4gQ8CLDtwjlHK1StS9UC99YvPUX7axHsd14Y=",
"qScore": "100",
"nmPoints": "44",
"rdsVer": "1.0.3"
}
}'POST /aeps/miniStatement HTTP/1.1
Host: api.instantpay.in
Accept: application/json
Content-Type: application/json
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
"Body": {
"bankiin": "109104",
"latitude": "21.3241",
"longitude": "70.1321",
"mobile": "7428585742",
"externalRef": "1672908701918",
"captureType" : "FINGER"
"biometricData": {
"encryptedAadhaar": "GWFDLdnHmGF7Am6oG4F6X6GNyO02eQj24hlOiK/Y+js=",
"dc": "81cfa394-d641-44cf-835d-cb65532bbc20",
"ci": "20221021",
"hmac": "B1q0v2t9Ebv+ubVCRSBV/9drAQCyvBv0Hw7mwuhxZ3eUp5DjfD1dAl0ovaaVGwOl",
"dpId": "STARTEK.ACPL",
"mc": "MIIDgDCCAmigAwIBAgIFAAZeW+IwDQYJKoZIhvcNAQELBQAwdDEdMBsGA1UEAxMUQklKQVkgQU1BUk5BVEggU0lOSEExEDAOBgNVBAgTB0dVSkFSQVQxETAPBgNVBAsTCERJUkVDVE9SMSEwHwYDVQQKExhBQ0NFU1MgQ09NUFVURUNIIFBWVCBMVEQxCzAJBgNVBAYTAklOMB4XDTIyMDQyNjA2MDg0M1oXDTIyMDUyNjA2MDg0M1owUTELMAkGA1UEBhMCSU4xEDAOBgNVBAgMB0d1amFyYXQxDTALBgNVBAoMBFVTRVIxDTALBgNVBAsMBFVTRVIxEjAQBgNVBAMMCVBST0RfVVNFUjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMk3kObEzchV/cithqKtBslzmafe4ky0mpPYwp4zTwt/d5RJ2JbtKnWYYLHJ8IUCXbhGPMtAmiZAG3fA6tlCw71z0rimo11g8GUQasfkKZE93V0cO8zW+V4Mi/V27mNfduZBGeGRyf5YPq4JDA3GnKrW7kSiHpUJ+KMp8QWZA5vqam0kknqGO06Zpx0x8jOmV27z3XN8Xh/3nDOfTh+NelQ6dkrLCkHpN4oWYPmj+uIF/JrTfPtgYe9+54z6LO/K3zNfHSsZtuO7IWWvC3DYFRoDLzc9pVAQ5DP0xxrEUYwJJu258NNrd4ouZel+EIEFg73FM9fTV5VxmmGxaQQugLECAwEAAaM8MDowDAYDVR0TBAUwAwEB/zALBgNVHQ8EBAMCAYYwHQYDVR0OBBYEFIuDs650JC9y2NFbmYq8mLXQLmEDMA0GCSqGSIb3DQEBCwUAA4IBAQAT9FUmGdDb9f1BpIhk0Ak3Zko2sggSMD9ORg7veRKTUEvX5xUNowDT37jgXWPRIn3lZ9pHIbJOL4oDLPQACpL2GReagcwGWyhm9J9ICO7Z0mocXhc/M101fWlpX0qEUhpNgaz+AqXWmM5vj6eeGd50xTXKirVmlzlnqwzc+1RNu3fP0h5HQhxd2HIroffLHLBEzVZMIaLZ7NBuMdCdfSfYa9fFAyFJ/WhT4hskcRNecZLoH89Bk1fgJMd7MnFXpe1JQqgZqE1REp+wDQom0DRxtyLT8a8HndP/1Fn/PiXP+AaJOmGiJMNZ66QBirdAxfQUhozPlich2KVFeOagTmyB",
"pidDataType": "X",
"sessionKey": "KAebH/4NCyDdrXVu7H6FVamT4mZnwl8peHNzyx46KG6c9YMtyd652MeRsr9HX6tFa5t9BPH0l4VzVALFMK6AD5Ql2+gOEY0i+CwlvoDuMGNIJTP8uqvm1fy8iG1VXTBnUevPQqKqIZrd+fnc0Tzts4C38YPW3hH2yWzZyKgii3OPw6KXtPp2j8/7Z71lnJkt6FlhyLhtmzE03o7Dbq5BunpdAYKNarXMxYGUy2ECGBKd995+nCUyDDl/g+fQuHHRhV7goVRE/btsihX3X9Oe9ccraKdsOoh917wI8IYrakGivV5hmn85kplD4AcS0wE4QFS1nNvXUxBOocL+1MwuiQ==",
"mi": "FM220U",
"rdsId": "ACPL.WIN.001",
"errCode": "0",
"errInfo": "",
"fCount": "1",
"fType": "2",
"iCount": 0,
"iType": "",
"pCount": 0,
"pType": "",
"srno": "N00115075",
"sysid": "MDAyNTM4ODU4MUI0OTgwNU4wQ1YxODM4TUIwMDU0NDk3SkFOMENWMDM2MjM3NDEw",
"ts": "2022-04-27T18:43:29+05:30",
"pidData": "MjAyMi0wNC0yN1QxODo0MzoyOSUxMT0lLsc/TjgrIhSnqQuLIVotyxAtu0vn8Lhcb0qLiL1cyIdapva5YwdQIyqCSDl8MYb1c95LPdiOygsskq8/HOWthwez+YfR/w6CKIbmeETOeMPOS8iuM0pdtCeWpSLy6iSKm1fay57WhceMyVGH7rg7Mh2QZyWr65ddiNJrUESWGXbRACZLPt6yCLGbPHy06qQE9Nl8rPpsBoxZWfjPp6fc+uBndoTHoHDirOPV29tbewLHCv0gPMPEFkRRhq7Rul7wksFpP1qJdZWGTLwIzDEo8C4S7E1sR7uthtE+X1frN/zLl1M8gCRkwg+bdtMrYlTGf753368y2D7+zeTUKNTfCeVOFyaPz6zP3wm6IuVM3HBQ49pFZNR1nlWRCGgS+5xqyUdgJTJS/6s/fxLi/PcsFz2Ul4BGyhcGqKEKYEa3ufdyDIf1sTXJHE5N7VmJT8Fa9UNwBClrTji6jdbEW8lhoVuHP1FptcyVT7UZ12c8Vheo+uSpcpZeeQlUWUBAXkMsnl/NTYdTLuBdaY2D9LdyuWHzZwj2U2Sluu5zSLgszEAL5qztSnVjtW/yq+YWVFfvOzSdxHx59Rrt0JF5vDMRfokIfKEIzO/7C84xxe4bY15PqxRWEJiXmfMkYpUxi+2Fbec9cHygzVgK3wP2IWhT/8ksENXNp0FjEPIfhMtxG5PeqyKNwgew5Lzt7tBjL3FLEqg8MHfSLizcjuew/QzR8zUMPeSOcX3ByvuLGEluVJ8RM8sQdoiVv3ALewBSEUie+Vo6x/Kio6mR27sLbfUuD+q+jCYKSdDq4gpYGO46qzDa5YVzO1DTf20Quwz122s32ICGQ49U1MoMSRPOCwMoroIbMF1qvCRUa83amj95fk/7Xi7VJh2zneAlLhx7imRyp+mdAVG46jGbXgMDKC3Y2OL/GVYY6yEudgfyObfV80icK57vy6rQ0Q9FS+EdsWbxlX68Hje+JpidUwiaaquhqAz+GjOZjJPGirYFVN0n7SNqMqvzOh/lcWBwlhVoKA/YZrMEn5gtyXKY7/ecaOtc9+bCqExt+uCXOdJLRUTarKUran60fN5wurBHzMoZTeOTesG9UdM175c4bCN8BAVLu1TLUG7fuqm5oZ+VyFXmkMMrMhNLnPLaeExrTp0APDnwxs/xcONiBlMKKCR5qoftsalfc9W1HWvhv5BnAgM1JMtisQK88BccmGWsb9g4fzQtlbHoUR/mHP5O8YDRQ8bsWfB2wkS5p8s4gQ8CLDtwjlHK1StS9UC99YvPUX7axHsd14Y=",
"qScore": "100",
"nmPoints": "44",
"rdsVer": "1.0.3"
}
}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": "Transaction Successful",
"data": {
"externalRef": "1672908701918",
"bankName": "ICICI Bank",
"accountNumber": "xxxxxxxx7259",
"ipayId": "CNA012300514211687",
"transactionMode": "CR",
"payableValue": "0.95",
"transactionValue": "0.00",
"openingBalance": "769.96",
"closingBalance": "770.91",
"operatorId": "300514648629",
"walletIpayId": "1230105142117KQVGY",
"bankAccountBalance": "163.00",
"miniStatement": [
{
"date": "02/01/2023",
"txnType": "CR",
"amount": "1.00",
"narration": "01015522"
},
{
"date": "18/10/2022",
"txnType": "DR",
"amount": "2000.00",
"narration": "NFI/CASH"
},
{
"date": "17/10/2022",
"txnType": "CR",
"amount": "2000.00",
"narration": "APBS/PM"
},
{
"date": "01/10/2022",
"txnType": "CR",
"amount": "1.00",
"narration": "01015522"
},
{
"date": "01/07/2022",
"txnType": "CR",
"amount": "1.00",
"narration": "01015522"
},
{
"date": "01/06/2022",
"txnType": "DR",
"amount": "2000.00",
"narration": "NFI/CASH"
},
{
"date": "31/05/2022",
"txnType": "CR",
"amount": "2000.00",
"narration": "APBS/PM"
},
{
"date": "02/04/2022",
"txnType": "CR",
"amount": "1.00",
"narration": "01015522"
},
{
"date": "01/01/2022",
"txnType": "CR",
"amount": "1.00",
"narration": "01015522"
}
]
},
"timestamp": "2023-01-05 14:21:17",
"ipay_uuid": "h005982670ba-ac90-4e3d-b95e-5e0d3cc34c76",
"orderid": "1230105142117KQVGY",
"environment": "LIVE",
"internalCode": null
}
Aadhaar Encryption (Sample)For Aadhaar Encryption Details click here
Please Note :To avoid transaction failures and account suspension, for every merchant you need to pass the unique outlet Id in the headers.