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

前言

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

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

1. 获取基本参数

商户号mchid

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

进入微信支付平台扫码登录。

具体查阅目录为 【账户中心-> 商户信息-> 商户号】

应用IDappid

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

进入微信公众号平台扫码登录。

具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】。

绑定商户号和应用ID

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

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

登录微信商户平台进入【产品中心-> APPID授权管理】目录输入appid点击确定。

前往公众平台进入【微信支付-> 商户号管理】目录查看相关商户号信息确认授权申请即可。

2. 配置API v3密钥

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

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

相较于之前的微信支付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密钥。

在弹出窗口中点击已沟通。

输入API密钥内容为32位字符包括数字及大小写字母。这里可以使用随机密码生成工具生成一个。

复制生成的字符点击确认获取短信验证码。

输入短信验证码点击“确认”即设置成功。

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

3.1 简介

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

使用场景

• APIv2 中调用微信支付安全级别较高的接口如退款、企业红包、企业付款

• APIv3 中调用微信支付所有接口

3.2 生成证书串

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

首先登录需要商户号的超级管理员才能操作【微信支付商户平台 - 账户中心 - 账户设置 - API安全 - 申请API证书】申请证书确定后请勿关闭页面。

在弹出窗口中点击“确定”。

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

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

• windows版本

• mac版本
  
  下载完成后双击WXCertUtil.exe文件安装安装后输入保存路径点击申请证书。
  
  在【证书工具】填写商户号信息商户号、商户名称点击下一步。
  
  在【证书工具】点击复制证书请求串。
  
  在【商户平台】粘贴证书请求串。
  
  输入操作密码安全验证后生成证书串。
  

3.3 获得商户API证书文件

复制证书串。

在【证书工具】粘贴证书串点击下一步。

申请证书成功。

点击查看证书文件夹查看已生成的证书文件。解压后如下所示

4. 获取微信平台证书

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

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