₹ZeroRecharge

Vodafone / Vi recharge API

Vodafone Idea (Vi) recharge API for your product

Vodafone and Idea numbers both run on Vi today. One integration covers them: pass the number, and the API tells you the operator ID and circle to use.

Get an API keyRead the docs

Old Vodafone and Idea numbers just work

Your users may still think of themselves as Vodafone or Idea customers. Detection maps the number to the right operator, so you do not need to ask them, or to maintain your own mapping tables.

Built for resellers and apps

Each user account has its own wallet, keys and logs. Keys can be locked to your server IPs, and every call appears in your dashboard for debugging and reconciliation.

  • Bearer token authentication
  • Per-key IP whitelisting
  • Idempotent orders with client_ref
  • JSON responses with stable error codes

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

Is Vodafone a different operator from Idea here?

Use the operator ID returned by the detect endpoint. It tells you exactly which ID to send for a given number.

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.

Is there a sandbox?

There is no sandbox at the moment. The detect and plans endpoints are free to call and do not move money, so you can build against those first.

Related