Version 2.1. Recharge & Bill API Setup Info

Transcription

1 Version 2.1 Recharge & Bill API Setup Info

2 INDEX Topic Page No. Introduction 3 How it works? 4 How to buy API? 5 Mobile & DTH HTTP API URL 6 Post-paid & Landline HTTP API URL 8 Electricity, Gas, Insurance HTTP API URL 10 Check transaction status 11 Report transaction (Dispute) 12 Check API balance 13

3 INTRODUCTION We are the only one company in telecom services providing http api services in India with maximum margin at low pricing since Developer, webmaster and all other freelancers can use our recharge & bill api instantly and easily. We provide very good margin on every recharge processed with us. Its not complex like other api vendors services. We provide variable margin or commission on every recharge of operators in India.

4 HOW IT WORKS? ü Create free account on joloapi.com ü Integrate API on your web application ü Add Balance in your joloapi account ü You are ready to serve your customers ü Choose your api plan as per your budget

5 HOW TO BUY API? ü Create free account on joloapi.com ü Pay api annual fee and us your payment details along with your joloapi username. Activation will be done in few hours ü For any queries, contact us on ü You can also create billing/support ticket from your joloapi account

6 HTTP API URL ( for ALL Mobile & DTH recharge service) ourapikey&operator=operatorcode&service=mobilenumber&amount=amount &orderid=youruniqueorderid&type=text URL Parameters Description Mode Set mode = 1 for live & mode = 0 for test Userid Your username key Your api key Operator Operator code (see appendix A) Service 10 digit mobile number or DTH subscriber id Amount Denomination ranging from 10 to 99,000 Order ID Your website generated Unique order ID Type text or json response

7 If recharge is SUCCESS: API RESPONSE Our order id, status, operator, service, amount, your website orderid, errorcode, operatorid, balance, margin, time If recharge is FAILED: Status, errorcode URL Response Data Description Our Order ID Our system generated unique order ID Status Status of transaction (SUCCESS/FAILED/NO RESPONSE) Operator Operator code Service 10 digit mobile number or DTH subscriber id Amount Denomination ranging from 10 to 99,000 Order ID Your website generated Unique order ID Error code Our system generated error code (see appendix B) Operator ID Operator system generated reference ID Other details Balance, margin, time

8 HTTP API URL ( for ALL POSTPAID & LANDLINE bill service) erator=operatorcode&service=mobilenumber&amount=amount&std=stdcode&ca=acco untnumber&other=xxx&orderid=youruniqueorderid&type=text URL Parameters Mode Userid key Description Set mode = 1 for live & mode = 0 for test Your username Your api key Operator Operator code (see appendix A) Service 10 digit postpaid number or landline number without std code Amount Denomination ranging from 10 to 99,000 Order ID Std code Ca other Your website generated Unique order ID Std code for landline number (not required for postpaid) Customer account number for landline number (not required for postpaid) pass other=1 if bsnl landline is corporate type else keep blank (not required for postpaid)

9 If recharge is SUCCESS: API RESPONSE Our order id, status, operator, service, amount, your website orderid, errorcode, operatorid, balance, margin, time If recharge is FAILED: Status, errorcode Output data Format is exactly similar to mobile/dth api response

10 HTTP API URL ( for ALL electricity, gas, insurance bill service) API information for Utility services like electricity, gas and insurance are only available for paid users only. Kindly contact us for same after purchase.

11 API URL (checking status of transaction) rvicetype=1&txn=ourorderid&type=text URL Parameters User ID Key Servicetype TXN Description Your username, not appkey Your api key 1=mobile, 2=dth, 3=datacard, 4=postpaid, 5=landline, 6=electriciy, 7=gas, 8=insurance Our order ID If you want to check recharge transaction status using your website order id then use below given link: &servicetype=1&txn=yourwebsiteorderid&type=text

12 API URL (reporting any transaction) pe=1&txn=ourorderid&type=text URL Parameters User ID Key Servicetype TXN Description Your username, not appkey Your api key 1=mobile, 2=dth, 3=datacard, 4=postpaid, 5=landline, 6=electriciy, 7=gas, 8=insurance Our order ID If you want to report transaction using your website order id then use below given link: dispute_client.php?userid=username&key=apikey&servicetype=1&txn=yourweb siteorderid&type=text

13 API URL (checking your API balance) URL Parameters Userid Key Description Your username Your api key generated

14 API URL (Operator synchronize service status check) Description To make it simple, just follow these steps to setup S.S.S on your web server: 1. First create a page on your website. Let say you have created servicestatus.php in your home directory and it can be access here: 2. Now just enter this url in joloapi S.S.S box and click on "Set it!" button. 3. Whenever there is change in status of any operator service in our server, the same will be posted on your given url automatically and instantly. In this way you can update your database with real time service status changes and let you keep your customers informed of uptime/downtime.

15 Version 2.0 Thank you! Ask: Website: