B、第二步,易能时代根据合作方的请求,向合作方返回油站列表信息
C、第三步,合作方用户端向合作方服务端请求油站信息列表,
D、第四步,合作方服务端根据以获取的油站列表返回对应油站列表信息给到合作方用户端
E、第五步,合作方用户端请求进入油站详情界面,合作方服务端根据接口生成H5链接给到用户端,合作方用户端通过H5链接进入到易能时代平台油站详情界面,后续订单确认及支付均在易能时代平台操作完成,支付完成,油站放行。
platformName,beforeKey、afterKey、app_key、app_secret、ak、sk等调取接口必要的信息由易加油产品提供。
·请谨慎使用正式环境的油站测试支付!若需测试请提前告知易能时代,由易能时代运营与油站提前沟通后方可进行测试。已确认测试油站后有以下要求:单笔支付金额**≤**10元,单个油站可测试订单数**≤**5笔,当天支付订单必须当天反馈易能时代工作人员申请退款,隔天订单不予退款申请操作。如需测试10元≤订单支付金额≤1000元),请使用易能时代正式环境测试油站id:21413。
·测试环境获取的油站均可进行测试操作。
分为路径参数,请求参数,body参数
·路径参数:接口路径中对应的{}中
·请求参数:在接口路径之后,与接口路径使用分隔,且请求参数与请求参数使用&分隔
·body参数:POST方法放在json请求体中的参数
·统一Content-Type:application/json格式
·易能时代经纬度为百度坐标系
·在测试环境,30分钟之内申请退款,需要告知易能时代工作人员进行退款操作,正式环境退款最终是需要油站点击同意退款。
·货拉拉、高德地图
合作平台可通过该接口查询获取到易能时代开放给合作方的油站列表数据。需每天分阶段同步数据,每天默认访问次数限制为24次。
Path:getStationPages/{currentPage}/{pageSize}/{platformName}/{sign}/{timestamp}
Method:GET
路径参数
返回示例
返回参数说明:
油站集合数据返回参数说明
跳转一键加油小程序油站详情页
合作平台用户可通过该接口查询在仅限合作方平台使用或者全平台使用的优惠券信息。
对(beforeKey+timestamp+afterKey)采用MD5加密,结果取32位大写。
Headers:Content-Type:application/json
示例:
personalInfo参数说明
用户在第三方平台上发起退款申请,可通过该接口通知易能时代申请是否给予处理退款(30分钟内可用直接用该接口发起退款申请,30分钟后,需要联系易能时代客服发起退款)。申请退款流程参考【常见问题-4.退款申请流程】
合作平台可通过调取该接口给符合条件的指定用户发放易能时代优惠券,由易能时代配置并提供活动id。兑换优惠券流程参考【常见问题-5.用户获取优惠券流程】
第三方平台可通过该接口对易能时代发放的优惠券兑换码进行兑换。兑换优惠券流程参考【常见问题-5.用户获取优惠券流程】
Method:POST
需由易能时代调用第三方平台接口,调用地址由易能时代工作人员在后台进行配置。
Headerapplication/json
1.按字段的key进行排序,拼接key=value字符,使用&符号连接,最后加上sk(由我方提供)(注意:sk前也用&连接)Charset为UTF8
示例
2.对整体字符串进行MD5加密,Charset为UTF8
API对接对(beforeKey+timestamp+afterKey)采用MD5加密,结果取32位大写
H5对接:使用#号连接sign=MD5(app_key+#+timestamp+#+app_secret)
在对接过程中出现的异常中带有错误码Code和错误提示msg,常见code和msg值及对应解决方案如下所示:
注意:在联系易能时代解决问题时需要告知环境信息,如:正式环境/测试环境
现金券:订单金额需满足一定的最低额度才可使用,例如满200减20元。(特殊情况:A油站满200直降10元,用户领取满200减20元优惠券,那么用户的最终支付金额为200-20-10=170元);
折扣券:使用折扣券购买油品时可打折;
以上优惠券均可配置可叠加和不可叠加两种形式,同时也可配置仅部分平台使用或全平台使用,具体的运营配置规则需和易能时代运营进行沟通确认。
因客观原因少量油站不支持在第三方平台透出。与易能时代app为两种不同的展现方式,最终参数以接口文档中的返回参数为准,具体可以参考推荐的平台.
小程序API+H5对接中,有两套签名规则,均在相应接口中有说明。
已使用:已使用优惠券信息是不返回的,除非用户在支付完成后又申请退款且退款成功,该优惠券就会信息就会返回,优惠券状态会按照可用和不可用两种状态展示。