Recharge API Integration
Integrate mobile recharge, DTH, postpaid, and utility bill payment services with our robust API. Support for all major operators across India with instant processing.
- GST registered company
- Direct operator connectivity
- Phone & WhatsApp support
API Documentation
Complete guide to integrate our recharge and bill payment API
Recharge API Endpoint
GET/POST https://business.a1topup.com/recharge/apiRequest Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
username | Yes | Your API username | 500011 |
pwd | Yes | Your API password | 123 |
circlecode | No | Circle code for the mobile number | 2 (West Bengal) |
operatorcode | Yes | Operator code (see operator list below) | A (Airtel) |
number | Yes | Mobile number or consumer number | 980000000 |
amount | Yes | Recharge amount | 10 |
orderid | Yes | Your unique order ID | 485668 |
format | Yes | Response format (csv, json, xml) | json |
Sample Request
https://business.a1topup.com/recharge/api?username=500011&pwd=123&circlecode=2&operatorcode=A&number=980000000&amount=10&orderid=485668&format=jsonResponse Formats
CSV Format (Default)
1225,Success,WB22565584,980000000,10,485668CSV Response Parameters:
- txid - Transaction ID
- status - Success/Failure
- opid - Operator ID
- number - Recharge number
- amount - Recharge amount
- orderid - Your order ID
JSON Format
{
"txid": "5804",
"status": "Success",
"opid": "RJ0317161622000269New",
"number": "980000000",
"amount": "10",
"orderid": "485668"
}XML Format
<response>
<txid>5804</txid>
<status>Success</status>
<opid>RJ0317161622000269New</opid>
<number>9134350662</number>
<amount>10</amount>
<orderid>485668</orderid>
</response>Balance API Endpoint
GET/POST https://business.a1topup.com/recharge/balanceRequest Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
username | Yes | Your API username | 500011 |
pwd | Yes | Your API password | 123 |
format | Yes | Response format (csv, json, xml) | json |
Sample Request
https://business.a1topup.com/recharge/balance?username=500011&pwd=123&format=jsonSample Response
{
"status": "success",
"balance": "1542.50",
"currency": "INR"
}Status API Endpoint
GET/POST https://business.a1topup.com/recharge/statusRequest Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
username | Yes | Your API username | 500011 |
pwd | Yes | Your API password | 123 |
orderid | Yes | Your unique order ID | 485668 |
format | Yes | Response format (csv, json, xml) | json |
Sample Request
https://business.a1topup.com/recharge/status?username=500011&pwd=123&orderid=485668&format=jsonSample Response
{
"status": "Success",
"txid": "5804",
"opid": "RJ0317161622000269New",
"number": "980000000",
"amount": "10",
"orderid": "485668",
"timestamp": "2023-12-15 10:30:05"
}Callback URL Configuration
With the callback URL, you will receive automatic status updates for your transactions.
Callback URL Format
www.yourdomain.com/yourfile?txid=YOUR_ORDER_ID&status=Success/Failure&opid=OPERATOR_IDCallback Parameters
| Parameter | Description |
|---|---|
txid | Unique recharge ID provided by you |
status | Success or Failure |
opid | Operator ID from the operator |
Operator Code List
All supported operators with their codes and service types
| Operator Name | Operator Code | Service Type |
|---|---|---|
| Airtel | A | Mobile |
| Vodafone | V | Mobile |
| BSNL - TOPUP | BT | Mobile |
| RELIANCE - JIO | RC | Mobile |
| Idea | I | Mobile |
| BSNL - STV | BR | Mobile |
| Airtel Digital DTH TV | ATV | DTH |
| SUNDIRECT DTH TV | STV | DTH |
| TATASKY DTH TV | TTV | DTH |
| VIDEOCON DTH TV | VTV | DTH |
| DISH TV | DTV | DTH |
| Airtel Postpaid | PAT | PostPaid |
| Idea Postpaid | IP | PostPaid |
| Vodafone Postpaid | VP | PostPaid |
| JIO PostPaid | JPP | PostPaid |
| BSNL PostPaid | BP | PostPaid |
| Tata Docomo Postpaid | DP | Postpaid |
| BSNL Landline | LBS | PostPaid |
| MTNL Delhi Landline | LMT | PostPaid |
| Airtel Landline | LAT | PostPaid |
| North Bihar Electricity | NBE | Electricity |
| JBVNL - Jharkhand | JBVNL | Electricity |
| Assam Power Distribution Company Ltd (RAPDR) | APDCLR | Electricity |
| Mangalore Electricity Supply Co. Ltd (MESCOM) - RAPDR | MESCOMR | Electricity |
| APDCL (Non-RAPDR) - Assam | APDCLN | Electricity |
| Mangalore Electricity Supply Co. Ltd (Non-RAPDR) | MESCOMNR | Electricity |
| BSES Rajdhani Power Limited - Delhi | BSES | Electricity |
| BSES Yamuna Power Limited - Delhi | BSESY | Electricity |
| Tata Power Delhi Limited - Delhi | TPD | Electricity |
| Tata Power - Mumbai | TPDM | Electricity |
| Hubli Electricity Supply Company Ltd. (HESCOM) | HESCOM | Electricity |
| South Bihar Electricity | SBE | Electricity |
| BEST Mumbai | BEST | Electricity |
| Ajmer Vidyut Vitran Nigam - Rajasthan | AJV | Electricity |
| Bangalore Electricity Supply Company (BESCOM) | BESCOM | Electricity |
| CESC - West Bengal | CESC | Electricity |
| Jaipur Vidyut Vitran Nigam - Rajasthan | JVV | Electricity |
| Jodhpur Vidyut Vitran Nigam - Rajasthan | JDVV | Electricity |
| MP Madhya Kshetra Vidyut Vitaran - Urban | MKV | Electricity |
| MSEDC - Maharashtra | MSEDC | Electricity |
| Noida Power - Noida | NP | Electricity |
| Paschim Kshetra Vitaran - Madhya Pradesh | PKV | Electricity |
| Southern Power - Andhra Pradesh | SPA | Electricity |
| Southern Power - Telangana | SPT | Electricity |
| Torrent Power Agra | TRP | Electricity |
| Central Power Distribution Company of Andhra Pradesh Ltd | APCPDCL | Electricity |
| Department of Power Arunachal Pradesh | ARPDOP | Electricity |
| Western Electricity Supply Co. of Orissa Ltd. | WESCO | Electricity |
| Paschim Gujarat Vij Company Ltd | PGVCL | Electricity |
| Bharatpur Electricity Services Ltd | BHES | Electricity |
| Muzaffarpur Vidyut Vitran | MVV | Electricity |
| Madhya Gujarat Vij Company Ltd | MGVCL | Electricity |
| Meghalaya Power Distribution (MEPDCL) | MEPDCL | Electricity |
| KEDL - Kota | KEDL | Electricity |
| Dakshin Gujarat Vij Company Ltd | DGVCL | Electricity |
| WBSEDCL - West Bengal | WBSEDCL | Electricity |
| SNDL Power - Nagpur | SNDL | Electricity |
| Bikaner Electricity Supply Limited | BESL | Electricity |
| India Power - West Bengal | IPWB | Electricity |
| Brihanmumbai Electric Supply & Transport (BEST) | BMESTU | Electricity |
| APEPDCL - Andhra Pradesh | APEPDCL | Electricity |
| TNEB - Tamil Nadu | TNEB | Electricity |
| UPPCL (Urban) - Uttar Pradesh | UPPCLU | Electricity |
| UPPCL (Rural) - Uttar Pradesh | UPPCLR | Electricity |
| Dakshin Haryana Bijli Vitran Nigam | DHBVN | Electricity |
| TSNPDCL - Telangana Northern Power | TSNPDCL | Electricity |
| Dadra & Nagar Haveli Power Distribution (DDCL) | DDCL | Electricity |
| Gulbarga Electricity Supply Company Ltd (GESCL) | GESCL | Electricity |
| India Power Corporation Limited | IPCL | Electricity |
| Jamshedpur Utilities and Services Company | JUSCL | Electricity |
| Chhattisgarh State Power Distribution Company Ltd | CSPDCL | Electricity |
| Goa Electricity | GOAELC | Electricity |
| Uttar Gujarat Vij Company Ltd | UGVCL | Electricity |
| Torrent Power Surat | TORRENTSUR | Electricity |
| Torrent Power Ahmedabad | TORRENTAHM | Electricity |
| Gift Power Company Limited | GPCL | Electricity |
| Himachal Pradesh State Electricity Board Ltd | HPSEBL | Electricity |
| Jammu & Kashmir Power Development Department | JKPDD | Electricity |
| Chamundeshwari Electricity Supply Corporation (CESC Mysore) | CESCOM | Electricity |
| North Delhi Power Limited | NDPL | Electricity |
| Municipal Corporation of Gurugram | MCG | Electricity |
| Punjab State Power Corporation Limited | PSPCL | Electricity |
| Tripura State Electricity Corporation Ltd | TSECL | Electricity |
| Uttar Haryana Bijli Vitran Nigam | UHBV | Electricity |
| Uttarakhand Power Corporation Limited | UKPCL | Electricity |
| Kerala State Electricity Board Ltd | KSEB | Electricity |
| Kannan Devan Hills Power | KDHPCPL | Electricity |
| Lakshadweep Electricity Department | LED | Electricity |
| MP Poorv Kshetra Vidyut Vitaran - Jabalpur | MPPKVVCLPU | Electricity |
| MP Poorv Kshetra Vidyut Vitaran - Rural | MPPKVVCLMR | Electricity |
| MP Poorv Kshetra Vidyut Vitaran - Urban | MPPKVVCL | Electricity |
| Reliance Energy | RELIANCE | Electricity |
| Torrent Power Shil | TORRENTSHI | Electricity |
| Torrent Power Bhivandi | TORRENTBHI | Electricity |
| Adani Power | AEML | Electricity |
| Manipur State Power Distribution Company Ltd (Prepaid) | MSPDCLPR | Electricity |
| Power & Electricity Department - Mizoram | MPED | Electricity |
| Department of Power - Nagaland | NDOP | Electricity |
| New Delhi Municipal Council (NDMC) - Electricity | NDMC | Electricity |
| NESCO Odisha | NESCO | Electricity |
| SOUTHCO Odisha | SOUTHCO | Electricity |
| TP Central Odisha Distribution Ltd | TPCODL | Electricity |
| Puducherry Electricity Department | PGPED | Electricity |
| TP Ajmer Distribution Ltd | TPADL | Electricity |
| Sikkim Power Rural | SPR | Electricity |
| Sikkim Power Urban | SPU | Electricity |
| Kanpur Electricity Supply Company (KESCO) | KESCO | Electricity |
| Torrent Power Dahej | TORRENTDAH | Electricity |
| Mahanagar Gas | MG | Gas |
| Adani Gas | AG | Gas |
| Gujarat Gas | GG | Gas |
| Indraprastha Gas | IG | Gas |
| HPCL Gas | HPCLGC | Gas |
| ICICI Prudential Insurance | ICP | Insurance |
| Tata AIA Insurance | TAI | Insurance |
| Jammu & Kashmir Bank FASTag | JKF | FASTag |
| Kotak Mahindra Bank FASTag | KMF | FASTag |
| IndusInd Bank FASTag | INDF | FASTag |
| Indian Highways Management Company Ltd FASTag | IHMCF | FASTag |
| IDFC First Bank FASTag | IFF | FASTag |
| ICICI Bank FASTag | ICF | FASTag |
| HDFC Bank FASTag | HDF | FASTag |
| Equitas Bank FASTag | EFF | FASTag |
| Bank of Baroda FASTag | BBF | FASTag |
| Axis Bank FASTag | AXF | FASTag |
| Federal Bank FASTag | FDF | FASTag |
| Paytm Payments Bank FASTag | PTF | FASTag |
| Airtel Payments Bank FASTag | APB | FASTag |
| IDBI Bank FASTag | IBF | FASTag |
| SBI Bank FASTag | SBF | FASTag |
| Google Play Gift Card | GLF | Voucher |
Circle Code List
Telecom circle codes for different states and regions
| State | Circle Code |
|---|---|
| Andhra Pradesh | 13 |
| Assam | 24 |
| Bihar | 17 |
| Chhattisgarh | 27 |
| Gujarat | 12 |
| Haryana | 20 |
| Himachal Pradesh | 21 |
| Jammu and Kashmir | 25 |
| Jharkhand | 22 |
| Karnataka | 9 |
| Kerala | 14 |
| Madhya Pradesh | 16 |
| Maharashtra | 4 |
| Orissa | 23 |
| Punjab | 1 |
| Rajasthan | 18 |
| Tamil Nadu | 8 |
| Uttar Pradesh East | 10 |
| Uttar Pradesh West | 11 |
| West Bengal | 2 |
| Mumbai | 3 |
| Delhi | 5 |
| Chennai | 7 |
| North East | 26 |
| Kolkata | 6 |
What our customers say
Retailers, distributors and businesses that run on A1Topup every day.
The recharge software from A1Topup helped me start my business within days. The white-label solution is perfect and the commissions are the best in the market.
Rajesh KumarMumbai
Excellent software with all the features I needed. The admin dashboard is very intuitive and the support team is always available to help.
Priya SinghDelhi
I've been using this software for 6 months now and it's been a game-changer for my business. The multi-tier commission system helps me manage my resellers easily.
Vikram PatelAhmedabad
The API integration was seamless and the documentation was excellent. My developers had no issues implementing it into our existing system. Highly recommended!
Amit SharmaBangalore
The reporting features have given me valuable insights into my business. I can now track sales, commissions, and customer behaviour all in one place.
Venket ReddyHyderabad
The mobile app works flawlessly. My customers love the convenience of recharging on the go. The transaction success rate is impressive compared to other providers.
Rahul MehtaChennai
Get in touch
Ready to Get Started?
Sign up today and get your API credentials to start integrating recharge services into your application.
Rated 4.9/5 from 310 Google reviews by businesses.
- GST registeredGSTIN 36AAWCA0064F1ZN
- Since 2016In the recharge business
- 10,000+ partnersAcross India
- Real peoplePhone & WhatsApp support
