聚合数据

加油卡接口

  • 数据类型: 充值缴费
  • 接口状态: 正常
  • 已连接App的数量: 10080
  • 描述: 中石化、中石油加油卡API接口技术接入。为企业提供加油卡API接口,通过接口自由实现PC端、H5、APP等方式接入。

接口地址: http://op.juhe.cn/ofpay/sinopec/onlineorder

支持格式: JSON

请求方式: HTTP GET/POST

请求示例: http://op.juhe.cn/ofpay/sinopec/onlineorder

请求参数:

名称 类型 必填 说明
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开头的19位卡号、中石油:以90开头的16位卡号
gasCardTel string 持卡人手机号码,可以填写一个固定格式的手机号码,如:18900000000;为了保证充值质量,中石油充值请传递加油卡账号的绑卡手机号。
gasCardName string 持卡人姓名
chargeType int 加油卡类型 (1:中石化、2:中石油;默认为1)
key string 在个人中心->我的数据,接口名称上方查看
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": "100", /*售价*/
        "cardname": "全国加油卡", /*充值名称*/
        "sporder_id": "S20141125221812330", /*聚合订单号*/
        "game_userid": "100011320000991****", /*加油卡卡号*/
        "game_state": "0", /*充值状态:0充值中 1成功 9撤销,刚提交成功的单子状态均为充值中*/
        "uorderid": "S2014111111115" /*用户自定的订单号*/
    },
    "error_code": 0
}

XML返回示例:


          

备注:正式使用后建议个人中心绑定IP白名单。<font color=red>加油卡完成网上充值后,需到所充值油卡当地加油站请工作人员进行激活(圈存)操作,否则充值金额将无法生效。发票等相关问题请联系客服。***如果充值过程中,遇到http网络状态异常或返回系统异常,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!</font>

服务级错误码参照(error_code):

错误码 说明
208701 错误的充值类型
208702 错误的充值金额/数量
208703 加油卡卡号不能为空/错误/不支持
208704 持卡人手机号码错误
208705 持卡人姓名不能为空
208706 校验值sign错误
208707 当前账户可用余额不足
208708 请求充值失败,请重试
208709 充值失败,具体参照reason
208710 重复的订单号(近60天订单周期内单号不能重复)(需要自行进行二次确认,是否进行失败处理)
208711 加油卡不存在、挂失、副卡、卡号查询失败、查询不到结果等
208712 订单号不存在
208713 订单无效/受理失败
208714 不合规范的订单号
208716 创建订单失败

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

《加油卡接口》资费说明:

等级 价格(元) 请求次数

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358