Prepaid recharge API
One prepaid recharge API for every Indian operator
Add prepaid mobile recharge to your app, website or retailer panel with a single integration. The same calls work across Airtel, Jio, Vi and BSNL.
What you get
Everything needed to sell a prepaid recharge, from the number being typed to the final status.
- Operator and circle detection from a 10-digit number
- Plans grouped by category for each circle
- Wallet billing with a balance endpoint
- SUCCESS, FAILED or PENDING status for every order
Designed around failure
Networks drop and operators delay. Send a client_ref and a retry returns the original order instead of charging twice. Failed recharges are refunded to your wallet automatically, and pending ones can be polled until they settle.
Controls for production
Create separate keys for each environment, lock a key to your server IPs, and revoke it at any time. Your dashboard shows every call with its status and latency.
The integration, in three calls
bash
# 1. Find the operator and circle
curl "https://zrecharge.bottercc.com/api/v1/detect?number=98XXXXXXXX" \
-H "Authorization: Bearer rk_live_..."
# 2. List plans for that circle
curl "https://zrecharge.bottercc.com/api/v1/plans?operator_id=OPERATOR_ID&circle_id=CIRCLE_ID" \
-H "Authorization: Bearer rk_live_..."
# 3. Recharge
curl -X POST https://zrecharge.bottercc.com/api/v1/recharge \
-H "Authorization: Bearer rk_live_..." \
-H "Content-Type: application/json" \
-d '{"number":"98XXXXXXXX","operator_id":OPERATOR_ID,"circle_id":CIRCLE_ID,"amount":349,"client_ref":"order_1042"}'Frequently asked questions
How do I get an API key?
Create a free account, open the API section of your dashboard and generate a key. You can restrict each key to a list of server IPs.
How is an API recharge paid for?
Every recharge is debited from your wallet at the plan price. Top up the wallet with Razorpay, and call the balance endpoint to monitor it from your own systems.
Which operators does the prepaid API cover?
Airtel, Jio, Vi and BSNL prepaid. The detect endpoint returns the operator and circle IDs to use for each number.
Do you support postpaid or DTH?
Not at the moment. The API covers prepaid mobile recharge.