plugin.createOrder
提供开发者交易系统中预下单能力,开发者通过调用该方法生成订单后,会调起小程序收银台进行支付。
使用限制
行业插件在抖音 App 版本 31.8.0 及以上, 小程序基础库版本 3.4x.0.0 及以上时支持,测试下单仅支持使用真机测试,无法使用IDE模拟器。
语法
plugin.createOrder(options);
参数说明
options 为 object 类型,属性如下:
- •针对旧版本开发者,保留支持 goodsList 下单(此场景 skuList 必须为空),新接入开发者推荐使用 skuList 下单(此场景 goodsList 必须为空)
- •goodsList 和 skuList 不能同时为空;
- •全融合版(非预约品)需使用goodsList下单,全融合版(预约品)需使用skuList下单;
- •全融合交易仅支持商品库商品,不支持非商品库商品。
- •融合预约商品订单:
- ◦即时预约:通过该接口传入 bookinfo 后将自动创建预约单(无论商品数量多少,仅生成一个预约单)。
- ◦先买后约:若下单数量不为 1,需先通过该接口下单,再调用创建预约单接口分多次创建。
- ◦创建加价单:加价参数需传入 tradeOption.order_relation_info 结构中。
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
goodsList | Goods[] Goods说明见下文 | | 是 | 下单商品 注意:目前仅支持单 SPU 商品下单 | 2.51.0.0 |
skuList | Sku[] Sku说明见下文 | | 否 | 下单商品信息(新) (skuList目前只支持单个sku) | 2.67.0.0 |
bookInfo | BookInfo BookInfo说明见下文 | | 否 | 预约信息 | 2.67.0.0 |
payment | Payment Payment说明见下文 | | 是 | 订单支付信息 | 2.51.0.0 |
contactInfo | ContactInfo ContactInfo说明见下文 | | 否 | 联系信息 | 2.51.0.0 |
storeInfo | StoreInfo StoreInfo说明见下文 | | 否 | 商店信息 | 2.51.0.0 |
note | string | | 否 | 订单备注 | 2.51.0.0 |
callbackData | Object | | 否 | 2.51.0.0 | |
tradeOption | Object | | 否 | 2.74.0.0 | |
callbackUrl | string | | 否 | 开发者自定义的预下单回调 URL(仅账号融合支持,完全融合不生效) | 2.65.0.0 |
discountInfo | DiscountInfo DiscountInfo说明见下文 | | 否 | 折扣营销算价信息 | 2.52.0.3 |
discountId | string | | 否 | 折扣营销算价信息 ID(若同时存在 discountInfo 和 discountId 时,优先使用 discountId 对应的营销算价信息)
| 2.52.0.3 |
poiId | string | | 否 | 门店id,取值优先级:poiId > 货架/直播间的poiId > deliveryInfo里的poiId | |
businessLine | number | 1 | 否 | 业务线
| 2.52.0.3 |
deliveryInfo | DeliveryInfo DeliveryInfo 说明在下文 | | 否(businessLine = 3 时,必填) | 配送信息 | 2.51.0.0 |
addressInfo | AddressInfo AddressInfo 说明见下文 | | 否(businessLine = 3 ,必填) | 地址信息 | 2.51.0.0 |
success | Function | | 否 | 接口调用成功的回调函数 | |
fail | Function |
