普通代驾-H5接入

 

业务说明：

H5接入是指，用户下单和代驾服务过程都是通过滴滴代驾的H5页面完成的。即用户从商户的web页面、app或者微信小程序等渠道，跳转到滴滴代驾H5页面进行代驾服务。
H5方式接入非常简单，同时提供了类似于滴滴代驾app的地图、订单状态等服务。商户只需要根据参数规则，并利用滴滴提供的H5接入url拼接出最终的H5下单url，最后跳转到该下单Url即可。

对接模式:

目前包含两种对接模式。在商务上，开发人员需要确定，当前以哪一种模式对接。不同的模式，关注不同的接口。

1、权益模式对接：开发人员只需要关注，免登陆接口，订单详情接口。
2、券模式对接：开发人员只需要关注，发券接口、券状态查询接口。
api详情见：API接口文档

H5链接拼接说明：

滴滴代驾H5链接拼接格式："滴滴H5地址 + ? + 请求参数拼接字符串"。
以测试环境为例，以下是拼接后的H5链接：
https://pinzhi-sp.didichuxing.com/m/djhome.node?daijia_pid=xxx&daijia_token=xxx&lat=xxx&lng=xxx&mob=xxx&c=xxx&sc=xxx
测试环境H5地址为：https://pinzhi-sp.didichuxing.com/m/djhome.node
线上环境H5地址为: https://dj.kuaidadi.com/m/djhome.node
请求参数拼接字符串：daijia_pid=xxx&daijia_token=xxx&lat=xxx&lng=xxx&mob=xxx&c=xxx&sc=xxx。
参数说明：

商户接入流程

以下为调用流程。注意代金券优惠需要调用发券接口，而权益模式不需要。

注意

1、请按照"开发规范"接入，否者调用服务可能出现非预期的异常。
2、对于权益接入模式，调用免登接口获取的token，标识着一次用户权益的开始。即每一个token拼接的H5链接，均可以下一个新的滴滴代驾订单。 因此，若非重新下单请不要调用免登接口获取新token来拼接H5链接。
3、免登接口获取的token不会过期，只有当用相同的参数再次调用免登接口，旧的token才会失效。因此，利用旧的token拼接的H5链接，可以进入旧的订单。
4、权益接入模式，免登接口传入的权益id决定下单时使用的权益。若调用免登接口未传入权益id，则下单时无法使用权益。

上线前必备

Checklist：
    滴滴提供内容：
        线上CustomerKey、AppKey和AppSec
        线上服务端正式地址
        线上H5正式地址
        商家渠道号
        后台配置券信息（如有代金券业务）
        后台配置权益ID（如权益模式业务）
    商家提供内容：
        商家服务端线上IP地址（加入白名单）
        商家服务端线上服务回调地址（如商家需要回调数据）
请确保以上信息的准确，避免因为环境因素导致功能失败。