Payonclick Developer Docs
v1

Pay Bill

POST https://payonclick.in/ext/v1/bbps/bill/pay
Requires bills or transfer Signed request Counts toward your 60 req/min

Pay against the bill_token — TPIN and idempotency key required


Body Params

NameTypeDescription
bill_token required string From /bill/fetch, valid 15 minutes
amount required number ₹1 – ₹2,00,000
tpin required string Your account TPIN
client_reference required string Your unique id — the idempotency key

Responses

StatusDescription
201 Created Pay against the bill_token — TPIN and idempotency key required — see the example on the right.
200 OK · replayed 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/bbps/bill/pay\n{TIMESTAMP}\n{BODY_SHA256}. The samples on the right compute it for you; the rules are in Request Signing.

📘
Good to know

Re-sending the same client_reference returns the original transaction with duplicate: true — it never pays twice. On a timeout, always retry with the same value.