Mobile Recharge API, DTH Recharge API, Free Recharge API

Recharge Api Document

Recharge API

http://api.rechapi.com/recharge.php?format=#format&token=#token&mobile=#mobile&amount=#amount&opid=#opid&urid=#urid&demo=#demo&opvalue1=#opvalue1&opvalue2=#opvalue2
/*
#format -> text/xml/json
#token  -> Recharge Api Token
#mobile -> 10 digit valid mobile number or landline number excluding std code or Dth number
#amount -> Recharge amount
#op     -> Mobile operator id (Operator id given below in table)
#urid -> Your unique transaction id , maximum length is 15.
#opvalue1 -> Required in case other than mobile , dth recharge
#opvalue2 -> Required in case other than mobile , dth recharge
#demo -> Required in case if want to demo purpose , value should be 1 for demo
*/

//Output text

#Orderid|#status|#mobile|#amount|#opid|#error_code|#service|#bal|#resText;

//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <orderId>#Orderid</orderId>
  <status>#status</status>
  <mobile>#mobile</mobile>
  <amount>#amount</amount>
  <operatorId>#opid</operatorId>
  <error_code>#error_code</error_code>
  <service>#service</service>
  <bal>#bal</bal>
  <resText>#resText</resText>
</data>

//Output json

{"data":{"orderId":#Orderid,"status":"#status","mobile":"#mobile","amount":"#amount","operatorId":"#optid","error_code":"#error_code","service":"#service","bal":"#bal","resText":"#resText"}}

/*
#Orderid -> RechApi unique recharge order id , multiple orderid supported like 1234,3434,1234 etc but supported for dispute.
#status  -> Recharge status (SUCCESS/PENDING/FAILED)
#optid -> Operator transaction id if recharge is success
#error_code -> error code from rechapi server
#service -> Operator name
#bal -> Api final balance
#resText -> error code details
*/

Recharge Status Api

http://api.rechapi.com/api_status.php?format=#format&token=#token&orderId=#orderId

//Output Text

#Orderid|#status|#mobile|#amount|#error_code|#transactionId|#bal|#resText#

//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <orderId id="#Orderid">
  <status>#status</status>
  <mobile>#mobile</mobile>
  <amount>#amount</amount>
  <error_code>#error_code</error_code>
  <transactionId>#transactionId</transactionId>
  <bal>#bal</bal>
  <resText>#resText</resText >
  </orderId>
</data>

//Output json

{"data":[{"orderId":"#Orderid","status":"#status","mobile":"#mobile","amount":"#amount","error_code":"#error_code","TransId":"#transactionId","service":"#service","reqTime":"#reqTime","bal":"#bal","resText":"#resText"}]}


/*
#status  -> Recharge status (SUCCESS/PENDING/FAILED/Disputed)
#transactionId -> Operator Transaction id
#reqTime -> Recharge request time

*/

Recharge Dispute Api

http://api.rechapi.com/dispute.php?format=#format&token=#token&orderid=#orderid

//Output text

#Orderid|#status|#error_code|#resText

//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <orderId>#Orderid</orderId>
  <status>#status</status>
  <error_code>#error_code</error_code>
  <resText>#resText</resText>
</data>

//Output json

{"data":{"orderId":"#Orderid","status":"#status","error_code":"#error_code","resText":"#resText"}}

/*
#status -> FAILED/SUCCESS
*/

Recharge Balance Api

http://api.rechapi.com/bal.php?format=#format&token=#token

//Output text

#username|#balance|#error_code|#resText

//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <user>#username</user>
  <bal>#balance</bal>
  <error_code>#error_code</error_code>
  <resText>#resText</resText>
</data>

//Output json

{"data":{"user":"#username","bal":"#balance","error_code":"#error_code","resText":"#resText"}}

Mobile Details Finder

http://api.rechapi.com/mob_details.php?format=#format&token=#token&mobile=#mobileCode
/*
#mobileCode -> First 4 digit of mobile number

*/
//Output text

#service|#location|#error_code|#resText

//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <service>#service</service>
  <location>#location</location>
  <error_code>#error_code</error_code>
  <resText>#resText</resText>
</data>

//Output json

{"data":{"service":"#service","location":"#location","error_code":"#error_code","resText":"#resText"}}

Recharge Plan Finder

https://api.rechapi.com/rech_plan.php?format=#format&token=#token&type=#rechType&cirid=#circleCode&opid=#opid

/*
#rechType -> Mobile Recharge Type . Possible values  2G , 3G , FTT , LSC , OTR , RMG , SMS , TUP
#circleCode -> code of state which is given below
*/

Api Recharge Sample Code

$url="http://api.rechapi.com/recharge.php?format=xml&token=#apiKey&mobile=#mobile&amount=#amount&opid=#operatorId&urid=#yourTransactionId"; 
$request_timeout = 60; // 60 seconds timeout
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_TIMEOUT, $request_timeout);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $request_timeout);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
$curl_error = curl_errno($ch);
$getserver= curl_getinfo($ch);
curl_close($ch);      
  if($getserver["http_code"]==200)
{

 $xml = simplexml_load_string($output);
$orderId=$xml->orderId;
$status=$xml->status;
$mobile=$xml->mobile;
$amount=$xml->amount;
$operatorId=$xml->operatorId;
$error_code=$xml->error_code;
$service=$xml->service;
$resText=$xml->resText;
   if($status=="PENDING")
  
{
#do coding for PENDING Recharge

}
elseif($status=="SUCCESS"){

#do coding for SUCCESS Recharge
}
else {

#do coding for FAILED recharge
}

}
elseif($curl_error=="28"){
#do coding for PENDING Recharge

}

Api Recharge Status Sample Code


$url="http://api.rechapi.com/api_status.php?format=xml&token=#apiKey&orderId=#orderid";
$request_timeout = 60; // 60 seconds timeout
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_TIMEOUT, $request_timeout);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $request_timeout);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
$curl_error = curl_errno($ch);
$getserver= curl_getinfo($ch);
curl_close($ch);      
  if($getserver["http_code"]==200)
{

$xml = simplexml_load_string($output);
foreach($xml as $nxml){
$orderid=$nxml[id];
$status=$nxml->status;
$optid=$nxml->transactionId;
$error_code=$nxml->error_code;

 if($status=="PENDING")
  
{
#do coding for PENDING Recharge

}
elseif($status=="SUCCESS"){

#do coding for SUCCESS Recharge
}
else {

#do coding for FAILED recharge
}


}

  

}

Operator Code

Service	Operator Code	Instruction
Airtel	1
Aircel	2
Idea	3
Bsnl Topup	4
Bsnl Special	5
Reliance CDMA	6
Reliance GSM	22
Tata Docomo Topup	7
Tata Docomo Special	8
Tata Indicom	9
Vodafone	10
MTS	11
Uninor	12
Uninor Special	13
Loop Mobile	14
Videocon	15
Videocon Special	16
MTNL DL Topup	17
MTNL DL Special	18
MTNL Mumbai	19
MTNL Mumbai Special	20
Tata Walky	21
VIDEOCON DTH	28
SUN DTH	26
BIG TV DTH	24
TATA SKY DTH	27
AIRTEL DTH	23
DISH DTH	25
Vodafone Postpaid	30
Airtel Postpaid	31
Bsnl Postpaid	32
Idea Postpaid	33
Loop Postpaid	34
Reliance CDMA Postpaid	35
Reliance GSM Postpaid	36
Tata Docomo GSM Postpaid	37
Tata Indicom Postpaid	38
Tata Walky Postpaid	39
Aircel Postpaid	40
MTS Postpaid	41
RELIANCE INFOCOM LANDLINE	42	pass Landline Number in 'mobile' and STD Code in 'opvalue1'
TIKONA INTERNET LANDLINE	43	pass User ID in mobile
AIRTEL LANDLINE	44	pass Landline Number in 'mobile' and STD Code in 'opvalue1'
BSNL LANDLINE	45	pass Landline Number in 'mobile', STD Code in 'opvalue1', Account Number in 'opvalue2'
TATA DOCOMO CDMA LANDLINE	46	pass Landline Number in 'mobile' and STD Code in 'opvalue1'
MTNL DELHI LANDLINE	47	pass Landline Number in 'mobile' and CA Number in 'opvalue1'
Adani Gas	48	pass Customer ID in 'mobile'
Gujarat Gas	49	pass Customer Number in 'mobile'
Indraprastha Gas	50	pass BP Number in 'mobile'
Mahanagar Gas	51	pass Customer Account Number in 'mobile' and Bill Group Number in 'opvalue1'
Ajmer Vidyut Vitran Nigam - RAJASTHAN	52	pass K Number in 'mobile'
APDCL - ASSAM	53
BESCOM - BENGALURU	54	pass Consumer Number in 'mobile'
BEST Undertaking - MUMBAI	55	pass Consumer Number in 'mobile'
BSES Rajdhani - DELHI	56	pass Customer Number in 'mobile'
BSES Yamuna - DELHI	57	pass Customer Number in 'mobile'
CESC - WEST BENGAL	58	pass Consumer ID in 'mobile'
CSEB - CHHATTISGARH	59	pass BP Number in 'mobile'
DHBVN - HARYANA	60
DNHPDCL - DADRA & NAGAR HAVELI	61
India Power	62	pass Consumer Number in 'mobile'
Jaipur Vidyut Vitran Nigam - RAJASTHAN	63	pass K Number in 'mobile'
Jamshedpur Utilities & Services (JUSCO)	64	pass Business Partner Number in 'mobile'
Jodhpur Vidyut Vitran Nigam - RAJASTHAN	65	pass K Number in 'mobile'
Madhya Kshetra Vitaran - MADHYA PRADESH	66	pass Consumer Number in 'mobile'
MSEDC - MAHARASHTRA	67	pass Consumer Number in 'mobile', Billing Unit in 'opvalue1' and Processing Cycle in 'opvalue2'
Noida Power - NOIDA	68	pass Consumer Number in 'mobile'
Odisha Discoms - ODISHA	69
Paschim Kshetra Vitaran - MADHYA PRADESH	70	pass Consumer Number in 'mobile'
Reliance Energy - MUMBAI	71	pass Account Number in 'mobile' and Cycle Number in 'opvalue1'
Southern Power - ANDHRA PRADESH	72	pass Service Number in 'mobile'
Southern Power - TELANGANA	73	pass Service Number in 'mobile'
Tata Power - DELHI	74	pass Customer Number in 'mobile'
Torrent Power	75	pass Service Number in 'mobile' and City Name in 'opvalue1'
TSECL - TRIPURA	76
Bharti AXA Life Insurance	77
ICICI Prudential Life Insurance	78	pass Policy Number in 'mobile' and Date of Birth (DD-MM-YYYY) in 'opvalue1'
IndiaFirst Life Insurance	79
Tata AIA Life Insurance	80	pass alphanumeric Policy Number in 'mobile' and Date of Birth (DD-MM-YYYY) in 'opvalue1'
MTS MBlaze	84
Reliance NetConnect	83
Reliance NetConnect+	82
Reliance NetConnect 3G	81
MTS MBrowse	85
Tata Photon+	86
Tata Photon Whiz	87
Vodafone 3G	88
Aircel Pocket Internet	89
BSNL Datacard	90
MTNL Delhi Datacard	91
MTNL Mumbai Datacard	92
Reliance Jio	93
MONEY TRANSFER	94

Circle Code

State	Code
Delhi/NCR	1
Mumbai	2
Kolkata	3
Maharashtra	4
Andhra Pradesh	5
Tamil Nadu	6
Karnataka	7
Gujarat	8
Uttar Pradesh (E)	9
Madhya Pradesh	10
Uttar Pradesh (W)	11
West Bengal	12
Rajasthan	13
Kerala	14
Punjab	15
Haryana	16
Bihar & Jharkhand	17
Orissa	18
Assam	19
North East	20
Himachal Pradesh	21
Jammu & Kashmir	22
Chennai	23

Error Code

Code	Value
101	Invalid Token Id
102	Invalid Mobile Number
103	Invalid Amount
104	Invalid Operator Id
105	Same Recharge After 30 minutes
106	Internal Server Error
107	Insufficient Balance
108	Internal Server Error
109	Internal Server Error
110	Recharge Failed
111	- Ip not configured
123	Internal server error
124	Internal server error
125	Internal server error
126	Internal server error
127	urid is not valid , Minimum length should be 2
128	urid is duplicate
129	Invalid Token
130	Amount should be greater than 100
131	Recharge rejected by operator
132	Invalid opid value
133	Invalid Std Code
134	Please use valid mode
135	Operator internal error
136	Invalid amount or operator
137	Token not activated
138	Token not activated
139	Operator is down in this mode
140	Operator downtime
141	Invalid Dth account
142	Invalid account number
143	Invalid opvalue 1
144	Invalid opvalue 2
145	Invalid Mobile/Dth Number
146	Invalid Amount
147	Your api is not active.
149	Invalid operator selected
200	Recharge Success
201	Recharge Pending
202	Unknow Status
203	Internal Server Error
204	Recharge Temporarly Disabled
205	Operator Down
206	Internal Server Error
207	Transaction Cancelled

Money Transfer Api Document

Customer Details Api

http://api.rechapi.com/moneyTransfer/cusDetails.php?format=#format&token=#token&customerMobile=#customerMobile
/*
#format -> xml/json
#token  -> Recharge Api Token
#customerMobile -> 10 digit valid mobile number of customer

*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<resText>#resText</resText>
	<details>
		<otpVerified>#otpVerified</otpVerified>
		<message>#message</message>
		<name>#name</name>
		<limit>#limit</limit>
		<balance>#balance</balance>
	</details>
 
	<beneficiaryList>
		<beneficiaryName>#beneficiaryName</beneficiaryName>
		<beneficiaryMobileNumber>#beneficiaryMobileNumber</beneficiaryMobileNumber>
		<beneficiaryAccountNumber>#beneficiaryAccountNumber</beneficiaryAccountNumber>
		<ifscCode>#ifscCode</ifscCode>
		<beneficiaryId>#beneficiaryId</beneficiaryId>
	</beneficiaryList>
	
	<beneficiaryList>
		....
		....
		....
		....
	</beneficiaryList>
	
</data>

//Output json

{"data":{"error_code":#error_code,"resText":"#resText","details":{"message":"#message","name":"#name","otpVerified":"#otpVerified","limit":"#limit","balance":"#balance"},"beneficiaryList":[{"beneficiaryName":"#beneficiaryName","beneficiaryMobileNumber":"#beneficiaryMobileNumber","beneficiaryAccountNumber":"#beneficiaryAccountNumber","ifscCode":"#ifscCode","beneficiaryId":"#beneficiaryId"}}]}

/*
#error_code -> If 200 means customer details found else see resText value and error_code value
#message  -> More details about customer
#name -> Name of customer
#otpVerified -> 0 or 1 , 0 -> Customer not verified , 1 -> Customer verified
#limit -> Available limit of customer
#resText -> error code details
#balance -> User wallet balance , It can be used to send money to beneficiary
*/

Customer Registration Api

http://api.rechapi.com/moneyTransfer/customerRegistration.php?format=#format&token=#token&customerName=#customerName&customerPincode=#customerPincode&customerMobile=#customerMobile
/*

#customerPincode -> 6 digit area pincode of customer
#customerName -> Customer Name

*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#mobile</mobile>
	<resText>#resText</resText>
</data>

//Output json

{"error_code":#error_code,"mobile":"#mobile","resText":"#resText"}}

/*
#error_code -> If 200 means Otp has been sent to customer mobile number else see resText value and error_code value
#mobile  -> Customer Mobile Number

*/

Customer Otp Verify

http://api.rechapi.com/moneyTransfer/customerVerifiy.php?format=#format&token=#token&&customerMobile=#customerMobile&otp=#otp

/*

#otp -> Enter otp value

*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#mobile</mobile>
	<resText>#resText</resText>
</data>

//Output json

{"error_code":#error_code,"mobile":"#mobile","resText":"#resText"}}

/*
#error_code -> If 200 means customer successfully verified and registered else see resText value and error_code value
#mobile  -> Customer Mobile Number

*/

Add Beneficiary

http://api.rechapi.com/moneyTransfer/addBeneficiary.php?format=#format&token=#token&&customerMobile=#customerMobile&beneficiaryName=#beneficiaryName&beneficiaryMobileNumber=#beneficiaryMobileNumber&beneficiaryAccountNumber=#beneficiaryAccountNumber&ifscCode=#ifscCode

/*

#customerMobile -> Registered customer mobile number
#beneficiaryName -> Beneficiary bank account name
#beneficiaryMobileNumber -> Beneficiary bank account mobile number
#beneficiaryAccountNumber -> Beneficiary bank account number
#ifscCode -> Bank ifsc code / Neft code

*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#mobile</mobile>
	<resText>#resText</resText>
	<beneficiaryId>#beneficiaryId</beneficiaryId>
</data>
  

//Output json

{"data":{"error_code":#error_code,"mobile":"#mobile","resText":"#resText","beneficiaryId":#beneficiaryId}}


/*
#error_code -> If 200 means beneficiary registered and otp has been sent to customer mobile number else see resText value and error_code value
#beneficiaryId  -> Beneficiary Id , This will require incase of fund transfer , Beneficiary Verification and Delete Beneficiary

*/

Beneficiary Verify

http://api.rechapi.com/moneyTransfer/beneficiaryVerifiy.php?format=#format&token=#token&&customerMobile=#customerMobile&otp=#otp&beneficiaryId=#beneficiaryId

/*

#customerMobile -> Registered customer mobile number
#otp -> Otp send to customer mobile number


*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#mobile</mobile>
	<resText>#resText</resText>
	
</data>
  

//Output json

{"data":{"error_code":#error_code,"mobile":"#mobile","resText":"#resText"}}


/*
#error_code -> If 200 means beneficiary successfully verified else see resText value and error_code value

*/

Transfer Money

http://api.rechapi.com/moneyTransfer/sendMoney.php?format=#format&token=#token&&customerMobile=#customerMobile&amount=#amount&beneficiaryId=#beneficiaryId&urid=#urid

/*

#amount -> Amount to send money
#urid -> Your unique tracking id


*/


//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<status>#status</status>
	<error_code>#error_code</error_code>
	<orderId>#orderId</orderId>
	<mobile>#mobile</mobile>
	<beneficiaryName>#beneficiaryName</beneficiaryName>
	<beneficiaryAccountNumber>#beneficiaryAccountNumber</beneficiaryAccountNumber>
	<resText>#resText</resText>
	<beneficiaryId>#beneficiaryId</beneficiaryId>
	<creditUsed>#creditUsed</creditUsed>
	
</data>
  

//Output json

{"data":{"status":"#status","error_code":#error_code,"mobile":"#mobile","resText":"#resText","beneficiaryId":"#beneficiaryId","beneficiaryName":"#beneficiaryName","beneficiaryAccountNumber":"#beneficiaryAccountNumber","orderId":#orderId,"creditUsed":"#creditUsed"}}



/*
#error_code -> 200 -> Fund successfully transferred , 201 -> Fund transfer request accepted, Other than 201 , 200 see resText value for error
#status -> SUCCESS/PENDING/FAILED/CANCELLED/0 , If 0 means its failed , CANCELLED Means fund deducted and balance transferred to user wallet balance.
#orderId -> Rechapi order id
#creditUsed -> Credit used from your account
*/

Delete Beneficiary

http://api.rechapi.com/moneyTransfer/deleteBeneficiary.php?format=#format&token=#token&&customerMobile=#customerMobile&beneficiaryId=#beneficiaryId




//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#customerMobile</mobile>
	<resText>#resText</resText>
	<beneficiaryId>#beneficiaryId</beneficiaryId>
	
</data>
  

//Output json

{"data":{"error_code":#error_code,"mobile":"#customerMobile","resText":"#resText","beneficiaryId":"#beneficiaryId"}}



/*
#error_code -> if 200 then request accepted and otp sent to customer mobile number else see resText value
*/

Delete Beneficiary Otp

http://api.rechapi.com/moneyTransfer/deleteBeneficiaryVerifiy.php?format=#format&token=#token&&customerMobile=#customerMobile&beneficiaryId=#beneficiaryId&otp=#otp




//Output xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<error_code>#error_code</error_code>
	<mobile>#customerMobile</mobile>
	<resText>#resText</resText>
	
	
</data>
  

//Output json

{"data":{"error_code":#error_code,"mobile":"#customerMobile","resText":"#resText"}}



/*
#error_code -> if 200 it means beneficiary successfully deleted else see resText value
*/

SignUp

Recharge API

Recharge Status Api

Recharge Dispute Api

Recharge Balance Api

Mobile Details Finder

Recharge Plan Finder

Api Recharge Sample Code

Api Recharge Status Sample Code

Operator Code

Circle Code

Error Code

Customer Details Api

Customer Registration Api

Customer Otp Verify

Add Beneficiary

Beneficiary Verify

Transfer Money

Delete Beneficiary

Delete Beneficiary Otp

About Us

Importanat Links

Contact Us

SignUp

Recharge API

Recharge Status Api

Recharge Dispute Api

Recharge Balance Api

Mobile Details Finder

Recharge Plan Finder

Api Recharge Sample Code

Api Recharge Status Sample Code

Operator Code

Circle Code

Error Code

Customer Details Api

Customer Registration Api

Customer Otp Verify

Add Beneficiary

Beneficiary Verify

Transfer Money

Delete Beneficiary

Delete Beneficiary Otp

About Us

Importanat Links

Social Page

Contact Us