接入前准备

更新时间:2026.09.20
|

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。

 

4. 子商户入驻

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

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

 

子商户入驻时可同时申请 H5 支付权限。在子商户入驻材料的 H5 支付申请模块,选择 YES,并填写相应的经营网址和支付域名,与子商户材料一并提交即可。

 

提交后可在申请结果中查看子商户入驻状态和 H5 支付权限申请状态。一般审核将在 20 分钟内完成,审核通过后系统会自动为该子商户开通 H5 支付权限,并自动配置申请时填写的 H5 支付授权域名。

5. 单独为直连商户/子商户申请 H5 支付权限

如果未在入驻时同步申请 H5 支付权限,也可前往以下页面单独申请。不同接入模式的入口如下:

  • 直连模式:登录境外商户平台,进入 Account Setting - Products Application - H5 Payment。

  • 机构模式:登录境外商户平台,进入 Institution - H5 Payment Application,在列表页搜索需要申请的子商户。

  • 普通服务商模式:登录境外商户平台,进入 Service Provider - Products Application - H5 Payment,在列表页搜索需要申请的子商户。

在列表页找到需要申请 H5 支付权限的商户/子商户,点击 Apply 进入申请页面,按页面提示填写并提交申请材料。

提交后可回到该列表页查看申请进展。一般审核将在 20 分钟内完成,审核通过后系统会自动开通 H5 支付权限,并自动配置申请时填写的 H5 支付授权域名。

6. 支付域名的后续修改

权限申请成功后如需新增、修改或删除支付域名:

a)直连商户可进入到Account Setting - Products Application - H5 Payment - Config或者Dev Configuration进行增加、删除、修改。

b)机构子商户/普通服务商子商户可由机构进入Institution—Merchant—Sub-Merchant—选择子商户—Config进行增加、删除、修改(仅对该子商户生效)。

c)机构/普通服务商想给自身配置H5支付域名,可进入Dev Configuration菜单,对H5 Payment Authorized Domain进行增加、删除、修改(对所有子商户生效)。

7. 完成

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签发证书,在证书申请页面上点击Manage,然后在新页面点击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 配置H5支付授权域名

H5支付产品能力是从微信客户端外的浏览器拉起微信客户端来完成支付,拉起微信客户端的页面所属域名必须要在微信支付商户平台完成配置授权,否则将无法拉起H5支付。

操作说明

  • 若为直连商户,请登录微信支付商户平台,可进入Development Configuration菜单在Payment Authorization Config区域对Authorized Domain进行配置,也可以在Account Setting > Products Application > H5 Payment菜单下点击config对支付域名进行配置。


  • 若为机构模式,且机构下的子商户用于拉起微信客户端收银台的网页属于同一目录下,可将支付目录配置在机构商户号下,将对所有子商户都生效可用,此时请登录微信支付商户平台,进入Development Configuration菜单,在Payment Authorization Config区域对Authorized Domain进行配置,具体页面如下图所示:

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

 

域名配置说明:

  • 建议配置主域名,则所有的子域名都将会有权限。若只配置子域名,则仅该子域名有权限。即如果配置qq.com,则www.qq.com和music.qq.com都会有权限。如果配置www.qq.com,只有www.qq.com会有权限,music.qq.com和pay.qq.com都不会有权限。

 

语言
置顶