Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

接入前准备

注意:

• 因产品迭代,H5支付权限可使用子商户进件接口申请。

• 详情查看:
子商户进件(产品介绍)
子商户进件(接入前准备)
子商户进件(开发指引)
子商户进件(API列表)

1. 接入模式选择

商户/机构在接入前首先要判断自己公司注册区域适用的接入模式,微信跨境支付目前提供三种接入方式:直连模式、机构模式、普通服务商模式。
直连模式无需使用批量申请H5支付的能力,可直接登录商户平台,一次申请即可长期使用,详情参考H5支付接入指引


• 机构模式

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


• 普通服务商模式

普通服务商模式下,由普通服务商对接微信支付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,如下图所示。通常情况下,一个机构只需申请一个公众号即可。



注意:公众号APPID与商户号mch_id的申请相互独立,可同时申请。

3、绑定MCHID与APPID

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

机构可登陆商户平台,在顶部tab中选择Dev Configuration,即可进入绑定操作页面。若平台提示绑定失败,可联系对应bd或助理人员完成绑定。

机构模式下,一个APPID下可绑定多个mch_id,但一个mch_id仅可绑定到一个APPID。



为了便于理解举例如下:

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

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

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


4、子商户入驻

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

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



5、确认直连商户/子商户具备以下资质条件

同时满足以下两个条件:
1. 商户、机构、普通服务商无违规记录
2. 机构不属于以下国家:印尼、柬埔寨、老挝

6、登录商户平台,签署补充协议

首次使用API申请H5支付权限的能力前,需要签署补充协议,仅需签一次,后续可持续使用。
登录境外商户平台,前往H5申请页面,点击+Batch Apply与微信支付签署H5支付承诺函。


• 机构模式/普通服务商模式

a) 登录境外商户平台,机构模式进入Institution—H5 Payment Application,普通服务商模式进入Service Provider - Products Application - H5 Payment 即可进入H5支付申请页面(印尼、柬埔寨、老挝国家/地区的商户暂无法申请H5支付);

b)点击页面中部的+Batch Apply按钮,弹出《Letter of Commitment for H5 Payment》。

c)商户勾选同意协议并confirm后,即可为子商户使用API进行H5权限申请。


7、权限审核通过后,系统将会自动为该子商户开通H5支付权限,并自动配置申请时填写的H5支付授权域名。

8、商户也可以通过API新增配置或修改H5支付域名。

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. 配置H5支付授权域名

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

在通过API申请支付权限时,申请时填写的H5支付域名将会被自动配置到对应的子商户上,且在审核通过后立即生效。

若要为机构配置对所有子商户生效的支付域名,可参考以下步骤。


操作说明

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

域名配置说明:

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

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

置顶