Jolo Recharge Api Docs 1x3226

TOPIC

PAGE

INTRODUCTION

3

RECHARE API PLANS & PRICING

4

HOW TO BUY RECHARGE API

5

RECHARGE API LINK & EXAMPLE

6-15

RECHARGE API ERROR CODES

16-19

LIST OF OPERATORS & CODES

20-22

LIST OF CIRCLE CODES FOR BACKUP ROUTE

23

In this PDF, you will get all information related to our mobile, dth, datacard api in detail. This guide will help you to integrate our api in your website easily and in quick time. If you want to test before going live always set mode equal to 1 in our api http url. If you have no time to integrate our api in your website then don’t worry we provide free for installation or we will manually setup api in your website free of cost. Just drop a request to our desk anytime. We are always 24x7. For any help, please write to our desk: [email protected] We will assure you to deliver response to your query within 24 hours or max 36 hours.

PLAN NAME

PRICING*

SERVICES

STARTER

Rs.1,500

ALL SERVICES

SUPER VALUE

Rs.8,500

ALL SERVICES + DISTRIBUTORSHIP

DELUXE

Rs.14,500

ALL SERVICES + DISTRIBUTORSHIP

SUPER DELUXE

Rs.20,500

ALL SERVICES + DISTRIBUTORSHIP

SUPER MAX

Rs.30,500

ALL SERVICES + DISTRIBUTORSHIP

+ FREE ADD ON (OPTIONAL LAPU) + BACKUP ROUTE

FREE

AIRTEL, IDEA, VODAFONE, DOCOMO GSM/CDMA ----ALL OPERATORS

* Pricing mentioned are annual basis and are non-refundable charges

1. CREATE FREE ON OUR WEBSITE WWW.JOLO.IN 2. PAY API ANNUAL CHARGES AS PER PLAN CHOSEN BY YOU. AFTER PAYMENT, SEND API ACTIVATION REQUEST TO OUR SALES TEAM WITH YOUR PAYMENT DETAILS AND NAME. WE WILL ACTIVATE API ON YOUR WITHIN 1 HOUR.

3. YOU CAN PAY USING NET BANKING/ CASH DEPOSIT/ ATM FUND TRANFER/ AIRTEL MONEY/ CHEQUE/ DD. FOR ANY PURCHASE RELATED QUERY, OUR SALES TEAM: [email protected]

You can send your recharge request to our server using following HTTP URL:

http://jolo.in/api/recharge.php?mode=1&key=yourappkey& operator=operatorcode&service=servicenumber&amount=amount&or derid=yourwebsiteorderid Explanation: Mode: If you want to test our HTTP API then set mode=0. If you want to go live then set mode=1 Key: Put your JOLO appkey. You need to generate it first in jolo.in Operator : Put the operator code as given in this guide at end Service No.: Put either mobile number, dth subscriber no. or data card no. Amount: Put the value for amount in numeric only. Order Id: You can push your own website generated orderid to track txn. Generate your application key from here: http://www.jolo.in/member//myappkey.php API Response:

Jolo order id,status,operator code,service number,amount,your website orderid

Suppose your key is cking79 and you want to recharge a mobile number 9999999999 with amount 100 and operator is Vodafone then HTTP URL will be:

http://jolo.in/api/recharge.php?mode=1&key=cking79&operator=VF& service=9999999999&amount=100&orderid=1111111111 For DTH, put dth subscriber id in place of service number. For Datacard and Postpaid, mobile number in place of service number. Note: All operator codes must be in capital letters. API Response:

287571789903,SUCCESS,VF,9999999999,100,1111111111 287571789903 is random jolo generated order id, SUCCESS /FAILED/PENDING are status of recharge, VF is the operator code for vodafone which is return as it is, 100 is the amount which is return as it is, 1111111111 is your website generated order id which is return as it is.

You can send your recharge request to our server using following HTTP URL if you want operator original transaction id:

http://jolo.in/api/recharge_advance.php?mode=1&key=yourappkey& operator=operatorcode&service=servicenumber&amount=amount&or derid=yourwebsiteorderid API Response:

Jolo order id,status,operator code,service number,amount,your website orderid,errorcode,operatorid Everything same as in link 1 except these: 1. Error code: It’s a error code generator by jolo system. You can find more details about this at end of this guide. 2. OperatorID: It’s a original operator ID generated by operator itself. In 99% cases if operator id is generated, recharge is always success.

You can send your check balance request to our server using following HTTP URL:

http://jolo.in/api/rechargebalance.php?key=appkey API Response:

Current balance Api response will be numeric value like 100, 1000, 15000, etc

You can send your check recharge history request to our server using following HTTP URL:

http://jolo.in/api/rechargereports.php?key=cking79&fromdate=YYYYMM-DD&todate=YYYY-MM-DD API Response: Api response will be html table with all transaction details If you want to check last recharge via api link then run below url:

http://jolo.in/api/rechargelast.php?key=cking79&fromdate=YYYY-MMDD&todate=YYYY-MM-DD API Response:

Service number,amount,status,datetime

If recharge is not done then you can request for refund to our server using following HTTP URL:

http://jolo.in/api/dispute.php?key=cking79&txn=joloorderid Where cking79 is assumed as your application key and joloorderid is the orderid generated by jolo system during recharge API Response:

DIS-SUCCESS

Your dispute request accepted by our server

FAILED,0

Your dispute request is declined because recharge status is already failed and your balance is not deducted

Your dispute request is declined because current recharge status is pending and this transaction will auto-update within 24 hours max UnderDispute,0 Your dispute request is declined because recharge status is already Under dispute. You need to wait for result

PENDING,0

Other responses: INVALID-TRANSACTION-ID, INVALID-IP-ADDRESS-ACCESS, INVALID-APPKEY

You can send your recharge status check request to our server using following HTTP URL:

http://jolo.in/api/rechargestatus.php?id=king&txn=joloorderid API Response:

Transaction ID,Status,Operator,Service,Amount,OperatorID You can run this HTTP URL using CRON on your web server in order to check updated status of any recharge done. We suggest you to run cron in every 15 minutes, not before it. If you do not want to use cron then skip this page and view next page for alternate solution. You can also push your website generated txn id in place of jolo txnid. Just change rechargestatus.php to rechargestatus_client.php

In case our default api link is failing to recharge then you can integrate our backup route api link in any way you like:

http://jolo.in/api/backuprecharge.php?mode=1&key=yourappkey&operat or=operatorcode&service=servicenumber&amount=amount&circle=circlec ode API Response:

Transaction ID,Status,Operator,Service,Amount New in this backup route api: - Additional parameter of "circle" is must required otherwise it will give error 888. - There is change in operator code for bsnl and mtnl - T24 and virgin operator newly added only in backup route -There is different margin structure for all operators under this route You will get flat margin under backup route and its same for all api plans: http://www.jolo.in/member//backuproute_margin.php

CODE

MOBILE

BS1

BSNL Topup

BS2

BSNL STV

BS3

BSNL Recharge

BS4

BSNL 3G Recharge

MT1

MTNL Topup

MT2

MTNL STV

MT3

MTNL Recharge

T24

T24

T24S

T24 Special

VRC

Virgin CDMA

VRG

Virgin GSM

……..

REST OF CODES SAME AS DEFAULT ROUTE

Circle codes are given at end of this guide.

You can synchronize your website database with our server easily for all transaction status change in real time. Whenever there will be any change in status of recharge at our end then same will be push to your website database or server. For this you just have to give us a url on which you like to get real time data. It can be like: http://yourwebsite.com/anypage.php Step 1: create file anypage.php on your server and do some coding to collect following parameters and store in database: 1. status = status of transaction 2. operatortxnid = original operator id 3. joloorderid = jolo order id 4. orderid = your website order id

Step 2: After creating page, you have to enter the url of that page in JOLO API : http://www.jolo.in/member//api-auto-update.php Important: Please do not save the url until your page is ready to use. That’s it!

FAILED(2)

INVALID APPKEY

FAILED(13)

FAILED(3)

SYSTEM UNDER MAINTENANCE

INVALID JOLO API NAME/

FAILED(14)

FAILED(4)

EMPTY JOLO API NAME

API ACCESS NOT ACTIVE ON YOUR

FAILED(15)

FAILED(5)

EMPTY JOLO API

YOUR BALANCE LESS THAN 10

FAILED(6)

EMPTY OPERATOR CODE

FAILED(16)

INVALID SERVICE NUMBER

FAILED(7)

EMPTY SERVICE NUMBER

FAILED(17)

YOUR INSUFFICIENT BALANCE

FAILED(8)

EMPTY AMOUNT VALUE

FAILED(18)

INVALID AMOUNT VALUE

FAILED(9)

JOLO SERVER ERROR2

FAILED(19)

INVALID OPERATOR CODE

FAILED(10)

INVALID JOLO API NAME

FAILED(20)

FAILED(11)

JOLO SERVER ERROR3

AMOUNT MUST BE ATLEAST 10 FOR MOBLE RECHARGE

FAILED(12)

INVALID JOLO API

FAILED(21)

AMOUNT MUST BE ATLEAST 100 FOR DTH RECHARGE

FAILED(22)

AMOUNT MUST BE ATLEAST 10 FOR DATACARD RECHARGE

FAILED(116)

Tech Error

FAILED(117)

Recharge load issue

FAILED(23)

INVALID MOBILE NUMBER

FAILED(119)

FAILED(24)

INVALID DTH SUBSCRIBER ID

Vendor Code is Currently Unavailable

FAILED(122)

Invalid Circle Code

FAILED(30)

AMOUNT MUST BE ATLEAST 10 FOR POSTPAID

FAILED(128)

Transaction Internal Error

FAILED(130)

DUPLICATE RECHARGE REQUEST

FAILED(131)

Invalid Mobile No

FAILED(301)

UNEXPECTED ERROR OCCURRED or Required parameters missing

FAILED(201)

Required parameters missing.

FAILED(202)

Required parameters missing.

FAILED(207)

Amount must be in the range 19999.

FAILED(208)

Amount must be in the range

FAILED(211)

Invalid DTH/D2H subscriber id

FAILED(302)

Required parameters missing

FAILED(305)

INVALID MOBILE NUMBER

FAILED(320)

Try After Some Time

FAILED(306)

Invalid Operator Code

FAILED(350)

Slow Network Error

FAILED(307)

Low Balance

FAILED(351)

Service Failed

FAILED(308)

Invalid Amount

FAILED(352)

Service Downtime

FAILED(309)

JOLO TECH ERROR

FAILED(360)

Unknown Error

FAILED(310)

Invalid ID

FAILED(600)

FAILED

FAILED(551)

FAILED(111)

Service not available

Service Failed/LastRequest Is In Process

FAILED(113)

Currently this service is Unavailable

FAILED(221)

PENDING Time Out

FAILED(230)

FAILED(222)

PENDING Transaction Under Process

Duplicate Transaction Error from Operator Side

FAILED(231)

FAILED(223)

PENDING Transaction Status is Unknown

General Error from Operator Side

FAILED(232)

FAILED(225)

Customer exceeded daily limit/attempts.

Internal Error from Operator Side

FAILED(233)

FAILED(226)

Amount/Denomination barred. Please Operator.

Technical Error from Operator Side

FAILED(234)

FAILED(227)

Mobile Number/Subscriber ID barred. Please Operator.

Network Error from Operator Side

FAILED(235)

Operator Downtime

FAILED(236)

General Error

FAILED(955)

Invalid Ip address acccess

FAILED(228)

Invalid Amount/Denomination.

FAILED(229)

Invalid Mobile Number/Customer ID/VC Number/Subscriber ID.

Note: If you are getting any other response error then please us immediately.

CODE

MOBILE

CODE

MOBILE

AT

AIRTEL

UNS

UNINOR SPECIAL

BS

BSNL

LM

LOOP MOBILE

AL

AIRCEL

RL

Reliance CDMA

BSS

BSNL SPECIAL

RG

Reliance GSM

ID

IDEA

VD

Videocon

VF

VODAFONE

VDS

Videocon Special

TD

TATA DOCOMO GSM

MTD

MTNL DL Topup

TDS

TATA DOCOMO GSM SPECIAL

MTDS

MTNL DL Special

TI

TATA DOCOMO CDMA/TATA INDICOM

MTM

MTNL MUMBAI

MTMS

MTNL MUMBAI Special

TW

TATA WALKY

MS

MTS

UN

UNINOR

CODE

DATA CARD

RL1

Reliance NetConnect 1X

RL2

Reliance NetConnect+

RL3

Reliance NetConnect 3G

CODE

DTH

TI1

Tata Photon Whiz

VT

Videocon DTH

TI2

Tata Photon+

SD

Sun DTH

MS2

MTS MBrowse

AD

Airtel DTH

MS1

MTS Mblaze

TS

Tata Sky DTH

MTDD

MTNL Delhi

DT

Dish TV

MTMD

MTNL Mumbai

BT

Big TV

BSD

BSNL

VFD

Vodafone 3G

ALD

Aircel Pocket Internet

CODE

POSTPAID BILLS

APOS

Airtel Postpaid

IPOS

Idea Postpaid

VPOS

Vodafone Postpaid

BPOS

BSNL Postpaid

RGPOS

Reliance GSM Postpaid

ROS

Reliance CDMA Postpaid

DGPOS

Tata Docomo GSM Postpaid

DOS

Tata Docomo CDMA Postpaid

LPOS

Loop Postpaid

CODE

CIRCLE

CODE

CIRCLE

13

ANDHRA PRADESH

16

MADHYA PRADESH

24

ASSAM

4

MAHARASHTRA

17

BIHAR

3

MUMBAI

27

CHATTISGARH

26

NORTH EAST

7

CHENNAI

23

ORRISA

5

DELHI

1

PUNJAB

12

GUJARAT

18

RAJASTHAN

20

HARYANA

8

TAMILNADU

21

HIMACHAL PRADESH

10

UTTAR PRADESH EAST

25

JAMMU AND KASHMIR

11

UTTAR PRADESH WEST

22

JHARKHAND

2

WEST BENGAL

9

KARNATAKA

14

KERALA

6

KOLKATA

ELEANOR TRAVEL SOLUTIONS & SR GROUP LLC. J.V Website: www.jolo.in Email: [email protected] Customer Care: 0120-4123873 / 9650460949

DELHI ZONE: S.R.GROUP 136, First Floor, Vardhman Diamond Plaza, Desh Bandu Gupta Road, Near DDA Complex, Motia Khan, Opp. Paharganj Police Station, New Delhi - 110055.