Payonclick Developer Docs
v1

Recharge — Prepaid Mobile & DTH

Prepaid mobile and DTH recharge across the major Indian operators, paid from your MAIN wallet. Pick an operator, preview the debit, recharge with your own idempotency key, then read the status or take the webhook.

Base: /ext/v1/recharge Permission: recharge Wallet: MAIN Services: PREPAID, DTH Per recharge: ₹1 – ₹50,000, whole rupees Idempotency: client_reference on /recharge (required) Status: callback in seconds; re-checked every 2 min
⚠️
PENDING is not a failure

Most recharges are confirmed by the operator within seconds; some take a few minutes. A PENDING recharge is already with the operator, so never send it again under a new client_reference — that recharges the number twice. Poll /transaction/{reference_id} every 30–60 seconds or subscribe to the recharge.* webhooks. It always settles to SUCCESS or FAILED, and the debit of a FAILED recharge is released back to your MAIN wallet automatically.

📘
You choose the operator

The API recharges the operator and amount you send. It does not detect a number's operator or circle, and it does not list plans. A number that was ported (MNP) must be sent with its current operator; otherwise the operator rejects it with failure_code: INVALID_NUMBER and the debit is released.

Integration flow

1
/operators
List operators and the operator_id each one uses.
2
/quote
Preview exactly what your wallet will be debited.
3
/recharge
Recharge with your TPIN and your client_reference.
4
/transaction/{reference_id}
Read the outcome, or take the recharge.* webhook.

Endpoints

Operators & Quote

Recharge

Status & History