申请数据

>加油卡接口简介 / Synopsis

为上万家企业与电商平台提供中国石化与中国石油加油卡的在线快速充值接口,商户通过接口自由实现PC端、H5、APP等方式充值,让车主用户在互联网时代免去寻找排队充值的烦恼。

>加油卡接口优势 / Advantage

  • 充值速度业内领先,每单平均充值时间约20秒;
  • 多面值库存丰富,提供持续稳定的充值服务;
  • 客户服务质量佳,7X24小时客户服务;

>加油卡接口活动场景 / Scenarios

>加油卡接口案例 / Example

用户在京东商城充值中心输入并绑定自己常用的加油卡卡号,选择需要充值的金额,提交支付即可完成充值。

(充值后需到中石化服务网点击圈存)

查看示例大图>>

用户通过砸金蛋活动流量奖品, 完成指定任务领取流量奖品。

(充值后需到中石化服务网点击圈存)

查看示例大图>>

>加油卡接口种类 / Type

中石化固定面额充值
常规面额 100元 500元 1000元
非常规面额 50元 200元

PS:无发票,可提供官方充值凭证:使用范围为全国通用

  • 加油卡接口简介
  • 加油卡接口优势
  • 加油卡接口活动场景
  • 加油卡接口案例
  • 加油卡接口种类
  • 提交加油卡充值
  • 订单状态查询
  • 状态回调配置
  • 订单状态查询(sign校验)
  • 按日期查询订单(sign校验)
  • 错误码参照
  • 示例代码
  • 其他相关
接口地址:http://op.juhe.cn/ofpay/sinopec/onlineorder
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/sinopec/onlineorder
接口备注: 正式使用后建议个人中心绑定IP白名单。 加油卡完成网上充值后,需到所充值油卡当地加油站请工作人员进行激活(圈存)操作,否则充值金额将无法生效。发票等相关问题请联系客服。***如果充值过程中,遇到http网络状态异常或返回系统异常,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!
请求参数说明:
名称 类型 必填 说明
  proid int 产品id:
10000(中石化50元加油卡)
10001(中石化100元加油卡)
10002(中石化200元加油卡)
10003(中石化500元加油卡)
10004(中石化1000元加油卡)
10007(中石化任意金额充值) [暂不支持]
10008(中石油任意金额充值))
  cardnum string 充值数量(产品id为10007、10008时为具体充值金额(整数),其余产品id请传固定值1);注:中石油任意冲(产品id:10008)暂时只支持100\200\500\1000
  orderid string 商家订单号,8-32位字母数字组合
  game_userid string 加油卡卡号,中石化:以100011开头的卡号、中石油:以9开头的卡号
  gasCardTel string 持卡人手机号码
  gasCardName string 持卡人姓名
  chargeType int 加油卡类型 (1:中石化、2:中石油;默认为1)
  key string 应用APPKEY(应用详细页查询)
  sign string 校验值,md5(OpenID+key+proid+cardnum+game_userid+orderid),OpenID在个人中心查询,结果转为32位小写
返回参数说明:
名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
    "reason": "提交充值成功",
    "result": {
        "cardnum": "1", /*充值数量*/
        "ordercash": "95.5", /*进货价格*/
        "cardname": "全国加油卡", /*充值名称*/
        "sporder_id": "S20141125221812330", /*商家订单号*/
        "game_userid": "100011320000991****", /*加油卡卡号*/
        "game_state": "0", /*充值状态:0充值中 1成功 9撤销,刚提交成功的单子状态均为充值中*/
        "uorderid": "S2014111111115" /*商户自定的订单号*/
    },
    "error_code": 0
}
接口地址:http://op.juhe.cn/ofpay/sinopec/ordersta
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/sinopec/ordersta?key=&orderid=S2014111111115
接口备注: 根据用户的订单号查询状态,本接口暂只支持查询近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
支持格式:
请求方式:
请求示例:
请求参数说明:
名称 类型 必填 说明
 
返回参数说明:
名称 类型 说明
 
接口地址:http://op.juhe.cn/ofpay/sinopec/sordersta
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/sinopec/sordersta
接口备注: 签名校验版,根据用户的订单号查询状态,本接口暂只支持查询近60天订单,根据用户的订单号查询状态, 请务必确认订单已经成功提交后再查询,避免造成不必要的损失
请求参数说明:
名称 类型 必填 说明
  key string 应用APPKEY(应用详细页查询)
  orderid string 商家订单号,8-32位字母数字组合
  timestamp string 当前时间戳或随机数,如:1462502925
  sign string 校验值,md5(OpenID+key+orderid+timestamp),OpenID在个人中心查询
返回参数说明:
名称 类型 说明
  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://op.juhe.cn/ofpay/sinopec/sordersbydate
支持格式:json
请求方式:http get/post
请求示例:http://op.juhe.cn/ofpay/sinopec/sordersbydate
接口备注: 签名校验版,根据指定的开始和结束时间查询订单列表,本接口暂只支持查询近60天订单,暂不支持跨月日期查询
请求参数说明:
名称 类型 必填 说明
  page int 当前页数,默认1
  pagesize int 每页显示条数,默认50,最大100
  starttime time 格式:2016-03-01 00:00:00,开始和结束时间不能跨越
  endtime time 格式:2016-03-10 23:59:59
  timestamp string 当前时间戳或随机数,如:1462502925
  key string 应用APPKEY(应用详细页查询)
  sign string 校验值,md5(OpenID+key+starttime+endtime+timestamp),OpenID在个人中心查询
返回参数说明:
名称 类型 说明
 
JSON返回示例:
{
    "reason": "success",
    "result": {
        "data": [
            {
                "sporder_id": "S145796761519512345",
                "uorderid": "1457967680",
                "uordercash": "197.600",
                "cardname": "全国 中石化加油 固定面值加油卡 直充200元",
                "game_state": "9",
                "game_userid": "1000114100008******",
                "addtime": "2016-03-14 22:58:56"
            }
        ],
        "totalcount": 17,
        "totalpage": 17,
        "page": 1,
        "pagesize": 1
    },
    "error_code": 0
}
服务级错误码参照(error_code):
  错误码 说明
  208701 错误的充值类型
  208702 错误的充值金额/数量
  208703 加油卡卡号不能为空/错误
  208704 持卡人手机号码错误
  208706 校验值sign错误
  208707 当前账户可用余额不足
  208708 请求充值失败,请重试
  208709 充值失败,具体参照reason
  208710 重复的订单号
  208711 加油卡不存在、挂失、副卡、卡号查询失败等
  208712 订单号不正确
  208713 请求订单状态失败/订单不存在
系统级错误码参照:
  错误码 说明 旧版本(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) 具体错误代码
完整教学代码示例:
  语言 标题 提供者 时间
  Python 加油卡在线充值接口实例 JoneDwyane 2015-12-11 17:26:20
  PHP 加油卡充值示例 JoneDwyane 2015-12-11 17:24:04
  Python 加油卡充值接口调用示例 JoneDwyane 2015-12-11 17:25:52
  C# 加油卡充值接口调用示例 JoneDwyane 2015-12-11 17:25:13
  Go 加油卡充值接口调用示例 JoneDwyane 2015-12-11 17:24:40
  JAVA 加油卡充值接口调用示例 silk 2016-02-26 09:55:44
常见问题:
  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1495183350
其他相关内容
  内容 详细
  技术支持: info@juhe.cn
  联系电话: 0512-62391880
  在线客服QQ: 800076065