获取下单H5页面
说明
- 包含用户鉴权过程,鉴权成功会返回下单H5地址
地址URL
http:// <hqzx_DOMAIN>/v2/channel/open/h5/getCreateOrderUrl
HTTP请求方式
POST
访问授权限制
需要验签,参见:鉴权说明
注意事项
1、手机号(或用户ID)为用户唯一标识,优先使用手机号,二者必有一个必填,名称类信息,没有新增,有会覆盖修改。
2、复杂场景,张三,帮忙给李四约车,实际需要王五付款,所以有预订人,乘车人,付款人。
3、订单归属于预订人,订单结算用于付款人,个人隐私用车,三个人为同一个人。
4、部门信息,如果不方便给真实,可以给个虚拟的
5、合作方订单号,为双方订单关系绑定用,若无,可传一个类似UUID的唯一标识即可
请求参数
参数名称 | 参数说明 | 是否必须 | 数据类型 |
---|---|---|---|
partnerOrderNo | 合作方订单号 | true | String(50) |
orderType | 订单类型,1个人(因私)、2企业(因公) | true | int |
serviceType | 服务类型,1即时、2预约、3接机、5送机 | true | int |
bookingUserId | 预订人用户ID(三方用户唯一标识) | true | String(50) |
bookingUserName | 预订人姓名 | true | String(20) |
bookingUserPhone | 预订人手机号(订单归属人) | true | String(20) |
riderId | 乘车人用户ID | true | String(50) |
riderName | 乘车人姓名 | true | String(20) |
riderPhone | 乘车人手机号 | true | String(20) |
payerId | 付款人用户ID(与手机号不可全为空) | true | String(50) |
payerName | 付款人姓名 | true | String(20) |
payerPhone | 付款人手机号(订单结算人) | true | String(20) |
payerCompanyNo | 付款人企业编号 | true | String(20) |
payerCompanyName | 付款人企业名称 | true | String(50) |
payerTeamNo | 付款人部门编号 | true | String(20) |
payerTeamName | 付款人部门名称 | true | String(50) |
quotaType | 限额类型,0不限额、1限额 | false | int |
quotaLimit | 限额额度,单位分 | false | int |
settlementType | 结算类型,1个人垫付、2企业月结 | false | Int |
flightNo | 航班号 | false | String(20) |
flightDate | 航班时间(时间戳13位),时间请保证准确 | false | Long |
请求示例
curl
-H "accept:application/json;charset=utf-8"
-H "Content-Type:application/json"
-H "channel:XXX" -H "sign:XXX"
-X POST '参见请求地址URL'
-d '
{
"partnerOrderNo":"XXXX",
"orderType":1,
"serviceType":1,
"bookingUserName":"预订人",
"bookingUserPhone":"13000000000",
"riderName":"乘车人",
"riderUserPhone":"14000000000",
"payerName":"付款人",
"payerPhone":"15000000000",
"payerCompanyNo":"企业编号",
"payerCompanyName":"企业名称",
"payerTeamNo":"部门编号",
"payerTeamName":"部门名称",
"quotaType":1,
"quotaLimit":1000,
"settlementType":1,
"openBank":"开户银行",
"flightNo":"航班号",
"flightDate":"13位时间戳"
}
'
返回结构说明
参见:接口说明
返回结果说明
名称 | 类型 | 说明 |
---|---|---|
type | int | 订单类型,1:下单地址;2:订单列表;3:订单详情 |
url | String | H5请求地址 |
返回示例
{
"code":1,
"msg":"SUCCESS",
"data":{
"type":1,
"url":"H5地址,直接打开即可"
}
}