接入前准备

1.选择接入模式

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

● 直连模式:

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

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


● 服务商模式:

    —— 信息流    —— 资金流

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

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

2.参数申请

2.1.直连模式参数申请

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

  • 1申请APPID

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

    对于直连商户,该社交载体可以是公众号(什么是公众号),小程序(什么是小程序)或APP。

    如申请社交载体为公众号,请前往以下链接: 公众号申请指引

    如申请社交载体为小程序,请前往以下链接: 小程序申请指引

    如商户已拥有自己的APP,且希望该APP接入微信支付,请前往以下地址注册APP: APP注册指引

    商户可根据自己实际的业务需求来选择申请不同的社交载体。

    各类社交载体一旦申请成功后,可以登录对应平台查看账号信息以获取对应的appid。

  • 2申请mch_id

    申请mch_id和APPID的操作互不影响,可以并行操作,申请地址如下: 商户号申请平台

    申请成功后,会向机构填写的联系邮箱下发通知邮件,内容包含申请成功的mch_id及其登录账号密码,请妥善保存。

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

  • 3绑定APPID及mch_id

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

    直连模式下,APPID与mch_id之间的关系为多对多,即一个APPID下可以绑定多个mch_id,而一个mch_id也可以绑定多个APPID。

  • 完成

2.2.服务商模式参数申请
  • 1申请APPID

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

    目前机构的社交载体只能是公众号,请通过以下链接申请公众号: 公众号申请指引

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

  • 2申请mch_id

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

    申请成功后,会向机构填写的联系邮箱下发通知邮件,内容包含申请成功的mch_id及其登录账号密码,请妥善保存。

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

  • 3绑定APPID及mch_id

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

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

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

    为了便于理解举例如下:

    APPID为社交载体,可以想象它为一个实体个人。

    mch_id为收款账户,可以想象它为一个银行账号。

    一个实体个人可以拥有多个银行账号,但一个银行账号仅可为一个实体个人拥有。

  • 4入驻子商户

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

    机构可登录服务商平台进入“服务商功能”界面完成子商户入驻。

  • 完成

3.配置API key

API Key主要用于对传输信息生成签名,具体使用方式可参见API文档中签名算法章节。

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

  • 1登录微信商户平台,进入"账户中心" > "API安全" > "API安全"目录,点击"设置秘钥"。

  • 2在弹出窗口中点击“已沟通”。

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

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

  • 完成

4.下载并配置商户证书

当调用涉及资金回滚或某些敏感操作的接口时(包括退款,撤销,入驻子商户等),需要使用商户证书来校验机构身份。

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

以下为具体下载步骤:

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

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

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

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

  • 5获取请求串

  • 6生成证书求串

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

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

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

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

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

  • 完成

5.合单-JSAPI下单

设置支付目录

支付授权目录说明

1)商户最后请求拉起微信支付收银台的页面地址我们称之为“支付目录”,例如:https://www.weixin.com/pay.php。

2)商户实际的支付目录必须和在微信支付商户平台设置的一致,否则会报错“当前页面的URL未注册:”


支付授权目录设置说明

登录【微信支付商户平台—>产品中心—>开发配置】,设置后一般5分钟内生效。


支付授权目录校验规则说明

1)如果支付授权目录设置为顶级域名(例如:https://www.weixin.com/ ),那么只校验顶级域名,不校验后缀;

2)如果支付授权目录设置为多级目录,就会进行全匹配,例如设置支付授权目录为https://www.weixin.com/abc/123/,则实际请求页面目录不能为https://www.weixin.com/abc/,也不能为https://www.weixin.com/abc/123/pay/,必须为https://www.weixin.com/abc/123/

设置授权域名

开发JSAPI支付时,在JSAPI下单接口中要求必传用户openid,而获取openid则需要您在公众平台设置获取openid的域名,只有被设置过的域名才是一个有效的获取openid的域名,否则将获取失败。具体界面如图所示:

开通流程详见:《JSAPI支付

6.合单-Native下单

线上扫码收银台界面规范

示例1:单独显要区域,常驻微信支付

示例2:单独页签+页签首位+新logo+推荐标签+直接二维码

开通流程详见:《Native支付

7.合单-APP下单

APP商户截图规范

APP商户申请时,如选择提供截图,请参见《微信支付APP商户截图标准》提供APP首页截图、APP尾页截图、APP应用内截图和APP支付页截图。

APP收银台界面规范

列表首位+默认勾选+标准logo+推荐标签+标语

素材下载:《微信支付logo、APP支付素材下载

开通流程详见:《APP支付

8.合单-H5下单

准备工作

1、H5支付域名

2、售卖产品/使用场景的描述

3、所售卖产品对应的官方网站域名或详情页网址

开通流程详见:《H5支付

9.合单-小程序下单

账号申请指引

1、申请小程序开发者账号,进行微信认证,获取appid登录《微信公众平台》,注册一个小程序的开发者账号。小程序账号申请指引


2、小程序开通微信支付,即申请或复用微信支付商户号 申请完小程序后,登录小程序后台(mp.weixin.qq.com)。点击左侧导航栏的微信支付,在页面中进行开通。


点击开通按钮后,有2种方式可以获取微信支付能力,新申请微信支付商户号或绑定一个已有的微信支付商户号,请根据你的业务需要和具体情况选择,只能二选一。



技术咨询

反馈有奖