# 下单前置检查
# 接口调用请求说明
该接口基础库版本 >= 2.23.0 支持
适用于接入自定义交易组件的小程序在创建订单前进行调用。
1,相对于旧版/shop/scene/check
接口,基础库接口隐藏了场景值概念(场景值只是判断视频号自定义交易组件业务的一部分);
2,返回了trace_id,对推广员分享员归因不再依赖于微信支付,通过api创建订单的时候即可完成订单归属;
3,区分业务,对于接入带货中心且接入交易组件的商家,/shop/scene/check
无法区分订单是哪个业务,从而会对于视频号订单一刀切,返回"需要订单"的语意,导致订单需要传输两份。基础库接口则保留了上下文,支持区分业务。
# wx.checkBeforeAddOrder(Object args)
使用示例
wx.checkBeforeAddOrder({
success (res) { },
fail (res) { }
})
# 成功回包示例
{
"errcode": 0,
"errmsg": "",
"requireOrder": 1,
"requiredFundType": 1,
"traceId": "1_lkbvxXM-MpYZMC5hoIa8c1rqdFyUjMLoKNYsaKBFRoE"
}
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码,用于debug,此接口高可用,一般不会报错 |
errmsg | string | 错误信息,用于debug,此接口高可用,一般不会报错 |
requireOrder | enum | 是否需要推单,1:需要,0:不需要 |
requiredFundType | enum | requireOrder = 1时生效,0,非二级商户号订单,1,二级商户号订单,2,两种方式皆可(后续只会存在1) |
traceId | string | 跟踪ID,有效期十分钟,会影响主播归因、分享员归因等,需创建订单前调用,调用生成订单api时需传入该参数 |