申请数据

>话费接口简介 / Synopsis

为中小型企业、商家活动、自媒体推广提供一站式话费营销服务,通过活动销售、赠送、积分兑换等方式营销话费,为企业客户提供安全、经济、专业的服务,从而帮助企业、商家拓展新客户并提高现有客户活跃度,提高客户对企业服务的满意度。

>话费接口优势 / Advantage

直连中国移动、中国联通、中国电信三大运营商,多种充值方式,平均1分钟之内到账。 5分钟到帐,如遇高峰期,会有适当延时。

>话费接口活动场景 / Scenarios

>话费接口案例 / Example

用户通过点击“话费流量” ,即可选择需要的面值享受充值旅程。

查看示例大图>>

用户通过输入自己的手机号码,选择需要充值的金额,提交支付即可完成充值。

查看示例大图>>

>话费接口种类 / Type

1元 2元 5元 10元 20元 30元
50元 100元 200元 300元 500元
1元 2元 5元 10元 20元 30元
50元 100元 200元 300元 500元
1元 2元 5元 10元 20元 30元
50元 100元 200元 300元 500元
  • 话费接口简介
  • 话费接口优势
  • 话费接口活动场景
  • 话费接口案例
  • 话费接口种类
  • 检测手机号码是否能充值
  • 根据手机号和面值查询商品
  • 手机直充接口
  • 订单状态查询
  • 状态回调配置
  • 错误码参照
  • 示例代码
  • 其他相关
接口地址:http://op.juhe.cn/ofpay/mobile/telcheck
支持格式:json
请求方式:http post/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
}
接口地址:http://op.juhe.cn/ofpay/mobile/telquery
支持格式:json
请求方式:http get/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
}
接口地址:http://op.juhe.cn/ofpay/mobile/onlineorder
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/mobile/onlineorder?key=KEY&phoneno=18913513535&cardnum=100&orderid=2014111111113&sign=fb1ed32a9540c24b03cc0c06aabbb642
接口备注: 正式使用后建议个人中心绑定IP白名单。 ***如果充值过程中,遇到http网络状态异常或错误码返回系统异常10014,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!
请求参数说明:
名称 类型 必填 说明
  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
}
接口地址:http://op.juhe.cn/ofpay/mobile/ordersta
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/mobile/ordersta?key=&orderid=a112244411a
接口备注: 查询订单的最新状态,请确认订单成功提交后,再查询哦,本接口暂只支持查询近60天订单
请求参数说明:
名称 类型 必填 说明
  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
}
接口地址:充值接口测试完毕,联系在线客服进行回调配置,格式参考:http://code.juhe.cn/docs/detail/id/1565
支持格式:
请求方式:
请求示例:
请求参数说明:
名称 类型 必填 说明
 
返回参数说明:
名称 类型 说明
 
服务级错误码参照(error_code):
  错误码 说明
  208501 不允许充值的手机号码及金额
  208502 请求手机号和面值查询商品信息失败,请重试
  208503 运营商地区维护,暂不能充值
  208504 请求手机号和面值查询商品信息错误,具体请参考reasoon
  208505 错误的手机号码
  208506 错误的充值金额
  208507 充值失败,具体请参考reason
  208508 请求充值失败,请重试
  208509 错误的订单号
  208510 请求订单状态失败,请重试
  208513 查询订单失败,具体参照reason说明
  208514 不合规范的订单号(8-32位)
  208515 校验值sign错误
  208516 重复的订单号
  208517 当前账户可用余额不足
系统级错误码参照:
  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常 (调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121
错误码格式说明(示例:200201):
  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
完整教学代码示例:
  语言 标题 提供者 时间
  PHP 话费充值接口示例代码 JoneDwyane 2015-06-16 17:11:38
  C# 手机话费充值接口调用示例 JoneDwyane 2015-09-15 13:34:26
  Go 手机话费充值接口调用示例 JoneDwyane 2015-09-15 19:17:51
  JAVA 手机话费充值-java示例 健哥 2016-04-20 17:21:11
  C# 手机话费充值示例 test 2015-07-17 11:40:48
常见问题:
  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1495160733
其他相关内容
  内容 详细
  技术支持: info@juhe.cn
  联系电话: 0512-62391880
  在线客服QQ: 800076065