接入前准备

1. 接入模式选择

商户/机构在接入前首先要判断自己公司注册区域适用的接入模式，微信跨境支付目前提供三种接入方式：直连模式、机构模式、普通服务商模式。

1.1. 直连模式

商户与微信跨境支付接口直接对接，微信支付直接将交易资金结算给商户。该接入模式目前仅在香港及英国开放，具体接入流程及资质要求，请参考直连模式入驻指引。

1.2. 机构模式

机构模式下，由收单机构对接微信支付API并二次封装接口提供给商户，微信支付会将交易资金结算给收单机构，由收单机构机构结算给商户。目前该接入模式在所有微信跨境支付开放接入的区域均可使用，也是微信跨境支付主要的对接方式。具体接入流程及资质要求，请参考机构模式入驻指引。若你想了解所在区域已和微信支付合作的收单机构，可点击查看。

1.3. 普通服务商模式

普通服务商模式下，由普通服务商对接微信支付API并二次封装接口提供给商户。普通服务商仅处理交易信息流，不触碰资金流，交易资金将会直接结算给商户。该接入模式目前仅在香港开放，具体接入流程及资质要求，请参考普通服务商模式入驻指引。

请结合自身实际情况及所在国家或地区来选择接入模式。

2. 申请指引

1申请商户号mch_id

机构或直连商户在入驻微信支付时，都需要先申请一个收款账号，该账号即是mch_id，其申请地址如下： 商户号申请指引
申请成功后，微信支付会向机构填写的联系邮箱下发通知邮件，内容包含申请成功的mch_id及其登陆账号密码，请妥善保存。示例如下：

注意

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

2申请APPID

由于微信支付的产品体系全部搭载于微信的社交体系之上，所以直连商户或机构接入微信跨境支付时，还需要有一个微信社交载体，该载体对应的ID即为APPID。

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

公众号申请成功后，机构登陆公众号平台即可获取对应的APPID，具体查阅目录为Development->Basic Configuration-> Official Account development information，如下图所示。通常情况下，一个机构只需申请一个公众号即可。

3绑定MCHID与APPID

APPID和mch_id全部申请完毕后，需要建立两者之间的绑定关系。
机构可登陆商户平台，在顶部tab中选择Dev Configuration，即可进入绑定操作页面。若平台提示绑定失败，可联系对应bd或助理人员完成绑定。
机构模式下，一个APPID下可绑定多个mch_id，但一个mch_id仅可绑定到一个APPID。

为了便于理解举例如下：
APPID为社交载体，可以想象它为一个实体个人。
mch_id为收款账户，可以想象它为一个银行账号。
一个实体个人可以拥有多个银行账号，但一个银行账号仅可为一个实体个人拥有。

4子商户入驻

上述步骤操作完成后，即会向机构开放入驻子商户权限。

机构可登陆商户平台进入Institution界面完成子商户入驻，或使用入驻子商户API来完成入驻。

3. 开发参数配置

3.1. 配置API Key v3

API Key v3主要用于对接口传输中的敏感信息进行加密及解密，具体加解密规则可参考敏感信息加解密。

API Key v3配置流程如下

1 登录微信商户平台，进入"Account Settings" > "API Security" > "Set APIv3 Secret"目录，点击 Set APIv3 secret 。

2输入APIv3 key，内容为32位字符，包括数字及大小写字母。点击 Confirm 以进行下一步。

3输入设置的Pin code，并获取短信验证码。输入验证码后点击 OK 即完成设置。

4点击Confirm以退出对话框。

5完成

3.2. 下载并配置商户证书

商户证书用于机构/直连商户进行传输内容的签名和验签。

机构可登陆微信商户平台，在Account Settings->API Security->API Certificate目录下载证书

以下为具体下载步骤：

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

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

3安装证书工具并打开，选择证书需要存储的路径后点击 Request Certificate。

4在商户平台弹窗 Apply API Certificate > Obtian Certificate Signing Request 中，点击 click here 以复制商户信息。

5在证书工具中，将复制的商户信息黏贴并点击 Next 。

6获取请求串

步骤1在证书工具“Copy request string”中，点击“Copy”以复制请求串。

步骤2在商户平台弹窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，黏贴请求串到输入框内。

步骤3在商户平台弹窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，输入短信验证码及登录密码。

步骤4在商户平台弹窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，点击“Next”进入“Get certificate”页面。

7获取证书串

步骤1在商户平台弹窗“Apply API Certificate” > “Get Certificate”中，点击“copy”以获取证书串。

步骤2在证书工具“Copy request string”中，点击“Next”进入“Paste certificate string”页面。

步骤3在证书工具“Paste certificate string”中，点击“Paste”以黏贴从平台弹窗复制的证书串。

步骤4在证书工具“Paste certificate string”中，点击“Next”以生成证书。

8在证书工具“Generate certificate”中，该页面表示证书已申请成功。点击 View folder 可打开证书存在的路径以核验证书。

9完成

3.3. 配置网页授权域名

公众号支付产品能力需要在发起支付前通过网页授权auth2的形式获取用户的openid（openid介绍请参考重要参数），以校验下单人与最终支付人是否为同一个人。用于auth2授权的域名，需要在机构的公众号平台进行配置，配置目录为Settings->Account Info->Function Setting，配置页面如下图所示：

有关网页授权获取openid的详细说明及操作步骤，请参考网页授权开发。

3.4. 配置支付目录

公众号支付产品能力是在微信内的网页通过前端JSAPI来拉起微信支付，为保障安全，拉起微信支付收银台的网页目录需要在微信支付商户平台进行配置。

操作说明：

• 若为直连商户，请登录微信支付商户平台，直接进入development configuration菜单进行配置

• 若为机构模式，且机构下的子商户用于拉起微信支付收银台的网页属于同一目录下，可将支付目录配置在机构商户号下，将对所有子商户都生效可用，此时请登录微信支付商户平台，进入development configuration菜单，具体页面如下图所示：

若为机构模式，但机构下的子商户用于拉起微信支付收银台的网页属于不同目录下，可将支付目录配置在子商户号下，将仅对该子商户号生效，此时请登录微信支付商户平台，进入Institution->Sub-Merchant->Application菜单，找到具体要配置的子商户，点击Config进入配置页面，找到Payment Authorization Config区域，具体页面如下

支付目录说明：

• 支付目录指的是页面url最后一个“/”之前的内容，例如页面url为http://abc123.abc123.abc/abc123，则其支付目录为http://abc123.abc123.abc/

• 当支付目录配置为顶级域名，则只校验顶级域名，不校验后缀。即如果配置到http://abc123.abc123.abc/，则http://abc123.abc123.abc/abc123和http://abc123.abc123.abc/abc123/abc123都可以拉起收银台

• 当配置多级目录，则会进行全匹配。即如果配置http://abc123.abc123.abc/abc123/，只有http://abc123.abc123.abc/abc123/可以拉起收银台，http://abc123.abc123.abc/和http://abc123.abc123.abc/abc123/abc123/都无法拉起收银台。