₹ZeroRecharge

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.

Related