APPID配置规则

一、APPID与商户号(MCHID)绑定关系解释

1、什么是绑定关系

对于商户,想通过微信去触达用户、服务用户,则需要以小程序、公众号等形态去实现,这时商户需要在公众平台或开放平台注册账号,每一个账号背后都对应一个开发者ID(APPID)。

出于安全隐私的角度,在商户连接用户时,微信不会直接把用户的微信号(WechatId)予以暴露,而是通过OPENID去实现触达,实现服务。同一个微信用户,在不同APPID下,openid不一样。简单理解:WechatID+APPID=OPENID。

同样,对于商户想要使用微信支付提供的服务,比如支付体系接入,营销优惠券体系接入,都需要在微信支付侧开立账号,即开通商户号(MCHID)。商户号记录交易资金往来,提供各种支付、营销能力。

微信支付是在微信生态上的产品服务能力。所以涉及到与用户的交互操作,比如公众号支付的统一下单,优惠券发放等都需要公众平台APPID与商户号MCHID打通交互。是否能做这样的业务打通交互,即验证APPID与MCHID之间是否有绑定关系。


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

3、 如何绑定

3.1、MCHID-APPID

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

已绑定APPID信息查看与新增绑定关系:(适用于普通直连商户【模式1】、普通服务商特约商户【模式1】、普通服务商【模式2】、渠道商【模式5】)

登录商户平台> 产品中心 > APPID账号管理 > 我关联的APPID账号

绑定操作指引:点击查看


注意:Westore商户接入微信支付,其申请得到商户号123,Westore有自己的小程序APPID为ABC。完成对应操作,即可创建123(MCHID)---ABC(APPID)的绑定关系。


3.2、MCHID-mchid-SubAPPID

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

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

登录商户平台(Pay.weixin.qq.com)> 服务商功能 > 特约商户管理 > 开发配置 > 特约商户APPID配置

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

登录商户平台(Pay.weixin.qq.com)> 产品中心 > APPID账号管理 > 服务商为我关联的APPID账号

绑定操作指引:点击查看


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

二、商家券业务中APPID配置使用规则

1、创建商家券

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

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

1) 涉及的商户号有

批次创建商户号(接口签名商户号)、批次归属商户号(belong_merchant);

2) 涉及的APPID有

立即使用跳转小程序(以下统称:use_method_appid)、自定义入口小程序以及公众号(以下统称:custom_entrance_appid)、事件通知APPID(以下统称:notify_config_appid);


1.1、普通商户模式

该模式适用于商户自己给自己制券。

1)商户号校验:

创建商户号与归属商户号是同一个商户号,即批次创建商户号 = 批次归属商户号;

2)APPID校验:

模式1,即MCHID(普通商户,归属商户号)--- APPID;


1.2 普通服务商模式

1)商户号校验:

批次创建商户号 = 普通服务商;批次归属商户号 = 特约商户商户号;校验创建商户号与归属商户号之间是否有服务商与特约商户的父子受理关系;

2)APPID校验:(APPID满足以下任一模式均可)

模式1,即MCHID(特约商户,归属商户号)--- APPID;

模式2,即MCHID(普通服务商,创建商户号)--- APPID;

模式3,即MCHID(普通服务商,创建商户号)--- mchid(特约商户,归属商户号)---SubAPPID;


1.3、间联渠道商模式

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

1)商户号校验:

批次创建商户号 = 渠道商;批次归属商户号 = 特约商户商户号;校验创建商户号与归属商户号之间是否有渠道商与特约商户的渠道拓展关系;

2)APPID校验:(APPID满足以下任一模式均可)

模式5,即MCHID(渠道商,创建商户号)--- APPID;

模式6,即MCHID(收单机构)--- mchid(特约商户,归属商户号)---SubAPPID;

2、发放商家券(小程序发券&H5发券)

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

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

1) 涉及的商户号有:

调用该API接口的商户号,即为商家券批次的发放商户号。

2) 涉及的APPID有:

接入小程序插件的小程序APPID,或H5发券接口中传入的OPENID背后的APPID,以下统称为发券场景APPID。


2.1、普通商户模式

该模式适用于商户自己制券自己发券。

1)商户号校验:

即谁制券谁调用接口发券,该模式会校验制券商户号是否未发放批次的创建商户号,即发券商户号 = 批次创建商户号;

2)APPID校验:

模式1,即MCHID(普通商户,批次归属商户号=批次发放商户号)--- APPID(发券场景APPID);


2.2、普通服务商模式

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

1)商户号校验:

批次发放商户号 = 批次创建商户号 = 普通服务商;

2)APPID校验:(APPID满足以下任一模式均可)

模式1,即MCHID(特约商户,归属商户号)--- APPID(发券场景APPPID);
模式2,即MCHID(普通服务商,创建商户号=发放商户号)--- APPID(发券场景APPID);
模式3,即MCHID(普通服务商,创建商户号=发放商户号)--- mchid(特约商户,归属商户号)---SubAPPID(发券场景APPID);


2.3、间联渠道商模式

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

1)商户号校验:

批次发放商户号 = 批次创建商户号 = 渠道商;

2)APPID校验:(APPID满足以下任一模式均可)

模式5,即MCHID(渠道商,创建商户号=发放商户号)--- APPID(发券场景APPPID);
模式6,即MCHID(收单机构)--- mchid(特约商户,归属商户号)---SubAPPID(发券场景APPID);


3、查询用户卡包里商家券

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

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

1) 涉及的商户号有:

调用该API接口的商户号,即为商家券批次的发放查询商户号(以下统称为批次查询商户号)。接口内部还涉及批次的创建商户号(creator_merchant)、批次发放商户号(sender_merchant)、批次归属商户号(belong_merchant);

2) 涉及的APPID有:

因为查用户卡包的券信息,涉及用户信息的交互,就需要用户OPENID,因此需要传入用户身份识别APPID(以下统称为用户识别APPID),有如下校验规则:


3.1、普通商户模式

该模式适用于商户自己查询自己发的券 or 自己创建的券 or 归属于自己的券。

1)商户号校验

批次查询商户号 = 批次创建商户号 = 批次归属商户号 = 批次发放商户号;

2)APPID校验

模式1,即MCHID(普通商户,批次发放商户号=批次创建商户号=批次归属商户号=批次查询商户号)--- APPID(用户识别APPID);


3.2、普通服务商模式

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

1)商户号校验:

批次查询商户号= 批次发放商户号 = 批次创建商户号 = 普通服务商;
批次归属商户号 = 特约商户号;

2)APPID校验:(APPID满足以下任一模式均可)

模式1,即MCHID(特约商户,归属商户号)--- APPID(用户识别APPID);
模式2,即MCHID(普通服务商,查询商户号=创建商户号=发放商户号)--- APPID(用户识别APPID);
模式3,即MCHID(普通服务商,查询商户号=创建商户号=发放商户号)--- mchid(特约商户,归属商户号)---SubAPPID(用户识别APPID);


3.3、间联渠道商模式

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

1)商户号校验:

批次查询商户号= 批次发放商户号 = 批次创建商户号 = 渠道商;
批次归属商户号 = 特约商户号;

2)APPID校验:(APPID满足以下任一模式均可)

模式5,即MCHID(渠道商,查询商户号=创建商户号=发放商户号)--- APPID(用户识别APPID);
模式6,即MCHID(收单机构)--- mchid(特约商户,归属商户号)---SubAPPID(用户识别APPID);

4、核销商家券

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

1)、涉及的商户号有:

调用该API接口的商户号,即为商家券批次的核销商户号。当前商家券的规则是谁制券谁核销,所以无论任何模式下,核销商户号一定等于批次创建商户号。

2) 涉及的APPID有:

同样因为涉及涉及用户信息的交互,就需要用户OPENID,因此需要传入用户身份识别APPID(以下统称为用户识别APPID),有如下校验规则:


4.1、普通商户模式

该模式适用于商户核销券。

1)商户号校验

批次核销商户号 = 批次创建商户号;

2)APPID校验

模式1,即MCHID(普通商户,批次归属商户号)--- APPID(用户识别APPID);


4.2、普通服务商模式

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

1)商户号校验:

批次核销商户号 = 批次创建商户号 = 普通服务商;

2)APPID校验:(APPID满足以下任一模式均可)

模式1,即MCHID(特约商户,归属商户号)--- APPID(用户识别APPID);
模式2,即MCHID(普通服务商,创建商户号)--- APPID(用户识别APPID);
模式3,即MCHID(普通服务商,创建商户号)--- mchid(特约商户,归属商户号)---SubAPPID(用户识别APPID);


4.3、间联渠道商模式

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

1)商户号校验:

批次核销商户号 = 批次创建商户号 = 渠道商;

2)APPID校验:(APPID满足以下任一模式均可)

模式5,即MCHID(渠道商,创建商户号)--- APPID(用户识别APPID);
模式6,即MCHID(收单机构)--- mchid(特约商户,归属商户号)---SubAPPID(用户识别APPID);



技术咨询

文档反馈