手机话费充值API接口_免费数据接口

1、话费充值

接口地址：https://api.jisuapi.com/mobilerecharge/recharge

返回格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/mobilerecharge/recharge?appkey=yourappkey&mobile=15158825888&amount=100&outorderno=&sign=asdfsadfccsddwwww

请求参数：

参数名称	类型	必填	说明
mobile	string	是	要充值的手机号
amount	string	是	充值金额10,20,30,50,100,200,300,500面值可选
outorderno	string	是	商家订单号
sign	string	是	签名MD5加密 md5(amount+mobile+outorderno+appsecret)

返回参数：

参数名称	类型	说明
mobile	string	要充值的手机号
amount	string	充值金额
outorderno	string	商家订单号
orderno	string	订单号
totalfee	string	总金额重试订单金额略高一点，具体总金额以异步通知和订单详情为准
rechargestatus	int	充值状态 0充值中 1充值成功 2充值失败即时返回0，状态信息请从订单详情接口获取

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "mobile": "15158825888",
        "amount": "100",
        "outorderno": "",
        "orderno": "201604220431278398036",
		"totalfee": "99.8",
		"rechargestatus": "0"
    }
}

2、查询话费订单列表

接口地址：https://api.jisuapi.com/mobilerecharge/orderlist

返回格式：JSON

请求方式：GET

请求示例：https://api.jisuapi.com/mobilerecharge/orderlist?appkey=yourappkey&pagenum=1&pagesize=20

请求参数：

参数名称	类型	必填	说明
pagenum	int	是	当前页默认1
pagesize	int	是	每页数量默认20 最大40

返回参数：

参数名称	类型	说明
orderno	string	订单号
outorderno	string	商家订单号
account	string	充值账号
num	string	数量一般为1
status	int	状态一般为1，订单完成
rechargestatus	int	充值状态 0充值中 1充值成功 2充值失败即时返回0，状态信息请从订单详情接口获取
amount	string	面值
totalfee	string	总金额
addtime	int	订单时间
name	string	产品名称
areaid	int	区域ID 参考全国城市规划API
company	string	运营商

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "total": "3",
        "pagenum": "1",
        "pagesize": "20",
        "list": [
            {
                "orderno": "201604220714555074534",
                "outorderno": "",
                "account": "15158825888",
                "num": "1",
                "status": "1",
                "rechargestatus": "1",
                "amount": "10.00",
                "totalfee": "10.05",
                "addtime": "1461309295",
                "name": "浙江移动话费10元直充",
                "areaid": "30",
                "company": "移动",
            },
            {
                "orderno": "201604220634197256659",
                "outorderno": "",
                "account": "15158825888",
                "num": "1",
                "status": "1",
                "rechargestatus": "1",
                "amount": "10.00",
                "totalfee": "10.05",
                "addtime": "1461306859",
                "name": "浙江移动话费10元直充",
                "areaid": "30",
                "company": "移动",
            },
            {
                "orderno": "201604220431278398036",
                "outorderno": "",
                "account": "15158825888",
                "num": "1",
                "status": "1",
                "rechargestatus": "0",
                "amount": "10.00",
                "totalfee": "10.05",
                "addtime": "1461299487",
                "name": "浙江移动话费10元直充",
                "areaid": "30",
                "company": "移动",
            }
        ]
    }
}

3、查询话费订单详情

接口地址：https://api.jisuapi.com/mobilerecharge/orderdetail

返回格式：JSON

请求方式：GET

请求示例：https://api.jisuapi.com/mobilerecharge/orderdetail?appkey=yourappkey&orderno=201601241155888&outorderno=

请求参数：

参数名称	类型	必填	说明
orderno	string	是	订单号
outorderno	string	否	商家订单号和订单号任选其一如果商家订单号重复，只返回最新的一条详情

返回参数：

参数名称	类型	说明
orderno	string	订单号
outorderno	string	商家订单号
account	string	充值账号
num	int	数量一般为1
status	int	状态一般为1，订单完成
rechargestatus	string	充值状态 0充值中 1充值成功 2充值失败即时返回0，状态信息请从订单详情接口获取
amount	string	面值
totalfee	string	总金额
addtime	int	订单时间
name	string	产品名称
areaid	int	区域ID 参考全国城市规划API
company	string	运营商

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "orderno": "201604220714555074534",
        "outorderno": "",
        "account": "15158825888",
        "num": "1",
        "status": "1",
        "rechargestatus": "1",
        "amount": "10.00",
        "totalfee": "10.05",
        "addtime": "1461309295",
        "name": "浙江移动话费10元直充",
        "areaid": "30",
        "company": "移动",
    }
}

4、获取商品列表

接口地址：https://api.jisuapi.com/mobilerecharge/goods

返回格式：JSON

请求方式：GET

请求示例：https://api.jisuapi.com/mobilerecharge/goods?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
mobile	string	否	手机号

返回参数：

参数名称	类型	说明
name	string	产品名称
areaid	string	区域ID 参考全国城市规划API
company	string	运营商
price	string	单价
amount	string	面值

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "list": [            
            {
                "name": "云南电信话费30元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "30",
                "adviceprice": "31.00",
                "price": "29.62",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "云南电信话费50元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "50",
                "adviceprice": "50.00",
                "price": "49.45",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "云南电信话费100元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "100",
                "adviceprice": "100.00",
                "price": "98.79",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "云南电信话费200元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "200",
                "adviceprice": "200.00",
                "price": "197.48",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "云南电信话费300元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "300",
                "adviceprice": "300.00",
                "price": "296.22",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "云南电信话费500元直充",
                "areaid": "29",
                "company": "电信",
                "province": "云南",
                "amount": "500",
                "adviceprice": "500.00",
                "price": "493.71",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "电信",
                "province": "浙江",
                "amount": "1",
                "adviceprice": "",
                "price": "1.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "电信",
                "province": "浙江",
                "amount": "2",
                "adviceprice": "",
                "price": "2.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            }
        ]
    }
}

5、根据手机号获取商品

接口地址：https://api.jisuapi.com/mobilerecharge/query

返回格式：JSON

请求方式：GET

请求示例：https://api.jisuapi.com/mobilerecharge/query?appkey=yourappkey&mobile=15158825888&amount=100

请求参数：

参数名称	类型	必填	说明
mobile	string	是	手机号
amount	string	否	面值

返回参数：

参数名称	类型	说明
mobile	string	手机号
amount	string	面值
name	string	名称
areaid	string	区域ID
company	string	运营商
province	string	省份
price	string	价格

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "mobile": "15158825888",
        "amount": "0",
        "list": [
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "1",
                "adviceprice": "",
                "price": "1.10",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "2",
                "adviceprice": "",
                "price": "2.20",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "3",
                "adviceprice": "",
                "price": "3.30",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "4",
                "adviceprice": "",
                "price": "4.40",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费5元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "5",
                "adviceprice": "6.00",
                "price": "5.23",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "6",
                "adviceprice": "",
                "price": "6.60",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "7",
                "adviceprice": "",
                "price": "7.70",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "8",
                "adviceprice": "",
                "price": "8.80",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "9",
                "adviceprice": "",
                "price": "9.90",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费10元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "10",
                "adviceprice": "11.00",
                "price": "10.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费20元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "20",
                "adviceprice": "21.00",
                "price": "20.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费30元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "30",
                "adviceprice": "31.00",
                "price": "30.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费50元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "50",
                "adviceprice": "50.00",
                "price": "50.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费100元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "100",
                "adviceprice": "100.00",
                "price": "100.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费200元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "200",
                "adviceprice": "200.00",
                "price": "199.60",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费300元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "300",
                "adviceprice": "300.00",
                "price": "299.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            },
            {
                "name": "浙江移动话费500元直充",
                "areaid": "30",
                "company": "移动",
                "province": "浙江",
                "amount": "500",
                "adviceprice": "500.00",
                "price": "499.00",
                "limitprice": "",
                "sms": "",
                "rechargetime": ""
            }
        ]
    }
}

6、异步通知

接口地址：您设定的URL

返回格式：Array

请求方式：POST

请求示例：您设定的URL

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
outorderno	string	商家订单号
orderno	string	订单号
mobile	string	手机号
rechargestatus	int	充值状态 0充值中 1充值完成 2充值失败
amount	string	面值
totalfee	string	实际金额
sign	string	签名，签名规则参考代码

代号	说明
201	手机号为空
202	充值金额不正确
203	手机号不正确
204	签名为空
205	验签失败
206	账户余额不足
207	不支持的手机号
208	订单号为空
210	未知错误
211	商家订单号为空
212	商家订单号已存在
215	地区运营商维护
216	未找到该订单号

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用

名称	面值	价格
10元话费充值	10元	10.00 - 10.10元
20元话费充值	20元	19.96 - 20.20元
30元话费充值	30元	29.94 - 30.30元
50元话费充值	50元	49.90 - 50.50元
100元话费充值	100元	99.60 - 101.00元
200元话费充值	200元	199.59 - 202.00元
300元话费充值	300元	299.39 - 303.00元
500元话费充值	500元	498.98 - 505.00元

手机话费充值

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

API错误码

系统错误码