创建订单接口(云对云)
更新时间:2021-10-15
创建订单接口(云对云)
一、功能描述
该接口是开放平台给开发者提供云对云的创建订单接口。开放平台有几种接入模式: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 |