最近正在做一个小项目,其中一个要实现手机话费充值功能。我在网上搜罗了很久,最终找了聚合数据上的那个手机话费充值API,下面就分享一下,希望对需求的朋友有所帮助。
聚合数据是一个API聚合平台,提供了超多各类API,它的手机话费充值接口也是不错的。
1.手机话费充值API
1.1检测手机号码是否能充值
接口地址:http://op.juhe.cn/ofpay/mobile/telcheck
支持格式:json
请求方式:httppost/get
请求示例:http://op.juhe.cn/ofpay/mobile/telcheck?cardnum=100&phoneno=13429667914&key=您申请的KEY
接口备注:检测手机号码及金额是否能充值
请求参数说明:
类型 |
必填 |
说明 |
|
phoneno |
string |
是 |
手机号码 |
cardnum |
string |
是 |
充值金额,目前可选:10、20、30、50、100、300 |
key |
string |
是 |
应用APPKEY(应用详细页查询) |
返回参数说明:
类型 |
说明 |
|
error_code |
int |
返回码 |
reason |
string |
返回说明 |
result |
string |
返回结果集 |
JSON返回示例:
{ "reason": "允许充值的手机号码及金额","result": null,"error_code": 0 }
1.2根据手机号和面值查询商
接口地址:http://op.juhe.cn/ofpay/mobile/telquery
支持格式:json
请求方式:httpget/post
请求示例:http://op.juhe.cn/ofpay/mobile/telquery?cardnum=30&phoneno=18913515635&key=您申请的KEY
接口备注:根据手机号和面值查询商品信息
请求参数说明:
类型 |
必填 |
说明 |
|
phoneno |
string |
是 |
手机号码 |
cardnum |
string |
是 |
充值金额,目前可选:10、20、30、50、100、300 |
key |
string |
是 |
应用APPKEY(应用详细页查询) |
返回参数说明:
类型 |
说明 |
|
error_code |
int |
返回码 |
reason |
string |
返回说明 |
result |
string |
返回结果集 |
JSON返回示例:
{ "reason":"成功","result":{ "cardid":"191404",/*卡类ID*/ "cardname":"江苏电信话费100元直充",/*卡类名称*/ "inprice":98.4,/*购买价格*/ "game_area":"江苏苏州电信"/*手机号码归属地*/ },"error_code":0 }
1.3手机直充接口
接口地址:http://op.juhe.cn/ofpay/mobile/onlineorder
支持格式:json
请求方式:httpget/post
请求示例:http://op.juhe.cn/ofpay/mobile/onlineorder?key=KEY&phoneno=18913513535&cardnum=100&orderid=2014111111113&sign=fb1ed32a9540c24b03cc0c06aabbb642
接口备注:依据用户提供的请求为指定手机直接充值,***如果充值过程中,遇到http网络状态异常或错误码返回系统异常100014,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免照成不必要的损失!!!
请求参数说明:
类型 |
必填 |
说明 |
|
phoneno |
string |
是 |
手机号码 |
cardnum |
string |
是 |
充值金额,目前可选:10、20、30、50、100、300 |
orderid |
string |
是 |
商家订单号,8-32位字母数字组合,由您自己生成 |
key |
string |
是 |
应用APPKEY(应用详细页查询) |
sign |
string |
是 |
校验值,md5(OpenID+key+phoneno+cardnum+orderid),OpenID在个人中心查询 |
返回参数说明:
类型 |
说明 |
|
error_code |
int |
返回码 |
reason |
string |
返回说明 |
result |
string |
返回结果集 |
JSON返回示例:
{ "reason":"订单提交成功,等待充值","result":{ "cardid":"1900212",/*充值的卡类ID*/ "cardnum":"1",/*数量*/ "ordercash":49.25,/*进货价格*/ "cardname":"江苏电信话费50元直充",/*充值名称*/ "sporder_id":"20141120174602882",/*聚合订单号*/ "uorderid":"2014123115121",/*商户自定的订单号*/ "game_userid":"18913515122",/*充值的手机号码*/ "game_state":"0"/*充值状态:0充值中1成功9撤销,刚提交都返回0*/ },"error_code":0 }
1.4订单状态查询
接口地址:http://op.juhe.cn/ofpay/mobile/ordersta
支持格式:json
请求方式:httpget/post
请求示例:http://op.juhe.cn/ofpay/mobile/ordersta?key=&orderid=a112244411a
接口备注:查询订单的最新状态,请确认订单成功提交后,再查询哦~
请求参数说明:
类型 |
必填 |
说明 |
|
orderid |
string |
是 |
商家订单号,8-32位字母数字组合,请填写已经成功提交的订单号 |
key |
string |
是 |
应用APPKEY(应用详细页查询) |
返回参数说明:
类型 |
说明 |
|
error_code |
int |
返回码 |
reason |
string |
返回说明 |
result |
string |
返回结果集 |
JSON返回示例:
{ "reason":"查询成功","result":{ "uordercash":"5.000",/*订单扣除金额*/ "sporder_id":"20150511163237508",/*聚合订单号*/ "game_state":"1"/*状态1:成功9:失败0:充值中*/ },"error_code":0 }
1.5状态回调配置
充值接口测试完毕,需联系在线客服进行回调配置。
演示:
最后,附《手机话费充值》资费说明:
卡种 |
面额 |
价格 |
10元话费直冲 |
¥10.00 |
¥9.80~¥10.2 |
20元话费直冲 |
¥20.00 |
¥19.60~¥20.1 |
30元话费直冲 |
¥30.00 |
¥29.54~¥30 |
50元话费直冲 |
¥50.00 |
¥49.25~¥50 |
100元话费直冲 |
¥100.00 |
¥99.4~¥100 |
300元话费直冲 |
¥300.00 |
¥295.5~¥296.4 |