• 87
  • 6729
  • 136

加油卡接口

聚合数据 支持HTTPS

中石化、中石油加油卡API接口技术接入。为企业提供加油卡API接口,通过接口自由实现PC端、H5、APP等方式接入。

  • 按实际订单计费

¥ *** 价格详情请联系客服

  • 产品功能
  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用

功能介绍 / Introduction

  • 支持中石化加油卡、中石油加油卡的在线储值
  • 到账及时,平均到账时间<10分钟
  • 成功率高,订单充值成功率>99%
  • 常规面值库存丰富,提供持续稳定的充值服务
  • 高效稳定,安全便捷的API接口快速接入

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

以下是支持的面值(非常规面值库存情况可与客服联系):
中石化 常规面值 100元 500元 1000元
非常规面值 50元 200元
中石油 常规面值 100元 200元 500元 1000元

注意事项 / Cautions

  • 【中石化加油卡】充值注意事项:
  • 1、中石化官方每日22:50-00:50为其系统对账时间,此段时间聚合收单处理,对账结束,正常处理。
  • 2、所有加油卡主卡都可以在线充值,包含记名主卡、不记名主卡、企业主卡。副卡挂失卡卡号不存在无法充值。
  • 3、订单充值成功,一般10分钟内即可到帐,用户需在加油站完成圈存,方可使用。
  • 4、同一时间同一卡号提交多笔,可能会被石化系统限制,导致充值失败,不同省份超限限制不同。
  • 5、订单充值成功,如超过24小时仍未到帐,为中石化官方系统数据传输问题,请您尽快通过客服热线与我们或中石化官方联系。
  • 6、中石化官方客服热线:区号+95105888/91505988。
  • 【中石油加油卡】充值注意事项:
  • 1、暂只支持个人卡记名卡(卡号以90开头),不支持车队卡(卡号以91开头)。
  • 2、中石油官方客服热线:95504

业务场景 / Scenes

  • 车主服务平台/APP

    适用于车主服务类平台/APP,为其用户提供汽车加油卡充值功能服务。

  • 电商平台充值中心

    适用于各电商平台充值中心,增加加油卡在线充值服务。

  • 银行保险行业

    可应用于各银行APP充值频道,以及汽车保险附属增值服务。

快速调用API / FastCall

接口地址:您接收回调新的URL地址,联系客服配置
返回格式:接收到回调,请返回任意字符串
请求方式:http post
请求示例:

请求参数说明:

名称 必填 类型 说明
  聚合推送参数 - - -
  sporder_id string Y 聚合订单号
  orderid string Y 用户自定义的单号
  sta int Y 充值状态1:成功 9:失败
  sign string Y 校验值,md5(appkey+sporder_id+orderid) 32位小写,用于校验请求合法性
  err_msg string N 状态描述信息(暂只支持油卡业务)

返回参数说明:

名称 类型 说明

JSON返回示例:

只有成功提交的订单才会有回调通知,如果提交订单是直接返回错误码,这部分单子不会发起回调通知。
详细说明可参考:http://code.juhe.cn/docs/detail/id/1565

处理成功请返回:success 或 任意字符串

重试机制:聚合数据在请求回调地址时,如果无任何内容返回或无响应,会重新发起最多3次,间隔3s左右

本回调推送内容格式适用于话费充值、油卡充值、流量充值等增值服务

如果需要状态回调的用户,如接口其他已经调试完毕,请将账号和回调地址发给在线客服,我们将回调地址配置线上。

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

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

系统级错误码参照:

  错误码 说明 旧版本(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) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1545160390

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 4008827715-6067
  在线客服QQ: 800076065

猜你喜欢

现在注册,百款接口免费测试

免费注册