AePS - Daily Authentication

❗️

Important

  • As per NPCI, It is mandatory for users to follow two authentication daily such as follows:

“AEPS Bio Auth” based on EKYC details (API attached below)
During the calendar day, the switch will allow transactions only if CSP Agent login through Bio Auth is successful for that calendar day.

If the CSP Agent is successfully authenticated using biometric authentication, then Bank will give a successful response via API. Then user will be enabled to perform AePS transactions.

In case of exceptions & Technical issues at Acquiring bank, merchants have to complete 2 FA twice in a day once received response Code FP069 for further processing of transactions.

Response Error Codes

ERROR CODESMEANINGSOLUTION
403ForbiddenRegenerate your secret key and
timestamp or check if your service is activated or not
500Internal Server ErrorCheck if your request url is correct or
the parameters you're passing is correct
according to the parameters mentioned above
415Unsupported Media TypeRe-check the content/type of the request body.

📘

For secret-key generation, refer to Authentication

❗️

Daily KYC now have a pricing of 0.8+ GST.

🚧

After 30th June service_code parameter will be required/mandatory

Form Data
string
required

The unique cell number with which Partner is onboarded on Eko's platform.

string
required

8 Digit code of registered user (Partner’s merchant) received in the response of user onboarding.

string
required

Mobile number of registered user (customer)

string

unique transaction id generated from your end

string
required

valid latlong of the merchant from whom the request is coming

string
required
string
required

Merchant's Encrypted Aadhaar number

string
required

PID data returned in XML format of the biometric device needs to passed as string.

int32

For Fingpay use service_code=43, for Fino use service_code=52.

Headers
string
required

Your unique API key that will authenticate your request. For UAT, refer to Platform Credentials

string
required

Refer to authentication section

string
required

Refer to authentication section

Responses

Language
Request
Choose an example:
text/plain
application/json