# 前言

请先阅读业务接入指引

# 1. 接入

# 1.1 申请接入

# 方式一、MP接入

在微信公众平台登录小程序，选择自定义版交易组件，并申请开通功能，进入审核流程。商家也可以通过调用申请接入的接口申请开通功能。

# 方式二、API接口

调用申请接入接口

# 1.2 接入查询

# 方式一、MP查看

# 方式二、API接口

调用查询接入接口

# 2. 上传商品

对于部分场景，比如视频号直播，想在橱窗上架商品进行直播带货，必须事先通过API把商品上传到交易组件中台

# 2.1 获取类目列表，检查商品对应的类目是否需要事先申请资质

调用获取类目列表接口

# 2.2 上传类目资质

调用上传类目接口

等待类目审核回调

# 2.3 上传品牌资质

调用上传品牌接口

等待品牌审核回调

# 2.4 新增商品

调用添加商品接口

等待商品审核回调

# 3. 支付校验

对于部分场景，比如视频号直播，想在橱窗上架商品进行直播带货，必须事先通过API把商品上传到交易组件中台

详细场景说明请跳转场景接入指引

# 3.1 开发环境打开支付校验

# 小程序在开发分支流程 app.json 中添加以下参数设置（该参数只对开发环境生效，代码发布后该参数失效，即正式版小程序是否打开支付校验只与下文3.2相关）

"usingShopPlugin": true；

# 3.2 判断当下是否需要受控商户号订单（同步合规的订单到微信侧）

商家前端先通过getEnterOptionsSync或onShow拿到小程序当前场景值scene

再通过检查场景值是否在支付校验范围内接口判断该 scene是否需要支付校验

# 3.3 支付校验说明

支付校验的目的是确保交易组件的使用过程中，保证数据可靠性，同时保障用户的权益。

需要调用同步订单接口，订单里的商品不需要一定是商品库的商品，但是需要尽量按照商品库的out_product_id、out_sku_id传输，这些会影响到数据统计。

1，非二级商户号订单（order.fund_type = 0）需要通过后台api同步订单，并在用户支付后同步支付结果。

2，二级商户号订单（order.fund_type = 1）需要从交易组件获取支付参数（不再从微信支付获取支付参数），小程序前端使用新的收银台jsapi wx.requestOrderPayment。

是否是一笔二级商户号订单，是根据场景值来决定校验场景值：

注：因为开发者接入阶段未开通视频号场景，所以无法触发支付校验，达到调试目的，故在开发者工具中提供测试场景值10001，请设置此场景，并拉起收银台，如果拉起成功，证明可以通过支付校验

模拟场景值测试之后如果支付正常，可以发布正式版，然后发起一个指定观众的直播间来验证线上支付流程。

# 3.4 订单流转

调用订单发货、订单确认收货、生成售后完成订单状态流转。

# 3.5 发布代码，对线上环境生效

完成接口对接及商品上传后，提交代码至微信团队审核，审核通过后即可发布，此时支付校验正式生效