微信支付v3接口的 官方 Java SDK

时间：2022-11-03 14:05:57
啰嗦几句：微信支付v3版接口麻烦吗？在对接微信支付v3接口时，本来是一件很简单的事情，其实微信支付v3接口并不是很复杂，但是微信团队的管理很混乱，给我们开发者带来了巨大的麻烦。

微信支付v3版接口对接麻烦-问题出在了哪？

  • 其一：微信支付的版本较多，没有形成一个统一管理说明；
  • 其二：微信v3支付，没有一个完整的说明文档，文档都很分散；
  • 其三：微信支付官方文档看似很详细，其实很多关键点都没说明白，新手看着就很头疼；

下面详细的说一下微信支付v3接口的开发

这个版本整合微信官方文档，以微信小程序开发为基础，大家按步骤点开链接查看操作。

对接微信支付API v3

前提：商户号已注册好，准备就绪。

  • 接入前准备
    注意：操作过程中产生的APIv3秘钥记录下来，有的后面会用到。 例如 API v3秘钥：B3AQsC17C6UFooIRCAaXRUvaq8PInN60
    微信商户平台接入说明文档
    [微信商户平台](https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_8_1.shtml)
    微信支付v3接口的 官方 Java SDK
    说明：这个是小程序版，如果是其他平台可以在左侧找对应目录
    注意：这个流程走下来你会拿到一个压缩文件类似下图
    微信支付v3接口的 官方 Java SDK
    图：这个压缩文件里有三个证书（解压后如下图），三个证书文件拷贝到你的开发平台里，使用方式继续往下看
    微信支付v3接口的 官方 Java SDK

  • 扫码进入商户平台的入口
    微信商户平台
    [微信商户平台](https://pay.weixin.qq.com)
    说明：使用管理者的微信扫码进入，进入后台根据上面的说明进行操作。如果没有注册可以直接走注册流程。注册流程这里不讲解。

  • 扫码小程序后台的入口
    微信小程序后台
    [微信小程序后台](https://mp.weixin.qq.com/)
    注意：如果没有申请小程序可以进入这里看怎么申请
    申请小程序说明

  • 小程序后台开通微信支付并绑定商户平台说明
    小程序后台开通微信支付并绑定商户平台说明
    [小程序后台开通微信支付并绑定商户平台说明](https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_8_1.shtml)
    注意：查看说明中最后的【5.配置应用】进行操作

  • 获取商户API证书序列号（merchantSerialNumber）
    进入证书查看网站
    [进入证书查看网站](https://myssl.com/cert_decode.html)
    微信支付v3接口的 官方 Java SDK
    说明：上传证书文件：apiclient_cert.pem，点击查看证书，里面会有个序列号，复制出来。下载微信支付平台证书会用到。
    例如：
    证书序列号：54776TTTF8F77EXXX3641FAB5F940FII11C65347

  • 下载微信支付平台证书方法
    微信支付平台证书下载工具
    [微信支付平台证书下载工具](https://github.com/wechatpay-apiv3/CertificateDownloader)
    说明：在这里下载 CertificateDownloader.jar 文件，按照里面的文档操作即可
    注意：我的操作说明，我是把下载好的 CertificateDownloader.jar 文件，放在了解压证书的目录里。这样我取mchPrivateKeyFilePath这个值的时候就可以直接写证书文件名，不用写路径了。

官方完整命令如：

java -jar CertificateDownloader.jar -k ${apiV3key} -m ${mchId} -f ${mchPrivateKeyFilePath} -s ${mchSerialNo} -o ${outputFilePath} -c ${wechatpayCertificateFilePath}

我的操作例如：

java -jar CertificateDownloader.jar -k B3AQsC17C6UFooIRCAaXRUvaq8PInN60 -m 1901174254 -f apiclient_key.pem -s 54776TTTF8F77EXXX3641FAB5F940FII11C65347 -o file

注意：1.操作前 CertificateDownloader.jar 和 apiclient_key.pem 文件在同一个目录 。并且在这个目录中进入cmd命令工具。cmd命令工具中显示的目录就是CertificateDownloader.jar所在目录。
例如：

文件-CertificateDownloader.jar 路径：D:\WXCertUtil\cert\CertificateDownloader.jar
文件-apiclient_key.pem 路径：D:\WXCertUtil\cert\apiclient_key.pem
cmd中路径：D:\WXCertUtil\cert>

注意：2.命令中 -o file 只是个文件夹，命令执行后会在下面路径中生成一个微信支付平台证书文件。把这个证书也复制到你的平台中，和上面三个证书放在一个位置方便管理。
例如：
D:\WXCertUtil\cert\file\wechatpay_3A4AF69999DF01F39BB08C21C1C29B6AA17C074N.pem

至此，所有微信支付v3的准备工作已就绪，接下来，使用微信官方SDK开发接入微信支付v3。

Java平台接入微信支付v3接口

更多平台看官方文档

微信支付 APIv3 Java SDK
微信支付 APIv3 Java SDK,里面有详细说明
github 地址：https://github.com/wechatpay-apiv3/wechatpay-java
注意:开发可以根据这里的说明操作就好了，下面我写一下可能大家不理解的点。

代码中的配置-例如：

  /** 商户号 */
  public static String merchantId = "1901174254";
  /** 商户API私钥路径 */
  public static String privateKeyPath = "apiclient_key.pem";
  /** 商户证书序列号 */
  public static String merchantSerialNumber = "54776TTTF8F77EXXX3641FAB5F940FII11C65347";
  /** 微信支付平台证书路径 */
  public static String wechatPayCertificatePath = "wechatpay_3A4AF69999DF01F39BB08C21C1C29B6AA17C074N.pem";
  /** 微信支付 APIv3 密钥 */
  /** 如果微信支付平台证书，已经下载好了，apiV3Key 就不需要了 */
  public static String apiV3Key = "B3AQsC17C6UFooIRCAaXRUvaq8PInN60";

如果微信支付平台证书，已经下载好了,github里这个代码就不用看了。

package com.wechat.pay.java.service;

import com.wechat.pay.java.core.Config;
import com.wechat.pay.java.core.RSAConfig;
import com.wechat.pay.java.service.certificate.CertificateService;
import java.nio.charset.StandardCharsets;
import java.security.cert.X509Certificate;
import java.util.List;

/** 下载微信支付平台证书为例 */
public class QuickStart {

  /** 商户号 */
  public static String merchantId = "";
  /** 商户API私钥路径 */
  public static String privateKeyPath = "";
  /** 商户证书序列号 */
  public static String merchantSerialNumber = "";
  /** 微信支付平台证书路径 */
  public static String wechatPayCertificatePath = "";
  /** 微信支付 APIv3 密钥 */
  public static String apiV3Key = "";

  public static void main(String[] args) {
    Config config =
        new RSAConfig.Builder()
            .merchantId(merchantId)
            .privateKeyFromPath(privateKeyPath)
            .merchantSerialNumber(merchantSerialNumber)
            .wechatPayCertificatesFromPath(wechatPayCertificatePath)
            .build();
    CertificateService certificateService = new CertificateService.Builder().config(config).build();
    List<X509Certificate> certificates =
        certificateService.downloadCertificate(apiV3Key.getBytes(StandardCharsets.UTF_8));
  }
}

支付的第一步：微信支付前需要拿到预支付id（prepayId）,才能支付，所有支付的第一步是预支付

import com.wechat.pay.java.core.Config;
import com.wechat.pay.java.core.RSAConfig;
import com.wechat.pay.java.service.payments.jsapi.JsapiService;
import com.wechat.pay.java.service.payments.jsapi.model.Amount;
import com.wechat.pay.java.service.payments.jsapi.model.Payer;
import com.wechat.pay.java.service.payments.jsapi.model.PrepayRequest;
import com.wechat.pay.java.service.payments.jsapi.model.PrepayResponse;

public class JsapiExample {
  public static void main(String[] args) {
    Config config =
        new RSAConfig.Builder()
            .merchantId(merchantId)
            .privateKeyFromPath(privateKeyPath)
            .merchantSerialNumber(merchantSerialNumber)
            .wechatPayCertificatesFromPath(wechatPayCertificatePath)
            .build();

    JsapiService service = new JsapiService.Builder().config(config).build();

    PrepayRequest request = new PrepayRequest();
    Amount amount = new Amount();
    amount.setTotal(100);
    request.setAmount(amount);
    request.setAppid("wxa9d9651ae******");
    request.setMchid("190000****");
    request.setDescription("测试商品标题");
    request.setNotifyUrl("https://notify_url");
    request.setOutTradeNo("out_trade_no_001");
    Payer payer = new Payer();
    payer.setOpenid("oLTPCuN5a-nBD4rAL_fa********");
    request.setPayer(payer);

    PrepayResponse response = service.prepay(request);
    System.out.println(response.getPrepayId());
  }
}

还需要知道的：微信平台给的用户openid，并不是一个用户的唯一ID，不能多个小程序同时使用。也就是说，在小程序A中拿到的用户openid 和 在小程序B中拿到的用户openid 是不一样的。

相关文章