获取下单H5页面

说明

  1. 包含用户鉴权过程,鉴权成功会返回下单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地址,直接打开即可"
    }
}
Copyright © 红旗智行科技(北京)有限公司 2018 all right reserved,powered by Gitbook该文件修订时间: 2021-03-24 09:37:24

results matching ""

    No results matching ""