跳到主要内容

微信支付升级说明-API V3

背景​

由于官方推出了全新的微信支付API v3，因此我们产品中的支付也要进行升级。

说明​

产品接入​

  1. 对接微信支付之前，需要开通微信商户平台，具体如何开通请咨询官方客服
  2. 开通商户平台后，需要进入商户平台-产品中心-APP账号管理中，将商户和AppID进行关联绑定，具体如何操作参考官方文档：https://kf.qq.com/faq/1801116VJfua1801113QVNVz.html
  3. 开通相应的支付产品（例如JSAPI支付、APP支付、Native支付和H5支付等等），如何开通，可参考官方产品接入指引文档（https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml），按照官方文档中的步骤进行开通即可
  4. 进入商户平台-产品中心-开发配置中，设置相关支付配置（例如我们的JSAPI支付的支付授权目录、Native支付的回调链接和H5支付的支付域名等）

商户API证书申请​

进入商户平台-账户中心-API安全中，进行证书申请，具体操作步骤参考官方文档：https://kf.qq.com/faq/161222NneAJf161222U7fARv.html

获得的证书文件共有三个，如下：

image-20230607115823347

设置APIv3密钥​

进入商户平台-账户中心-API安全中，进行APIv3密钥的设置，具体操作步骤参考官方文档：https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html

SDK接入​

官方SDK源码地址：https://github.com/wechatpay-apiv3/wechatpay-java（需要科学上网）

在产品源码中我们需要加入以下相关依赖：

<dependency>
  <groupId>com.github.wechatpay-apiv3</groupId>
  <artifactId>wechatpay-java</artifactId>
  <version>0.2.7</version>
</dependency>

使用官方SDK，还需要申请微信支付颁发的商户API证书，此证书不同于上述在API安全中申请的证书（具体区别可参考官方文档：https://kf.qq.com/faq/180824JvUZ3i180824YvMNJj.html）

微信支付平台证书下载工具：https://github.com/wechatpay-apiv3/CertificateDownloader（需要科学上网）

根据其中的说明来进行下载，下载后的证书如下：

image-20230607120134958

开发​

完成上述所有步骤后，我们即可进行微信支付相关API接口的对接了