商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

接入前准备

1.选择接入模式

商户/服务商在接入前首先要判断自己公司注册区域适用的接入模式,微信支付目前提供两种接入方式:直连模式和服务商模式。

● 直连模式:

信息、资金流:微信支付—>直连商户

直连模式,商户自行申请入驻微信支付,无需服务商协助。(商户平台申请)成为普通商户

直连模式相关说明详见:直连模式介绍


● 服务商模式:

    —— 信息流    —— 资金流

服务商模式,商户申请成为微信支付服务商,服务商自身无法作为一个普通商户直接发起交易,其发起交易必须传入相关特约商户商户号的参数信息。(服务商平台申请)成为普通服务商

请结合自身实际情况来选择接入模式。

2.参数申请

  • 1申请APPID

    由于微信支付的产品体系全部搭载于微信的社交体系之上,所以直连商户或服务商商户接入微信支付之前,都需要有一个微信社交载体,该载体对应的ID即为APPID。

    目前服务商的社交载体只能是公众号,服务商可通过公众平台完成公众号注册申请。

    公众号申请成功后,服务商可登录公众号平台即可获取对应的APPID,具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】,如下图所示。通常情况下,一个服务商只需申请一个公众号即可。

  • 2申请mchid

    服务商的收款账号即是mchid,申请mchid和APPID的操作互不影响,可以并行操作,申请地址如下: 商户号申请指引

    mchid申请成功后,微信支付将下发通知邮件至机构填写的联系邮箱,内容包含申请成功的mchid及其登录账号密码,请妥善保存。

    注意:一个mchid只能对应一个结算币种,若需要使用多个币种收款,需要申请对应数量的mchid。

  • 3绑定APPID及mchid

    APPID和mchid全部申请完毕后,需要建立两者之间的绑定关系。

    服务商可登录服务商平台,【产品中心-> AppID管理】目录下即可完成绑定。

    服务商模式下,一个APPID下可绑定多个mchid,但一个mchid仅可绑定到一个APPID。

  • 4入驻子商户

    上述步骤操作完成后,即会向服务商开放入驻子商户权限。

    服务商可登录服务商平台进入【服务商功能】界面完成子商户入驻。

  • 完成

3.配置API key

API v3密钥主要用于平台证书解密、回调信息解密,具体使用方式可参见接口规则文档中证书和回调报文解密章节。

请根据以下步骤配置API key:

  • 1登录微信服务商平台,进入【账户中心 > API安全 > API安全】目录,点击【设置密钥】。

  • 2在弹出窗口中点击【已沟通】。

  • 3输入API密钥,内容为32位字符,包括数字及大小写字母。点击获取短信验证码。

  • 4输入短信验证码,点击【确认】即设置成功。

  • 完成

4.下载并配置商户证书

商户API证书具体使用说明可参见接口规则文档中私钥和证书章节

服务商可登录微信服务商平台,在【账户中心 -> API安全 -> API证书】目录下载证书

以下为具体下载步骤:

  • 1从2018年底开始,微信支付新入驻机构及商户都将使用CA签发证书,在证书申请页面上点击“下载证书”。

  • 2在弹出窗口内点击“下载证书工具”按钮下载证书工具。

  • 3安装证书工具并打开,选择证书需要存储的路径后点击“申请证书”。

  • 4在证书工具中,将复制的商户信息粘贴并点击“下一步”。

  • 5获取请求串

  • 6生成证书串

    步骤1 在【商户平台】-“复制证书串”环节,点击“复制证书串”按钮后;

    步骤2 在【证书工具】-“复制请求串”环节,点击“下一步”按钮进入“粘贴证书串”环节;

    步骤3 在【证书工具】-“粘贴证书串”环节,点击“粘贴”按钮后;

    步骤4 点击“下一步”按钮,进入【证书工具】-“生成证书”环节

  • 7在【证书工具】-“生成证书”环节,已完成申请证书流程,点击“查看证书文件夹”,查看已生成的证书文件。

  • 完成

5. 操作指引

5.1. 创建商家券

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

5.2. 发放商家券

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


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

5.3. 核销商家券

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

5.4. 管理商家券

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

6. APPID与商户号(MCHID)绑定关系解释

6.1. 什么是绑定关系

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

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

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

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

6.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

6.3. 如何绑定

6.3.1. MCHID-APPID

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

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

登录微信服务商平台> 产品中心 > APPID账号管理 > 我关联的APPID账号

绑定操作指引:点击查看


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

6.3.2.MCHID-mchid-SubAPPID

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

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

登录微信服务商平台 > 服务商功能 > 特约商户管理 > 开发配置 > 特约商户APPID配置

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

登录微信服务商平台 > 产品中心 > APPID账号管理 > 服务商为我关联的APPID账号

绑定操作指引:点击查看


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

7. 商家券业务中APPID配置使用规则

7.1.创建商家券

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

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

1) 涉及的商户号有

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

2) 涉及的APPID有

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

7.1.1. 普通商户模式

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

1)商户号校验:

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

2)APPID校验:

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

7.1.2. 普通服务商模式

1)商户号校验:

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

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

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

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

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

7.1.3. 间联渠道商模式

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

1)商户号校验:

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

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

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

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

7.2. 发放商家券(小程序发券&H5发券)

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

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

1) 涉及的商户号有:

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

2) 涉及的APPID有:

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

7.2.1. 普通商户模式

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

1)商户号校验:

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

2)APPID校验:

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

7.2.2. 普通服务商模式

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

1)商户号校验:

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

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

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

7.2.3. 间联渠道商模式

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

1)商户号校验:

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

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

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

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

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

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

1) 涉及的商户号有:

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

2) 涉及的APPID有:

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

7.3.1. 普通商户模式

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

1)商户号校验

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

2)APPID校验

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

7.3.2. 普通服务商模式

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

1)商户号校验:

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

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

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

7.3.3. 间联渠道商模式

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

1)商户号校验:

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

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

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

7.4. 核销商家券

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

1)、涉及的商户号有:

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

2) 涉及的APPID有:

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

7.4.1. 普通商户模式

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

1)商户号校验

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

2)APPID校验

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

7.4.2. 普通服务商模式

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

1)商户号校验:

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

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

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

7.4.3. 间联渠道商模式

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

1)商户号校验:

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

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

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





技术咨询

文档反馈