创建订单接口(云对云)

创建订单接口(云对云)

一、功能描述

该接口是开放平台给开发者提供云对云的创建订单接口。开放平台有几种接入模式:OAP(order and pay )接入;ONP(order not pay);PNO(pay not order),只有PNO模式是不需要云端创建订单的,ONP都需要调用该接口在车联网这边创建订单

二、使用说明

Api共同接口说明V2

三、接口地址

/iovorder/v2/opf/generateorder

四、请求参数

参数名 类型 是否必填 最大长度 描述 实例值
openid String - 百度小程序openid。 -
appkey String - 百度小程序appkey。 -
baidu_uid Bigint - 百度用户id 149235070
opf_appid Int - dealId的别名,开放平台上开发者申请后自动生成的一个固定值,也就是dealId 123456
apikey String - 开放平台上开发者申请后自动生成的一个固定值 -
secretkey String - -
version String 5 开放平台上开发者申请后自动生成的一个固定值调用的接口版本固定值为1.0 1.0
timestamp Int 10 发送请求的时间戳,精确到秒 1514917884
sign String - 请求参数的签名串,详见签名 详见签名与验签
dealId String - dealid即opf_appid 123456
device_from Int 2 设备类型 1-andr 2-ios 3-车机 4-server
out_trade_no String 32 商户订单号/第三方开发者订单id 900020199
goods_name String 128 商品名称,允许包含中文;不超过128个字符或64个汉字
goods_pic_url String 255 商品缩略图url,用户中心列表页使用,图片大小150*150
goods_url String 255 商品在商户网站上的url;不超过255个字符
goods_unit_price Int - 商品单价,以分为单位
goods_count Int - 商品数量
goods_total_price Int - 订单总金额,以分为单位
transport_price Int - 运费,以分为单位
out_trade_time String 19 业务订单生成时间,格式为"yyyy-MM-dd HH:mm:ss" 2018-08-08 08:08:08
out_trade_status Int - 业务方订单状态 201 业务方自由定义,用于在订单中心(列表/详情)进行定制展示
out_trade_status_desc String 不超过20个汉字 业务方订单状态描述 待配送/待服务/.. 业务方自由定义,用于在订单中心(列表/详情)进行定制展示
order_status Int - 平台订单状态 详见2.5参数说明 3
expire_time String 19 交易的过期时间,格式为"yyyy-MM-dd HH:mm:ss" 2018-08-08 08:08:08
extra String 15000 扩展字段,业务自己决定放什么;不超过15000个字符;json格式;
order_content_desc String 500 开发者可以用于保存自己想保存的数据。内容开发者自行决定;不超过500个字符;json格式;在二维码接口、订单列表和订单详情接口返回
ak String 30 注意:百度内部人员对接且车机端产生的订单,一定传真实分配给不同车企的真实值。如果是外部开发者云端对接(无法通过车机获取到时),请联系百度研发分配
cn String 30 注意:百度内部人员对接且车机端产生的订单,一定传真实分配给不同车企的真实值。如果是外部开发者云端对接(无法通过车机获取到时),请联系百度研发分配
oem_id int - 注意:百度内部人员对接且车机端产生的订单,一定传真实分配给不同车企的真实值。如果是外部开发者云端对接(无法通过车机获取到时),请联系百度研发分配
encryptconent String 2000 开发者在客户端或小程序需要通过百度的接口获取到该值(已加密),下单时透传到服务端,请求此接口时透传过来即可,如果没有这个值或随意伪造数据会创建订单失败

返回结果

接口返回固定为下面的结构

名称 类型 是否必须 最大长度 描述 实例
errno int 返回码 0
errmsg string 返回信息
data object 返回数据 {}
date string 时间 2020-09-09 19:38:38
baidurd string 百度开发人员后续定位问题字符串,内部人员才需要关注
errno  返回0表示成功,其他值为失败
data 的值只有成功的时候才会有可能返回,值可为空
baidurd 部分模块没有返回,属于正常

data字段为json格式,参数如下:

参数名 类型 是否必填 最大长度 描述 实例值
order_id String 64 车联网订单id,注意,在支付的需要该值,需要开发者保存在服务端 1069227442364
车联网下单接口加签与验签规则更新订单状态接口