文档
测试

5.下单

POST
api_method:u-order-request

服务入口:

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

编码

++数据编码:++ Accept:application/json Content-type: application/json ++字符编码:++ utf-8

前端UI界面示例

![image.png](https://cos.easydoc.net/48578360/files/k94x2ojv)

系统级请求参数

参数名
类型
描述
必填
api_method
string
接口方法
必填
api_version
string
接口版本,固定值:1.0
必填
app_key
string
应用唯一app_key
必填
access_token
string
用户账户访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数

参数名
类型
描述
必填
city_id
int
下单城市ID, 示例:1002
必填
city_info_revision
int
下单城市最新版本号, 示例:296
必填
order_vehicle_id
int
下单车型ID, 示例:402
必填
addr_info
array
下单地址信息。 寄件地址为数组第一个元素,收件地址为第二个元素
必填
name
string
地址名称, 示例:维也纳国际酒店(深圳北站店)
必填
addr
string
地址详情, 示例:深圳市⻰华区致远中路2号
必填
lat_lon
object
地址经纬度(gcj02坐标系)
必填
lat
double
定位经度, 示例:22.60961852782125
必填
lon
double
定位纬度, 示例:114.02309914676592
必填
city_id
number
地址所在城市ID, 示例:1002
必填
city_name
string
地址所在城市名称,示例:深圳
必填
district_name
string
地址所在区(县), 示例:宝安区
必填
house_number
string
楼层及门牌号, 示例:20层2003号房
可选
contacts_name
string
地址联系人 示例:刘⽣
可选
contacts_phone_no
string
地址联系人手机 示例:136999969966
可选
vehicle_std
array(string)
车型附加要求。 示例:["双排座"]
可选
spec_req
array(int)
城市可选额外需求。 示例:[2,5]
可选
contact_name
string
下单联系⼈
必填
contact_phone_no
string
下单联系人手机
必填
out_user_id
string
下单人在服务商平台侧的唯一ID
必填
ip
string
下单人设备IP地址,示例:113.87.193.119
可选
remark
string
下单备注, 示例:⻋要快,钱不是问题
可选
order_time
long
用车时间(unix时间戳,单位秒)
必填
total_price_fen
int
总价(分), 示例:6600
必填
pay_type
int
支付方式:4.账户余额支付,901云闪付APP支付(仅中国银联可用)
必填
notify_url
string
订单状态变更后推送回调地址
可选
themis_data
object
下单用户设备及网络信息(风控数据信息)
可选
os
string
设备类型, 示例:Android或IOS
可选
brand
string
设备品牌, 示例:huawei
可选
model
string
设备型号, 如: honor 10 lite
可选
osversion
string
手机系统版本,示例:安卓 8.1.0
可选
mac
string
⼿机-mac,示例:00-01-6C-06-A6-29
可选
imei
string
安卓设备IMEI标识, 示例:736767996668
可选
uuid
string
IOS设备唯一标识, 示例:616678656599
可选
nettype
string
⽹络类型WiFi/2G/3G/4G/5G, 示例:4G
可选
bssid
string
WiFi-MAC, 如: 00-12-22-33-44-78
可选
ssid
string
WIFI名称, 如: huolala
可选

响应参数

参数名
类型
描述
必填
ret
int
返回结果码, 示例:0
必填
msg
string
返回结果描述,示例:
必填
data
object
数据字典
必填
order_display_id
string
货拉拉订单号, 示例:137100800068
必填
pay_no
string
【云闪付专用】货拉拉支付单号
必填
price_fen
int
【云闪付专用】需支付金额(分)
必填
pay_notify_url
string
【云闪付专用】支付结果通知回调地址(银联侧需通过此回调地址通知货拉拉支付结果)
必填
pay_time_expire
string
【云闪付专用】支付超时时间。格式如:"2020-05-27 11:15:53"
必填
pay_mch_id
string
【云闪付专用】银联收款商户号
必填
pay_serv_mch_id
【云闪付专用】银联服务商号
必填

请求json示例:

```json { "order_vehicle_id":402, "vehicle_std":[ "双排座" ], "city_id":1002, "spec_req":[ 2, 5 ], "city_info_revision":296, "order_time":1568895707, "contact_name":"联系⼈", "contact_phone_no":"13699999999", "out_user_id":"12345" "ip":"134.175.60.58", "remark":"⻋要快,钱不是问题", "total_price_fen":6600, "pay_type":66666, "notify_url":"", "addr_info":[ { "name":"维也纳国际酒店(深圳北站店)", "addr":"深圳市⻰华区致远中路2号", "city_id":1002, "city_name":"深圳", "district_name":"宝安区", "house_number":"20层2003号房", "contacts_name":"刘⽣", "contacts_phone_no":"136999969966", "lat_lon":{ "lon":114.02309914676592, "lat":22.609618527821251 } }, { "name":"⻓城开发⾼层公寓", "addr":"皇岗路5000号", "city_id":1002, "city_name":"深圳", "district_name":"福⽥区", "house_number":"", "contacst_name":"", "contacts_phone_no":"", "lat_lon":{ "lon":114.06548381551384, "lat":22.569156830453188 } } ], "ip":"113.87.193.119", "themis_data":{ "imei":"736767996668", "uuid":"616678656599", "os":"Android", "brand":"huawei", "osversion":"安卓 8.1.0", "model":"v20" "nettype":"4G", "bssid":"00-12-22-33-44-78", "ssid":"huolala", "mac":"00-01-6C-06-A6-29" } } ```

返回json示例:

```json { "ret":0, "msg":"Success", "data":{ "order_display_id":191010805015, "price_fen":10000, "pay_no":"20200522161424083761test", "pay_notify_url":"https://hpay-stg.huolala.cn/c_pay/notify/c_name/open_union_agg/c_id/57", "pay_mch_id":"A47290439980002", "pay_serv_mch_id":"370010310001", "pay_time_expire":"2020-05-22 16:19:24" } } ```

返回状态码说明

|ret状态码|描述|建议处理方式| |-|-|-| |0|成功|| |30010|城市列表信息已过期|调获取车型信息接口重新获取| |30011|城市未开通|需要重新拉取【城市列表】| |31001|city_id错误|city_id跟第⼀个地址的city_id不符| |31002|地址信息有误|-| |31003|用户账号异常|-| |31004|订单时间过期|-| |31005|拉拉券不可用|-| |31006|车型错误|调获取车型信息接口重新获取| |31009|经纬度错误|-| |31010|车型附加要求不存在|调获取城市车型信息接口重新获取| |31013|用车时间有错误|-| |31017|错误的支付渠道|-| |31018|联系⼈信息或备注中含有违禁/违规词汇,暂不能下单|-| |31020|余额不足|-|