在正式接入微信支付商家券服务前，你需要进行以下准备步骤：

1. 选择接入模式：普通商户或普通服务商
2. 申请参数：AppID、商户号
3. 操作指引
4. AppID与商户号（MCHID）绑定关系解释
5. 配置使用规则

1. 选择接入模式

商户需要判断自己公司注册区域适用的接入模式和自身实际情况，申请成为普通商户或普通服务商：

• 普通商户自行申请入驻微信支付，无需服务商协助。
• 普通服务商则自身无法作为一个普通商户直接发起交易，其发起交易必须传入相关特约商户商户号的参数信息。

具体接入模式介绍请参考接入模式文档，并按照参考文档完成相应模式的接入。

2. 申请参数

请根据自身接入模式分别参考微信支付接入准备-普通商户或微信支付接入准备-普通服务商中的参数申请 - 配置API key - 下载并配置商户证书三个步骤申请接入参数。

3. 操作指引

3.1. 创建商家券

可通过调用创建商家券接口创建商家券，当前支持创建的商家券类型包含满减券、换购券和折扣券三种。

3.2. 发放商家券

当前支持在商家小程序、H5、支付有礼、扫码领券、小程序直播、搜一搜中派发商家券，具体操作流程和文档请参见：微信支付券。

提示

商家的小程序需要先申请开通该发券插件的权限后，才可进行开发。申请审核1个工作日完成。

3.3. 核销商家券

可通过调用核销用户券接口核销用户券。

3.4. 管理商家券

可通过调用查询商家券批次信息、根据过滤条件查询用户券、查询用户券详情接口管理商家券。

4. 绑定关系

4.1. 什么是绑定关系

• 对于服务商，想通过微信去触达用户、服务用户，则需要以小程序、公众号等形态去实现，这时服务商需要在公众平台或开放平台注册账号，每一个账号背后都对应一个开发者ID（AppID）。
• 出于安全隐私的角度，在服务商连接用户时，微信不会直接把用户的微信号（WechatId）予以暴露，而是通过OpenID去实现触达，实现服务。同一个微信用户，在不同AppID下，OpenID不一样。简单理解：WechatID+AppID=OpenID。
• 同样，对于服务商想要使用微信支付提供的服务，比如支付体系接入，营销优惠券体系接入，都需要在微信支付侧开立账号，即开通商户号（MCHID）。商户号记录交易资金往来，提供各种支付、营销能力。
• 微信支付是在微信生态上的产品服务能力。所以涉及到与用户的交互操作，比如公众号支付的JSAPI下单，优惠券发放等都需要公众平台AppID与商户号MCHID打通交互。是否能做这样的业务打通交互，即验证AppID与MCHID之间是否有绑定关系。

4.2. 绑定模式

以本商户号为视角，有以下绑定关系：

业务模式	商户角色	MCHID与AppID绑定关系模式
直连模式	普通商户	模式1：MCHID（普通商户）- AppID
直连模式	普通服务商	模式2：MCHID（普通服务商）- AppID
直连模式	特约商户（直连角色）	模式1：MCHID（特约商户）- AppID
直连模式	特约商户（普通服务商下特约商户角色）	模式3：MCHID（普通服务商）- mchid（特约商户）-SubAPPID
间联模式	收单机构	模式4：MCHID（收单机构）- AppID
间联模式	渠道商	模式5：MCHID（渠道商）- AppID
间联模式	特约商户	模式6：MCHID（收单机构）- mchid（特约商户）-SubAPPID

4.3. 如何绑定

4.3.1. MCHID-AppID

该模式更多适用于普通普通商户、普通服务商、渠道商操作本商户号与AppID的绑定关系。

已绑定AppID信息查看与新增绑定关系： （适用于普通商户【模式1】、普通服务商特约商户【模式1】、普通服务商【模式2】、渠道商【模式5】）

登录微信服务商平台 (opens new window)> 产品中心 > AppID账号管理 > 我关联的AppID账号

绑定操作指引： 点击查看 (opens new window)

注意

Westore商户接入微信支付，其申请得到商户号123，Westore有自己的小程序AppID为ABC。完成对应操作，即可创建123（MCHID）---ABC（AppID）的绑定关系。

4.3.2. MCHID-mchid-SubAPPID

该模式更多适用于普通模式下特约商户模式、间联模式下特约商户操作商户号与AppID的绑定关系。

服务商管理特约商户已绑定SubAPPID和新增绑定关系：（适用于普通服务商【模式3】、渠道商【模式6】）

登录服务商平台 (opens new window) > 服务商功能 > 特约商户管理 > 开发配置 > 特约商户AppID配置

特约商户查看服务商为其配置的SubAPPID：（适用于普通服务商特约商户【模式3】）

登录服务商平台 (opens new window) > 产品中心 > AppID账号管理 > 服务商为我关联的AppID账号

绑定操作指引：点击查看 (opens new window)

注意

Westore商户由服务商XXX（商户号456）接入微信支付，其申请得到商户号123，Westore有自己的小程序AppID为ABC。完成对应操作，即可创建456（服务商MCHID）---123（特约商户MCHID）---ABC（SubAPPID）的绑定关系。

5. 配置使用规则

5.1. 创建商家券

商家券创建API接口文档：点击查看

调用该API接口的商户号，即V3接口头部参数签名中的商户号，即为商家券批次的创建商户号。整个接口调用中：

• 涉及的商户号有
  • 批次创建商户号（接口签名商户号）、批次归属商户号（belong_merchant）；
• 涉及的AppID有
  • 立即使用跳转小程序（以下统称：use_method_appid）、自定义入口小程序以及公众号（以下统称：custom_entrance_appid）、事件通知AppID（以下统称：notify_config_appid）；

5.1.1. 普通服务商模式

• 商户号校验：
  • 批次创建商户号 = 普通服务商；批次归属商户号 = 特约商户商户号；校验创建商户号与归属商户号之间是否有服务商与特约商户的父子受理关系；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式1，即MCHID（特约商户，归属商户号）--- AppID；
  • 模式2，即MCHID（普通服务商，创建商户号）--- AppID；
  • 模式3，即MCHID（普通服务商，创建商户号）--- mchid（特约商户，归属商户号）---SubAPPID；

5.1.2. 间联渠道商模式

该模式适用于渠道商给特约商户制券。

• 商户号校验：
  • 批次创建商户号 = 渠道商；批次归属商户号 = 特约商户商户号；校验创建商户号与归属商户号之间是否有渠道商与特约商户的渠道拓展关系；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式5，即MCHID（渠道商，创建商户号）--- AppID；
  • 模式6，即MCHID（收单机构）--- mchid（特约商户，归属商户号）---SubAPPID；

5.2. 发放商家券（小程序发券&H5发券）

商家券小程序发券接口文档：点击查看

商家券H5发券接口文档：点击查看

• 涉及的商户号有：
  • 调用该API接口的商户号，即为商家券批次的发放商户号。
• 涉及的AppID有：
  • 接入小程序插件的小程序AppID，或H5发券接口中传入的OpenID背后的AppID，以下统称为发券场景AppID。

5.2.1. 普通服务商模式

该模式适用于普通服务商给特约商户，并给特约商户发券。

• 商户号校验：
  • 批次发放商户号 = 批次创建商户号 = 普通服务商；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式1，即MCHID（特约商户，归属商户号）--- AppID（发券场景AppID）；
  • 模式2，即MCHID（普通服务商，创建商户号=发放商户号）--- AppID（发券场景AppID）；
  • 模式3，即MCHID（普通服务商，创建商户号=发放商户号）--- mchid（特约商户，归属商户号）---SubAPPID（发券场景AppID）；

5.2.2. 间联渠道商模式

该模式适用于渠道商给特约商户，并给特约商户发券。

• 商户号校验：
  • 批次发放商户号 = 批次创建商户号 = 渠道商；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式5，即MCHID（渠道商，创建商户号=发放商户号）--- AppID（发券场景AppID）；
  • 模式6，即MCHID（收单机构）--- mchid（特约商户，归属商户号）---SubAPPID（发券场景AppID）；

5.3. 查询用户卡包里商家券

根据过滤条件查询用户券API接口文档：点击查看

查询用户单张券API接口文档：点击查看

• 涉及的商户号有：
  • 调用该API接口的商户号，即为商家券批次的发放查询商户号（以下统称为批次查询商户号）。接口内部还涉及批次的创建商户号（creator_merchant）、批次发放商户号（sender_merchant）、批次归属商户号（belong_merchant）；
• 涉及的AppID有：
  • 因为查用户卡包的券信息，涉及用户信息的交互，就需要用户OpenID，因此需要传入用户身份识别AppID（以下统称为用户识别AppID），有如下校验规则：

5.3.1. 普通服务商模式

该模式适用于普通服务商给特约商户制券发券，并查券的场景。

• 商户号校验：
  • 批次查询商户号= 批次发放商户号 = 批次创建商户号 = 普通服务商；
  • 批次归属商户号 = 特约商户号；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式1，即MCHID（特约商户，归属商户号）--- AppID（用户识别AppID）；
  • 模式2，即MCHID（普通服务商，查询商户号=创建商户号=发放商户号）--- AppID（用户识别AppID）；
  • 模式3，即MCHID（普通服务商，查询商户号=创建商户号=发放商户号）--- mchid（特约商户，归属商户号）---SubAPPID（用户识别AppID）；

5.3.2. 间联渠道商模式

该模式适用于渠道商给特约商户，并给特约商户发券查券。

• 商户号校验：
  • 批次查询商户号= 批次发放商户号 = 批次创建商户号 = 渠道商；
  • 批次归属商户号 = 特约商户号；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式5，即MCHID（渠道商，查询商户号=创建商户号=发放商户号）--- AppID（用户识别AppID）；
  • 模式6，即MCHID（收单机构）--- mchid（特约商户，归属商户号）---SubAPPID（用户识别AppID）；

5.4. 核销商家券

核销用户商家券接口文档：点击查看

• 涉及的商户号有：
  • 调用该API接口的商户号，即为商家券批次的核销商户号。当前商家券的规则是谁制券谁核销，所以无论任何模式下，核销商户号一定等于批次创建商户号。
• 涉及的AppID有：
  • 同样因为涉及用户信息的交互，就需要用户OpenID，因此需要传入用户身份识别AppID（以下统称为用户识别AppID），有如下校验规则：

5.4.1. 普通服务商模式

该模式适用于普通服务商给特约商户制券发券，并核券的场景。

• 商户号校验：
  • 批次核销商户号 = 批次创建商户号 = 普通服务商；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式1，即MCHID（特约商户，归属商户号）--- AppID（用户识别AppID）；
  • 模式2，即MCHID（普通服务商，创建商户号）--- AppID（用户识别AppID）；
  • 模式3，即MCHID（普通服务商，创建商户号）--- mchid（特约商户，归属商户号）---SubAPPID（用户识别AppID）；

5.4.2. 间联渠道商模式

该模式适用于渠道商给特约商户，并核券场景。

• 商户号校验：
  • 批次核销商户号 = 批次创建商户号 = 渠道商；
• AppID校验：（AppID满足以下任一模式均可）
  • 模式5，即MCHID（渠道商，创建商户号）--- AppID（用户识别AppID）；
  • 模式6，即MCHID（收单机构）--- mchid（特约商户，归属商户号）---SubAPPID（用户识别AppID）；