生成订单
接口调用请求说明
该接口仅用于在微信侧生成一笔业务订单,若需要拉起收银台,则需要调用生成支付订单接口。
注:
- 接口只支持创建,不支持更新,重复创建以第一次创建为准
- 调用该接口成单后,如果想要修改订单,需要调用更新订单相关接口
- 如果传入trace_id,则在解析完毕之后会发出回调订单归因成功回调
- 创建订单时可传入
aftersale_duration
,该参数表示确认收货后 x 天完成结算,结算后订单不可再发起售后,如果创建订单时无法确定售后期,可在确认售后后,调用更新售后期接口 - 订单超时时间
expire_time
会影响支付参数的时效,时间到期之后,微信会流转订单超时取消(status = 181) - 生成业务订单时,微信侧会对金额进行校验,请确保金额相关信息满足:
否则将生成订单失败。其中sku_real_price为相同sku_id的总实付款,e.g. out_sku_id = "10010"买了10件,此处sku_real_price应传入此10个 sku 的总实付价。
请求参数示例
回包示例
请求参数说明
Order
字段名 | 类型 | 是否必填 | 说明 |
create_time | string | 是 | 创建时间,yyyy-MM-dd HH:mm:ss,与微信服务器不得超过5秒偏差 |
out_order_id | string | 是 | 商家自定义订单ID(字符集包括大小写字母数字,长度小于128个字符) |
openid | string | 是 | 用户的openid |
order_detail | OrderDetail | 是 | 订单详细数据 |
delivery_detail | DeliveryDetail | 是 | 配送信息 |
path | string | 是 | 订单详情页路径 |
address_info | AddressInfo | 是 | 地址信息 |
fund_type | number | 是 | 订单类型:0,普通单,1,二级商户单 |
expire_time | number | 是 | unix秒级时间戳,订单超时时间,取值:[15min, 1d] |
aftersale_duration | number | 选填 | 取值范围,[7,3 * 365],单位:天 |
trace_id | string | 是 | 会影响主播归因、分享员归因等,从下单前置检查获取 |
default_receiving_address | AddressInfo | 选填 | 默认退货地址,退货售后超时时,会让用户将货物寄往此地址 |
stringify_64bits_number | bool | 选填 | 生成的order_id以字符串形式返回(微信侧订单 id 为63位,某些语言会丢失精度) |
OrderDetail
字段名 | 类型 | 是否必填 | 说明 |
product_infos | OrderProductInfo[] | 是 | 商品列表 |
price_info | PriceInfo | 是 | 价格信息 |
pay_info | PayInfo | 否 | fund_type = 0 必传| |
PayInfo
字段名 | 类型 | 是否必填 | 说明 |
pay_method_type | enum | 是 | 0: 微信支付, 1: 货到付款, 2: 商家会员储蓄卡(默认0) |
DeliveryDetail
字段名 | 类型 | 是否必填 | 说明 |
delivery_type | enum | 是 | 1: 正常快递, 2: 无需快递, 3: 线下配送, 4: 用户自提,视频号场景目前只支持 1,正常快递 |
AddressInfo
字段名 | 类型 | 是否必填 | 说明 |
receiver_name | string | 是 | 收件人姓名 |
detailed_address | string | 是 | 详细收货地址信息 |
tel_number | string | 是 | 收件人手机号码 |
country | string | 否 | 国家 |
province | string | 是 | 省 |
city | string | 是 | 市 |
town | string | 是 | 区 |
OrderProductInfo
字段名 | 类型 | 是否必填 | 说明 |
out_product_id | string | 是 | 外部商品spuid,可以不在商品库里,但是会响销售统计 |
out_sku_id | string | 是 | 外部商品skuid,可以不在商品库里,但是会响销售统计 |
product_cnt | number | 是 | 商品个数 |
sale_price | number | 是 | 生成订单时商品的售卖价(单位:分),可以跟上传商品接口的价格不一致 |
sku_real_price | number | 是 | sku总实付价 (单位:分),必须 > 0 |
title | string | 是 | 生成订单时商品的标题 |
head_img | string | 是 | 生成订单时商品的头图 |
path | string | 是 | 绑定的小程序商品路径 |
PriceInfo
字段名 | 类型 | 是否必填 | 说明 |
freight | number | 是 | 运费 |
discounted_price | number | 否 | 折扣费用 |
additional_price | number | 否 | 其他费用 |
additional_remarks | string | 否 | 其他费用说明 |
order_price | number | 是 | 订单总价 |
返回参数说明
字段名 | 类型 | 说明 |
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data | Object | 订单 id 信息 |
data.order_id | number/string | 交易组件平台订单ID,类型取决于stringify_64bits_number 参数 |
data.out_order_id | string | 交易组件第三方订单ID |