⭐

support@a1topup.com
9161019161|8125943396

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.

View Commission Get API Key
Recharge API Integration

Supported Services

We support all major mobile operators, DTH providers, and utility services across India

Mobile Recharge

Airtel, Vodafone, Jio, BSNL, Idea and all major operators with instant processing

DTH Recharge

Airtel Digital TV, Tata Sky, Dish TV, Sun Direct, Videocon D2H and more

Utility Bills

Postpaid, Electricity, Google play voucher, Gas, Insurance payments and FASTag recharge

API Documentation

Complete guide to integrate our recharge and bill payment API

Recharge API Endpoint

GET/POST https://business.a1topup.com/recharge/api
Request 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=json
Response Formats
CSV Format (Default)
1225,Success,WB22565584,980000000,10,485668

CSV Response Parameters:

  1. txid - Transaction ID
  2. status - Success/Failure
  3. opid - Operator ID
  4. number - Recharge number
  5. amount - Recharge amount
  6. 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/balance
Request 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=json
Sample Response
{ "status": "success", "balance": "1542.50", "currency": "INR" }

Status API Endpoint

GET/POST https://business.a1topup.com/recharge/status
Request 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=json
Sample 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_ID
Callback 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
AirtelAMobile
VodafoneVMobile
BSNL - TOPUPBTMobile
RELIANCE - JIORCMobile
IdeaIMobile
BSNL - STVBRMobile
Airtel Digital DTH TVATVDTH
SUNDIRECT DTH TVSTVDTH
TATASKY DTH TVTTVDTH
VIDEOCON DTH TVVTVDTH
DISH TVDTVDTH
Airtel PostpaidPATPostPaid
Idea PostpaidIPPostPaid
Vodafone PostpaidVPPostPaid
JIO PostPaidJPPPostPaid
BSNL PostPaidBPPostPaid
Tata Docomo PostpaidDPPostpaid
BSNL LandlineLBSPostPaid
MTNL Delhi LandlineLMTPostPaid
Airtel LandlineLATPostPaid
North Bihar ElectricityNBEElectricity
JBVNL - JharkhandJBVNLElectricity
Assam Power Distribution Company Ltd (RAPDR)APDCLRElectricity
Mangalore Electricity Supply Co. Ltd (MESCOM) - RAPDRMESCOMRElectricity
APDCL (Non-RAPDR) - AssamAPDCLNElectricity
Mangalore Electricity Supply Co. Ltd (Non-RAPDR)MESCOMNRElectricity
BSES Rajdhani Power Limited - DelhiBSESElectricity
BSES Yamuna Power Limited - DelhiBSESYElectricity
Tata Power Delhi Limited - DelhiTPDElectricity
Tata Power - MumbaiTPDMElectricity
Hubli Electricity Supply Company Ltd. (HESCOM)HESCOMElectricity
South Bihar ElectricitySBEElectricity
BEST MumbaiBESTElectricity
Ajmer Vidyut Vitran Nigam - RajasthanAJVElectricity
Bangalore Electricity Supply Company (BESCOM)BESCOMElectricity
CESC - West BengalCESCElectricity
Jaipur Vidyut Vitran Nigam - RajasthanJVVElectricity
Jodhpur Vidyut Vitran Nigam - RajasthanJDVVElectricity
MP Madhya Kshetra Vidyut Vitaran - UrbanMKVElectricity
MSEDC - MaharashtraMSEDCElectricity
Noida Power - NoidaNPElectricity
Paschim Kshetra Vitaran - Madhya PradeshPKVElectricity
Southern Power - Andhra PradeshSPAElectricity
Southern Power - TelanganaSPTElectricity
Torrent Power AgraTRPElectricity
Central Power Distribution Company of Andhra Pradesh LtdAPCPDCLElectricity
Department of Power Arunachal PradeshARPDOPElectricity
Western Electricity Supply Co. of Orissa Ltd.WESCOElectricity
Paschim Gujarat Vij Company LtdPGVCLElectricity
Bharatpur Electricity Services LtdBHESElectricity
Muzaffarpur Vidyut VitranMVVElectricity
Madhya Gujarat Vij Company LtdMGVCLElectricity
Meghalaya Power Distribution (MEPDCL)MEPDCLElectricity
KEDL - KotaKEDLElectricity
Dakshin Gujarat Vij Company LtdDGVCLElectricity
WBSEDCL - West BengalWBSEDCLElectricity
SNDL Power - NagpurSNDLElectricity
Bikaner Electricity Supply LimitedBESLElectricity
India Power - West BengalIPWBElectricity
Brihanmumbai Electric Supply & Transport (BEST)BMESTUElectricity
APEPDCL - Andhra PradeshAPEPDCLElectricity
TNEB - Tamil NaduTNEBElectricity
UPPCL (Urban) - Uttar PradeshUPPCLUElectricity
UPPCL (Rural) - Uttar PradeshUPPCLRElectricity
Dakshin Haryana Bijli Vitran NigamDHBVNElectricity
TSNPDCL - Telangana Northern PowerTSNPDCLElectricity
Dadra & Nagar Haveli Power Distribution (DDCL)DDCLElectricity
Gulbarga Electricity Supply Company Ltd (GESCL)GESCLElectricity
India Power Corporation LimitedIPCLElectricity
Jamshedpur Utilities and Services CompanyJUSCLElectricity
Chhattisgarh State Power Distribution Company LtdCSPDCLElectricity
Goa ElectricityGOAELCElectricity
Uttar Gujarat Vij Company LtdUGVCLElectricity
Torrent Power SuratTORRENTSURElectricity
Torrent Power AhmedabadTORRENTAHMElectricity
Gift Power Company LimitedGPCLElectricity
Himachal Pradesh State Electricity Board LtdHPSEBLElectricity
Jammu & Kashmir Power Development DepartmentJKPDDElectricity
Chamundeshwari Electricity Supply Corporation (CESC Mysore)CESCOMElectricity
North Delhi Power LimitedNDPLElectricity
Municipal Corporation of GurugramMCGElectricity
Punjab State Power Corporation LimitedPSPCLElectricity
Tripura State Electricity Corporation LtdTSECLElectricity
Uttar Haryana Bijli Vitran NigamUHBVElectricity
Uttarakhand Power Corporation LimitedUKPCLElectricity
Kerala State Electricity Board LtdKSEBElectricity
Kannan Devan Hills PowerKDHPCPLElectricity
Lakshadweep Electricity DepartmentLEDElectricity
MP Poorv Kshetra Vidyut Vitaran - JabalpurMPPKVVCLPUElectricity
MP Poorv Kshetra Vidyut Vitaran - RuralMPPKVVCLMRElectricity
MP Poorv Kshetra Vidyut Vitaran - UrbanMPPKVVCLElectricity
Reliance EnergyRELIANCEElectricity
Torrent Power ShilTORRENTSHIElectricity
Torrent Power BhivandiTORRENTBHIElectricity
Adani PowerAEMLElectricity
Manipur State Power Distribution Company Ltd (Prepaid)MSPDCLPRElectricity
Power & Electricity Department - MizoramMPEDElectricity
Department of Power - NagalandNDOPElectricity
New Delhi Municipal Council (NDMC) - ElectricityNDMCElectricity
NESCO OdishaNESCOElectricity
SOUTHCO OdishaSOUTHCOElectricity
TP Central Odisha Distribution LtdTPCODLElectricity
Puducherry Electricity DepartmentPGPEDElectricity
TP Ajmer Distribution LtdTPADLElectricity
Sikkim Power RuralSPRElectricity
Sikkim Power UrbanSPUElectricity
Kanpur Electricity Supply Company (KESCO)KESCOElectricity
Torrent Power DahejTORRENTDAHElectricity
Mahanagar GasMGGas
Adani GasAGGas
Gujarat GasGGGas
Indraprastha GasIGGas
HPCL GasHPCLGCGas
ICICI Prudential InsuranceICPInsurance
Tata AIA InsuranceTAIInsurance
Jammu & Kashmir Bank FASTagJKFFASTag
Kotak Mahindra Bank FASTagKMFFASTag
IndusInd Bank FASTagINDFFASTag
Indian Highways Management Company Ltd FASTagIHMCFFASTag
IDFC First Bank FASTagIFFFASTag
ICICI Bank FASTagICFFASTag
HDFC Bank FASTagHDFFASTag
Equitas Bank FASTagEFFFASTag
Bank of Baroda FASTagBBFFASTag
Axis Bank FASTagAXFFASTag
Federal Bank FASTagFDFFASTag
Paytm Payments Bank FASTagPTFFASTag
Airtel Payments Bank FASTagAPBFASTag
IDBI Bank FASTagIBFFASTag
SBI Bank FASTagSBFFASTag
Google Play Gift CardGLFVoucher

Circle Code List

Telecom circle codes for different states and regions

State Circle Code
Andhra Pradesh13
Assam24
Bihar17
Chhattisgarh27
Gujarat12
Haryana20
Himachal Pradesh21
Jammu and Kashmir25
Jharkhand22
Karnataka9
Kerala14
Madhya Pradesh16
Maharashtra4
Orissa23
Punjab1
Rajasthan18
Tamil Nadu8
Uttar Pradesh East10
Uttar Pradesh West11
West Bengal2
Mumbai3
Delhi5
Chennai7
North East26
Kolkata6
Ready to Get Started?

Sign up today and get your API credentials to start integrating recharge services into your application.

Get API Key Now