在线支付系列【10】微信支付接入前准备

àì夳堔傛蜴生んèń 2023-10-09 15:27 16阅读 0赞

> **有道无术，术尚可求，有术无道，止于术。**

#### 文章目录 ####

*   *  前言
     *  1. 获取基本参数
     *   *  商户号（mchid）
         *  应用ID（appid）
         *  绑定商户号和应用ID
     *  2. 配置API v3密钥
     *  3. 下载并配置商户API证书
     *   *  3.1 简介
         *  3.2 生成证书串
         *  3.3 获得商户API证书文件
     *  4. 获取微信平台证书

### 前言 ###

**在之前，我们申请了商户号、公众号，可以获取到一些基本参数，另外接入微信支付时，还需要配置一些秘钥、证书。**

**接下来，会汇总讲解各种接入之前需要的准备工作。**

### 1. 获取基本参数 ###

#### 商户号（mchid） ####

首先要参考[微信支付之注册商户号][Link 1]注册商户。

进入[微信支付平台][Link 2]，扫码登录。

具体查阅目录为 【账户中心-> 商户信息-> 商户号】  
![在这里插入图片描述][59e4d6b6f9f84f399d2ee4407ae073d6.png]

#### 应用ID（appid） ####

公众号申请成功后，登录公众号平台即可获取对应的`APPID`。

进入[微信公众号平台][Link 3]扫码登录。

具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】。  
![在这里插入图片描述][df4915b85422402bbd87e943c29bb5f2.png]

#### 绑定商户号和应用ID ####

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

直连模式下，`APPID`和`mchid`之间的关系为多对多，即一个`APPID`下可以绑定多个`mchid`，而一个`mchid`也可以绑定多个`APPID`。

![在这里插入图片描述][80939ce1f4734e86ad481708d8008335.png]

登录[微信商户平台][Link 4]，进入【产品中心-> APPID授权管理】目录，输入`appid`点击确定。  
![在这里插入图片描述][6c2fbf00f0bc498a876a84af8903c717.png]  
前往[公众平台][Link 5]，进入【微信支付-> 商户号管理】目录，查看相关商户号信息，确认授权申请即可。

### 2. 配置API v3密钥 ###

首先我们看下`微信支付API v3版本的一些改进`。

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，微信推出了全新的**微信支付API v3（V3版本接口）**。

相较于之前的**微信支付API**，主要区别是：

*  遵循统一的`REST`的设计风格
 *  使用`JSON`作为数据交互的格式，不再使用`XML`
 *  使用基于非对称密钥的`SHA256-RSA`的数字签名算法，不再使用`MD5`或`HMAC-SHA256`
 *  不再要求携带`HTTPS`客户端证书（仅需携带证书序列号）
 *  使用`AES-256-GCM`，对回调中的关键信息进行加密保护

基于以上说明本系列都是基于最新的`v3版`的支付`API`。如果使用的是`v2版本`需要申请`API`秘钥，`v3版本`则需要申请`API v3密钥`。

为了保证安全性，微信支付在 **回调通知**和**平台证书**下载接口中，对关键信息进行了`AES-256-GCM`加密。`API v3密钥`是加密时使用的对称密钥。商户需先在`【商户平台】->【API安全】`的页面设置该密钥，请求才能通过微信支付的签名校验。密钥的长度为32个字节。

**APIv3密钥属于敏感信息，请妥善保管不要泄露，如果怀疑信息泄露，请重设密钥。**

登录商户平台，进入【账户中心 => API安全 】目录，设置`APIV3`密钥。  
![在这里插入图片描述][eb7bb0a3754941c78be86f45676f20ab.png]  
在弹出窗口中点击**已沟通**。  
![在这里插入图片描述][5489e389ce5246e08dce0eda27596626.png]  
输入API密钥，内容为**32**位字符，包**括数字及大小写字母**。这里可以使用[随机密码生成工具][Link 6]生成一个。  
![在这里插入图片描述][372e205ac9324ebd81c255db94e74355.png]  
复制生成的字符，点击确认**获取短信验证码**。  
![在这里插入图片描述][eaed3568e8a04bfea7e1cdce161e58e1.png]

输入短信验证码，点击“**确认**”即设置成功。  
![在这里插入图片描述][39e92796e61a40c29b1a2ff108f823fc.png]

### 3. 下载并配置商户API证书 ###

#### 3.1 简介 ####

`API证书`是指由商户申请的，用来证实商户身份的证书。API证书由证书授权机构`Certificate Authority`（简称CA）颁发。证书中包含商户的**商户号、公司名称、公钥**等信息。请妥善保管API证书文件，防止泄露。

**使用场景**：

*  `APIv2`中，调用微信支付安全级别较高的接口（如：退款、企业红包、企业付款）
 *  `APIv3`中，调用微信支付所有接口

#### 3.2 生成证书串 ####

商户可自行生成证书请求串，或下载微信支付证书工具生成证书请求串，并将证书请求串提交到商户平台后才能获得商户`API`证书文件，私钥文件请注意安全保存。

首先登录（需要商户号的超级管理员才能操作）`【微信支付商户平台 - 账户中心 - 账户设置 - API安全 - 申请API证书】`申请证书，确定后请勿关闭页面。  
![在这里插入图片描述][b1c30dab107744dbbd3485e049469214.png]  
在弹出窗口中点击“**确定**”。  
![在这里插入图片描述][cb160338dcac443f874ef3197aa042f9.png]  
在弹出窗口内点击“**下载证书工具**”按钮下载证书工具。

也可通过以下链接下载证书工具：

*  [windows版本][windows]
 *  [mac版本][mac]  
    ![在这里插入图片描述][89f65618b41d40cf8398d0f1f65591be.png]  
    下载完成后双击`WXCertUtil.exe`文件安装，安装后输入**保存路径**，点击**申请证书**。  
    ![在这里插入图片描述][b4444f67747046418f04d5e86bb44203.png]  
    在【证书工具】，填写**商户号信息**（商户号、商户名称），点击下一步。  
    ![在这里插入图片描述][192ae0537ea24cf69ccbfb605473aae9.png]  
    在【证书工具】，点击复制**证书请求串**。  
    ![在这里插入图片描述][d5be75e502614cb18e3f3d0dc194f271.png]  
    在【商户平台】，粘贴**证书请求串**。  
    ![在这里插入图片描述][b65457db05674b49965ec6487aa98b5e.png]  
    输入操作密码，安全验证后生成**证书串**。  
    ![在这里插入图片描述][b7918884bab34c3780665c04adf7bfb1.png]

#### 3.3 获得商户API证书文件 ####

复制**证书串**。  
![在这里插入图片描述][e0757012b77d4807a8a10bf5c9d192f5.png]  
在【证书工具】，粘贴证书串，点击下一步。  
![在这里插入图片描述][5383d2b57a7c40c290bbf76dcee17bdb.png]  
申请证书成功。  
![在这里插入图片描述][38e385751ec94a7baf17c39e9cb9415d.png]  
点击`查看证书文件夹`，查看已生成的证书文件。解压后如下所示：  
![在这里插入图片描述][6440ce2a407d48a683f2f7999f40222c.png]

### 4. 获取微信平台证书 ###

`微信支付平台证书`是指由**微信支付** 负责申请的，包含微信支付**平台标识、公钥信息**的证书。商户可以使用平台证书中的公钥进行验签。不同的商户，对应的微信支付平台证书是不一样的。

平台证书会周期性更换。商户应定时通过[API][]下载新的证书，不要依赖人工更新证书（后面使用代码实现）。

[Link 1]: https://yunyanchengyu.blog.csdn.net/article/details/128716964
[Link 2]: https://pay.weixin.qq.com/index.php/core/home/login?return_url=/
[59e4d6b6f9f84f399d2ee4407ae073d6.png]: https://img-blog.csdnimg.cn/59e4d6b6f9f84f399d2ee4407ae073d6.png
[Link 3]: https://mp.weixin.qq.com/?token=&lang=zh_CN
[df4915b85422402bbd87e943c29bb5f2.png]: https://img-blog.csdnimg.cn/df4915b85422402bbd87e943c29bb5f2.png
[80939ce1f4734e86ad481708d8008335.png]: https://img-blog.csdnimg.cn/80939ce1f4734e86ad481708d8008335.png
[Link 4]: https://pay.weixin.qq.com/
[6c2fbf00f0bc498a876a84af8903c717.png]: https://img-blog.csdnimg.cn/6c2fbf00f0bc498a876a84af8903c717.png
[Link 5]: http://mp.weixin.qq.com
[eb7bb0a3754941c78be86f45676f20ab.png]: https://img-blog.csdnimg.cn/eb7bb0a3754941c78be86f45676f20ab.png
[5489e389ce5246e08dce0eda27596626.png]: https://img-blog.csdnimg.cn/5489e389ce5246e08dce0eda27596626.png
[Link 6]: https://suijimimashengcheng.bmcx.com/
[372e205ac9324ebd81c255db94e74355.png]: https://img-blog.csdnimg.cn/372e205ac9324ebd81c255db94e74355.png
[eaed3568e8a04bfea7e1cdce161e58e1.png]: https://img-blog.csdnimg.cn/eaed3568e8a04bfea7e1cdce161e58e1.png
[39e92796e61a40c29b1a2ff108f823fc.png]: https://img-blog.csdnimg.cn/39e92796e61a40c29b1a2ff108f823fc.png
[b1c30dab107744dbbd3485e049469214.png]: https://img-blog.csdnimg.cn/b1c30dab107744dbbd3485e049469214.png
[cb160338dcac443f874ef3197aa042f9.png]: https://img-blog.csdnimg.cn/cb160338dcac443f874ef3197aa042f9.png
[windows]: https://wx.gtimg.com/mch/files/WXCertUtil.exe
[mac]: https://wx.gtimg.com/mch/files/WXCertUtil.dmg
[89f65618b41d40cf8398d0f1f65591be.png]: https://img-blog.csdnimg.cn/89f65618b41d40cf8398d0f1f65591be.png
[b4444f67747046418f04d5e86bb44203.png]: https://img-blog.csdnimg.cn/b4444f67747046418f04d5e86bb44203.png
[192ae0537ea24cf69ccbfb605473aae9.png]: https://img-blog.csdnimg.cn/192ae0537ea24cf69ccbfb605473aae9.png
[d5be75e502614cb18e3f3d0dc194f271.png]: https://img-blog.csdnimg.cn/d5be75e502614cb18e3f3d0dc194f271.png
[b65457db05674b49965ec6487aa98b5e.png]: https://img-blog.csdnimg.cn/b65457db05674b49965ec6487aa98b5e.png
[b7918884bab34c3780665c04adf7bfb1.png]: https://img-blog.csdnimg.cn/b7918884bab34c3780665c04adf7bfb1.png
[e0757012b77d4807a8a10bf5c9d192f5.png]: https://img-blog.csdnimg.cn/e0757012b77d4807a8a10bf5c9d192f5.png
[5383d2b57a7c40c290bbf76dcee17bdb.png]: https://img-blog.csdnimg.cn/5383d2b57a7c40c290bbf76dcee17bdb.png
[38e385751ec94a7baf17c39e9cb9415d.png]: https://img-blog.csdnimg.cn/38e385751ec94a7baf17c39e9cb9415d.png
[6440ce2a407d48a683f2f7999f40222c.png]: https://img-blog.csdnimg.cn/6440ce2a407d48a683f2f7999f40222c.png
[API]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay5_1.shtml