Payonclick Developer Docs
v1

eKYC · Biometric

POST https://payonclick.in/ext/v1/aeps/merchants/{merchant_ref}/ekyc/biometric
Requires aeps Signed request Counts toward your 60 req/min

Complete eKYC with the merchant’s own fingerprint (step 2c)


Body Params

NameTypeDescription
merchant_ref required path The onboarded outlet
aadhaar required string Merchant’s 12-digit Aadhaar
pid_data required string PidData XML from the RD service, captured with GET /pid-options?purpose=EKYC
device_imei optional string Biometric device serial number

Responses

StatusDescription
200 OK Complete eKYC with the merchant’s own fingerprint (step 2c) — see the example on the right.
4xx / 5xx { "success": false, "error": { "code": "…", "message": "…" } } — every code is listed under Error Codes.
🔏
This call must be signed

POST carries an X-Signature header over POST\n/ext/v1/aeps/merchants/{merchant_ref}/ekyc/biometric\n{TIMESTAMP}\n{BODY_SHA256}. The samples on the right compute it for you; the rules are in Request Signing.

📘
Good to know

Capture with GET /pid-options?purpose=EKYC; the eKYC wadh differs from transactions. A rejected fingerprint answers EKYC_FAILED — capture again and resubmit; the verified OTP stays valid for a few minutes. REONBOARD_REQUIRED means the bank account given at onboarding did not match: re-submit POST /merchants.