文档
测试

5.下单

POST
api_method:u-order-request

编码

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

前端UI界面示例

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

系统级请求参数

参数名
类型
描述
必填
api_method
string
接口方法名。请传"u-order-request"
必填
api_version
string
接口版本号。请传固定值“1.0”
必填
app_key
string
开发者应用唯一app_key
必填
access_token
string
货拉拉用户授权访问码access_token
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数(api_data数据结构)

参数名
类型
描述
必填
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
long
支付超时时间(unix时间戳,单位秒)
必填
pay_serv_mch_id
string
银联服务商ID
必填
pay_mch_id
string
银联商户号ID
必填

请求json示例:

```json { "api_method":"u-order-request", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"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\":\"113.87.193.119\", \"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 } } ], \"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":"", "data":{ "order_display_id":"137100800068", "pay_no":"", "price_fen":1000, "pay_notify_url":"http://xxxxxxx.cn/xxxxxx", "pay_time_expire":1587095166 } } ```

返回状态码说明

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