最近正在做一个小项目，其中一个要实现手机话费充值功能。我在网上搜罗了很久，最终找了聚合数据上的那个手机话费充值API，下面就分享一下，希望对需求的朋友有所帮助。
聚合数据是一个API聚合平台，提供了超多各类API，它的手机话费充值接口也是不错的。
1.手机话费充值API
1.1检测手机号码是否能充值
支持格式：json
请求方式：http post/get
接口备注：检测手机号码及金额是否能充值
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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根据手机号和面值查询商
支持格式：json
请求方式：http get/post
接口备注：根据手机号和面值查询商品信息
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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手机直充接口
支持格式：json
请求方式：http get/post
接口备注：依据用户提供的请求为指定手机直接充值，***如果充值过程中，遇到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订单状态查询
支持格式：json
请求方式：http get/post
接口备注：查询订单的最新状态，请确认订单成功提交后，再查询哦～
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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状态回调配置
充值接口测试完毕，需联系在线客服进行回调配置。
演示：
