Payonclick Developer Docs
v1

Aadhaar Pay

POST https://payonclick.in/ext/v1/aeps/aadhaar-pay
Requires aeps Signed request Counts toward your 60 req/min

Customer pays the outlet from their bank account; your AEPS wallet is credited


Body Params

NameTypeDescription
merchant_ref required string An ACTIVE outlet with today’s AP daily authentication
client_reference required string Your unique idempotency key
aadhaar required string Customer’s Aadhaar
bank_iin required string From GET /banks
amount required number ₹1 – ₹50,000
pid_data required string Customer’s PidData XML
auth_mode optional string FP or IRIS
otp_reference optional string From POST /otp — required above ₹5,000
customer_mobile optional string 10-digit mobile
latitude required number GPS latitude
longitude required number GPS longitude

Responses

StatusDescription
201 Created Customer pays the outlet from their bank account; your AEPS wallet is credited — 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/aadhaar-pay\n{TIMESTAMP}\n{BODY_SHA256}. The samples on the right compute it for you; the rules are in Request Signing.

📘
Good to know

Aadhaar Pay needs its own daily authentication: POST /merchants/{merchant_ref}/daily-auth with "service": "AP". PENDING and replay behave as for Cash Withdrawal.