Payonclick Developer Docs
v1

Cash Withdrawal

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

Customer withdraws cash; your AEPS wallet is credited


Body Params

NameTypeDescription
merchant_ref required string An ACTIVE outlet with today’s AEPS daily authentication
client_reference required string Your unique id and the idempotency key. 1–64 chars: letters, digits, hyphen, underscore
aadhaar required string Customer’s 12-digit Aadhaar
bank_iin required string Customer’s bank, from GET /banks
amount required number ₹100 – ₹10,000, multiple of ₹50
customer_mobile optional string Customer’s 10-digit mobile
pid_data required string Customer’s PidData XML (GET /pid-options?purpose=TXN)
auth_mode optional string FP (default) or IRIS
otp_reference optional string From POST /otp — required above ₹5,000
latitude required number Outlet GPS latitude
longitude required number Outlet GPS longitude
device_imei optional string Biometric device serial number

Responses

StatusDescription
201 Created Customer withdraws cash; your AEPS wallet is credited — see the example on the right.
201 Created · pending Alternate outcome for the same call — the second Response tab.
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/cash-withdrawal\n{TIMESTAMP}\n{BODY_SHA256}. The samples on the right compute it for you; the rules are in Request Signing.

📘
Good to know

Hand over cash only on SUCCESS. 201 carries SUCCESS or PENDING; a FAILED transaction returns 200 with success: true (the request was handled) and a failure_code. Re-sending the same client_reference returns the original transaction with duplicate: true and never reaches the bank again — retry a timeout that way. reference_id is our id (store it as text); bank_rrn is the bank’s reference for a customer dispute; account_balance is the customer’s balance after the withdrawal. One transaction per outlet at a time.