Merchant 2FA is required for a day for onboarded merchant in the entire AePS Journey. This API will help to identify whether the Merchant has done the 2FA or not.
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 |
Sample Request
curl --location --request POST 'https://api.instantpay.in/fi/aeps/outletLoginStatus' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: 45.115.105.205' \
--header 'X-Ipay-Outlet-Id: 72762'
POST /fi/aeps/outletLoginStatus HTTP/1.1
Host: api.instantpay.in
Accept: application/json
Content-Type: application/json
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: 45.115.105.205
X-Ipay-Outlet-Id: 72762
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": "LOGINREQUIRED",
"status": "Transaction Successful",
"data": {
"isFaceAuthAvailable": true,
"aadhaarLastFour": "6077",
"isTxnBioLoginRequired": false
},
"timestamp": "2025-02-19 09:52:29",
"ipay_uuid": "h0009e3f1c4d-23d7-4d39-8d39-dac94b9efc0f-tY4jPdY7Ylha",
"orderid": null,
"environment": "LIVE",
"internalCode": null
}
Note :
1- Before starting AePS transactions, make sure to register the outlet.
2- To register the outlet for 2FA the merchant must check the status through Outlet Login status API.
3- If actcode is LOGINREQUIRED then proceed with Outlet Login Call and registered the merchant before initiating AePS transactions.
4- If actcode is LOGGEDIN, the outlet has been successfully registered and can now initiate transactions
5- If you are encountering error code OUI with the message "The X-Ipay-Outlet-Id header must have a valid outletId," even though the outlet is registered on your end, please re-onboard the outlet using the Merchant Onboarding API. This issue typically arises when the outlet has not processed any transactions in the last 6 months.
6- If isFaceAuthAvailable is true then the user can initiate the Outlet Login and Trnasaction using FACE Authentication.
7- For FACE Auth WADH value in PID Options will be empty.