接入前准备

更新时间:2025.03.24

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来完成入驻。

5. 确认直连商户/子商户所在行业为免密支付准入行业且具备以下资质条件

行业

开放标准

互联网共享/租赁充电宝

同时满足以下三个条件:

1.商户/子商户为KA商户
2.商户、机构、普通服务商无违规记录
3.不属于以下国家:美国、俄罗斯、土耳其、阿联酋、缅甸、冰岛、柬埔寨、印尼、柬埔寨、老挝、泰国

公共事业(水电、燃气、供暖等)

智能冰柜

话费

交通行业

线上内容平台

6. 权限审核通过后与微信支付签署补充协议

7. 申请“免密支付”模板,获得模板ID

免密支付模板为微信支付分配给商户用于接入免密支付的唯一参数,取得后请妥善保管。

微信支付以模板为维度管理每一个代扣扣费服务,由以下要素组成:

字段含义

说明

示意图

模板ID

由微信支付分配的唯一ID,作为开发对接的必要参数

 

服务名称(展示给用户)

由机构、商户与运营共同协商确定,为用户对于免密支付服务的认知。
呈现位置详见右图

服务介绍说明(展示给用户)

由机构、商户与运营共同协商确定,为商户对该免密支付服务的介绍,便于用户更好的理解该免密支付服务的内容。
呈现位置详见右图

解约回调URL

该解约回调URL由直连商户/收单机构/普通服务商提供。
因为用户可以从微信支付处发起解约,解约成功后将通过该解约回调URL通知直连商户/收单机构/普通服务商该用户已解约,无法再进行扣费。

 

8. 完成

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. 完成

 

语言
置顶

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.