1|Page

RECHARGE API
PREPAID / POSTPAID / DTH / DATACARD

EZYREACH INFOCOM PVT. LTD

https://ezyreach.in||hello@ezyreach.in
2|Pa
ge

What is API
In computer programming, a set of functions and procedures that allow the creation of
applications which access the features or data of an operating system, application, or other service.
APIs are used when programming graphical user interface (GUI) components. A good API makes it
easier to develop a program by providing all the building blocks. A programmer then puts the blocks
together..

An API specification can take many forms, including an International Standard such as POSIX, vendor
documentation such as the Microsoft Windows API, the libraries of a programming language, e.g.,
Standard Template Library in C++ or Java API. Web APIs are also a vital component of today's web
fabric. An API differs from an application binary interface (ABI) in that an API is source code based while
an ABI is a binary interface. For instance POSIX is an API, while the Linux Standard Base is an ABI.

Architecture

Web services
Web services are components on a Web server that a client application can call by making HTTP
requests across the Web. ASP.NET enables you to create custom Web services or to use built-in
application services, and to call these services from any client application. We suggest the
following progression of documentation to help you navigate through the related topics.
 3|Pa
ge
Recharge API

http://182.18.129.45:8280/RechargeApp/rest/apiCal lForTxn/recharge?serviceNo= <SERVICENUMBER>&s

erviceType=<SERVIC ETYPE>&serviceSubType=<OPERATORCODE>&circleCode=<CIRCLECODE>&amoun
t=<AMOUNT>&userCode=<USERNAME>&passw ord=pom<PASSWORD>&clientTransactionId=<YOUR
_TXN_ID>
EXAMPLE:
http://182.18.129.45:8280/RechargeApp/rest/apiCallForTxn/recharge?serviceNo=9999999999&serviceType=MR
&serviceSubType=MA&circleCode=KL&amount=amount&userCode=useris&password=password &clientTransac
ti onId=123568
OUTPUT:
(JSON FORMAT)
{"SERVICE_SUB_TYPE":"MA","TXN_ID":"5674810673961","SERVICE_NO":"9903013005","ST
ATUS":"SUCCESS","SERVICE_TYPE":"MR","AMOUNT":"10","STATUS_CODE":9}

Transaction Status Check url:

http://182.18.129.45:8280/ RechargeApp/rest/apiCallForTxn/checkstatus?transactionID=<TXN_ID >

EXAMPLE: http://182.18.129.45:8280/RechargeApp/rest/apiCallForTxn/checkstatus?

transactionID= 5674810673961

{"TXNID":"5674810673961","TXNDATE":"Jul 29, 2015 5:22:09

PM","SERVICE_NO":"9903013005","OPERATOR":"MA","STATUS":"SUCCESS","SERVICE_TYPE"
:"MR","AMOUNT":"10"}
4|Pa
ge

SERVICE TYPE :

MOBILE RECHARGE MR
DTH RECHARGE DR
DATA CARD RECHARGE DCR

ERROR CODES:
ERROR
STATUS DESCRIPTION:
1 UNAUTHORISED USER
RECHARGE AMOUNT EXCEEDS USER’S
2 BALANCE
3 SAME AS ABOVE
4 RECHARGE AMOUNT IS ZERO
5 RECHARGE FAILED TECHNICAL ISSUE
6 ROOT NOT ASSIGNED
7 RECHARGED FAILED
8 RECHARGE WAITING
9 RECHARGE SUCCESS
 5|Pa
ge
OPERATOR CODES PREPAID RECHARGE

SERIAL NO OPERATOR NAME OPERRATER CODE

1 AIRCEL ML
2 AIRTEL MA
3 BSNL MB
4 BSNL TOPUP BT
5 BSNL VALIDITY BV
6 BSNL SPECIAL BS
7 BSNL 3G B3
8 BSNL CDMA BC
9 IDEA MI
10 MTNL MN
11 MTNL TOPUP MU
12 MTNL VALIDITY MY
13 MTNL MUMBAI MM
14 MTNL DL TOPUP TD
15 MTNL DL SPECIAL MS
16 MTNL MUMBAI SPECIAL MP
17 MTNL TRUMP DHL MH
18 MTS MT
19 RELIANCE CDMA RC
20 RELIANCE GSM MR
21 TATA INDICOM TI
22 TATA DOCOMO MD
23 TATA DOCOMO CDMA TC
24 TATA DOCOMO SPECIAL DS
25 UNINOR UN
26 UNINOR SPECIAL UP
27 VIDEOCON SPECIAL VS
28 VIDEOCON VR
29 VIDEOCON TOPUP VT
30 VIRGIN GSM VG
31 VIRGIN CDMA VC
32 VODAFONE MV
33 LOOP MOBILE LM
34 TATA WALKY TW
35 T24 T2
36 T24 SPECIAL T4
37 S Tel ST
38 SPICE SP
6|Pa
ge

DTH RECHARGE

SERIAL NO OPERATOR NAME OPERRATER CODE

1 BIG TV DB
2 DISH TV DD
3 SUN DIRECT SU
4 TATA SKY DT
5 VIDEOCON DV
RELIANCE DIGITAL
6 TV DR
7 BSNL STV BS

DATA CARD RECHARGE

SERIAL
NO OPERATOR NAME OPERRATER CODE
1 MTS CM
2 MTS MBLAZE CZ
3 MTS MBROWSE CB
4 RELIANCE CR
RELIANCE NET CONNECT
5 1X CX
RELIANCE NETCONNECT
6 3G CG
7 RELIANCE NETCONNECT+ CN
8 IDEA CI
9 AIRCEL CA
AIRTEL POCKET INTERN
10 ET CT
11 BSNL CS
12 TATA DOCOMO CD
13 TATA PHOTONE+ CP
14 TATA PHOTONE WHIZ CW
15 MTNL DELHI CE
16 MTNL MUMBAI CU
17 VODAFONE 3G CV
18 VODAFONE NET CRUISER CC
 7|Pa
ge

CIRCLE CODE :

S NO CIRCLE NAME CODE

1 Andaman &Nicrobar AN
2 Andhra Pradesh AP
3 Arunachal Pradesh AC
4 Assam AS
5 Bihar BH
6 Chhattisgarh CH
Dadra and Nagar
7 Haveli DN
8 Daman and Diu DD
9 Delhi DL
10 Goa GA
11 Gujarat GJ
12 Haryana HR
13 Himachal Pradesh HP
14 Jammu & Kashmir JK
15 Jharkhand JH
16 Karnataka KA
17 Kerala KR
18 Lakshadweep LA
19 Madhya Pradesh MP
20 Maharashtra MH
21 Manipur MA
22 Meghalaya MG
23 Mizoram MZ
24 Nagaland NA
25 Orissa OR
26 Pondicherry PO
27 Punjab P
28 Rajasthan RJ
29 Sikkim SK
30 Tamil Nadu TN
31 Tripura TR
32 Uttar Pradesh East UP
33 Uttrakhand UK
34 West Bengal WB
35 Uttar Pradesh West UW
36 Universal ALL
37 Kolkata KL
38 Chennai CN
39 Mumbai MU
40 Bangalore BN
8|Pa
ge