Payonclick Developer Docs
v1

Cash Deposit

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

Customer deposits cash into their bank account; your AEPS wallet is debited


Body Params

NameTypeDescription
merchant_ref required string An ACTIVE outlet with today’s AEPS daily authentication
client_reference required string Your unique idempotency key
tpin required string Your account TPIN
aadhaar required string Customer’s Aadhaar
bank_iin required string From GET /banks
amount required number ₹100 – ₹10,000, whole rupees
pid_data required string Customer’s PidData XML
auth_mode optional string FP or IRIS
customer_mobile optional string 10-digit mobile
latitude required number GPS latitude
longitude required number GPS longitude

Responses

StatusDescription
201 Created Customer deposits cash into their bank account; your AEPS wallet is debited — 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/cash-deposit\n{TIMESTAMP}\n{BODY_SHA256}. The samples on the right compute it for you; the rules are in Request Signing.

📘
Good to know

amount + charge is debited from your AEPS wallet before the bank call (INSUFFICIENT_BALANCE sends nothing). A declined deposit is refunded automatically (refunded: true); a PENDING one keeps the amount held until the bank confirms. NPCI does not allow a deposit within 30 minutes of a withdrawal for the same customer and bank (CD_COOLDOWN).