# 下单前置检查

# 接口调用请求说明

该接口基础库版本 >= 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 时需传入该参数