使用说明:注意在微信内的使用

1、不支持在微信小程序中使用(不支持微信小程序支付)

2、微信公众号中可以使用

一. client_id和sign_key获取方式

获取方式见 1.1 接入流程

特别注意:

  1. 创建应用的接入模式选择:H5
  2. 创建应用的所需API选择:H5免登接口、企业用车接口、企业管理接口

输入图片说明

二. 使用client_id组装url跳转到h5页面

H5接入域名

H5请求方式

正式环境请求,即使用正式环境域名、client_id 和 sign_key 即可

链接生成使用get方式带入对应参数,并通过跳转链接传递给WebApp,测试环境请求示例见下:

https://sandbox-mobile.caocaokeji.cn/pay-travel/home?client_id=38095b5484aa0576&ext_user_id=777777&ext_user_name=name&ext_user_phone=18143474301&sign=1f2c544fc0d65fbd9c0e7e22ae72dd1c89ba46f4&timestamp=1535003260000&startLg=116.711279&startLt=40.213257&endLg=116.611279&endLt=40.113257

三. 请求参数

签名方式:对下表标注了“参与签名”的参数组成参数对(未标注的不参与签名),并进行升序排序,组装成字符串,然后进行sha1签名得到结果。 签名具体方法见 1.3 签名认证

参数名 是否必填 说明
client_id Y 开放平台管理中心获取(参与签名)
timestamp Y 时间戳(毫秒)(参与签名)
ext_user_id Y 第三方用户ID,第三方唯一标识,ID由第三方生成(参与签名)
ext_user_phone N 实际叫车人手机号(如果url中传递,则参与签名)
ext_user_name N 实际叫车人用户名(如果url中传递,则参与签名)
sign Y 免登签名(签名方式参考下方示例)
phone N 乘车人手机号,若不传入,用户需要输入乘车人手机号才能叫车
phoneType N 0 可修改; 1 不可修改
useTime N 用车时间,格式为时间戳,预约单用车时间必须大于等于当前时间30分钟,不超过当前时间往后72小时
useTimeType N 0 可修改; 1 不可修改
start_time N 用车时间范围开始时间控制,格式为时间戳,传入后不支持修改
end_time N 用车时间范围结束时间控制,格式为时间戳,传入后不支持修改
start_city_codes N 起点城市范围控制,有多个用逗号(小写)隔开,传入后不可修改(开通城市citycode通过文档2.1接口获取)
end_city_codes N 终点城市范围控制,有多个用逗号(小写)隔开,传入后不可修改(开通城市citycode通过文档2.1接口获取)
startLg N 起点经度,高德坐标系(h5获取定位存在不稳定情况,接入方可传入起点经纬度提高用户体验)
startLt N 起点纬度
startType N 0 起点可修改; 1 起点不可修改
endLg N 终点经度
endLt N 终点纬度
endType N 0 终点可修改; 1 终点不可修改
service_types N 控制服务车型:2 新能源;3 舒适型;4 豪华型;5 商务型;7 优选
canSecondCall N 该字段控制订单结束或订单取消后是否可以在H5页面继续通车。true 可以继续叫车; false 不可继续叫车,跳转至用车结束页,如需继续用车,需要用户关闭H5用车页,再重新进入。
route N 控制打开用户的页面,用户标识以第三方用户ID为准。journey:打开用户的订单列表;orderDetail:打开用户对应订单号的订单详情页(需要配合orderNo一起使用)
orderNo N 当route=orderDetail时必传,orderNo为曹操订单号,订单号可通过5.3订单状态变更回调获取,或通过3.3订单列表查询接口获取
callback_info N 备注字段,订单事件变化回调通知会推送该备注