微信小程序对接微信支付最新版教程

写在前面：做了几次小程序支付，从申请商户号到配置参数到上线整个流程，在这里记录一下，以免自己会忘记，也给没有接触过微信支付的小白提供一点参考，文中我参考的官方文档都放了链接，就不在详细赘述，本文使用了微信官方SDK：com.github.wechatpay-apiv3

1、微信支付平台申请商户号

2、申请商户号成功之后按照官方文档在商户平台配置apikey等等参数

3、申请成功之后按照官方文档做接入前准备

4、搭建springboot工程，一堆文档自己去搜吧

5、引入依赖

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

6、引入配置

wx:
  app:
    #    绩效管理页面
    kar-page: system/register
    #    活动页面
    activity-page: pages/index
  # 服务商商户号绑定的公众号信息
  ma:
    configs:
      - appid: 你的小程序appid
        secret: 你的小程序密钥
        mchId: 微信支付商户平台商户号
        mchSerialNumber: 微信支付商户平台商户序列号
        privateKeyPath: 微信支付商户平台私钥存放路径
        apiV3Key: 微信支付商户平台商台apiv3
        notifyUrl: 微信支付回调地址（微信官方会通过该地址发送支付通知）

package com.yycm.platform.system.config;

import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.IdUtil;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

import java.util.List;

/**
 * @Description 微信小程序
 * @Author ZJF
 * @Date 2024/7/16 15:37
 */
@Data
@ConfigurationProperties(prefix = "wx.ma")
public class WxMaProperties {
    private List<WxConfig> configs;

    public WxConfig getDefaultWxConfig() {
        return CollUtil.isNotEmpty(configs) ? configs.get(0) : null;
    }


    @Data
    public static class WxConfig {
        /**
         * 公众号appid
         */
        private String appid;

        /**
         * 设置微信小程序的Secret
         */
        private String secret;
        //=============================支付相关参数=========================================//

        /**
         * 服务商商户号
         */
        private String mchId;

        /**
         * 服务商证书序列号
         */
        private String mchSerialNumber;

        /**
         * 服务商API私钥路径
         */
        private String privateKeyPath;

        /**
         * 服务商apiV3密钥
         */
        private String apiV3Key;

        /**
         * 通知回调地址
         */
        private String notifyUrl;
    }

}


package com.yycm.platform.system.config;

import cn.hutool.core.lang.Assert;
import cn.hutool.extra.spring.SpringUtil;
import com.wechat.pay.java.core.RSAAutoCertificateConfig;
import com.wechat.pay.java.core.notification.NotificationParser;
import com.wechat.pay.java.service.partnerpayments.jsapi.JsapiServiceExtension;
import com.wechat.pay.java.service.partnerpayments.jsapi.model.*;
import com.yycm.platform.system.dept.service.DeptService;
import com.yycm.platform.system.pojo.dto.DeptDto;
import lombok.Getter;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import yycm.platform.common.exception.PlatformException;

/**
 * @Description
 * @Author ZJF
 * @Date 2024/8/7 15:18
 */
@RequiredArgsConstructor
@Slf4j
@Configuration
@EnableConfigurationProperties(WxMaProperties.class)
public class WxMaConfiguration {


    private final WxMaProperties wxMaProperties;

    private final DeptService deptService;

    @Bean
    public RSAAutoCertificateConfig rsaAutoCertificateConfig() {
        WxMpProperties.WxConfig defaultWxConfig = wxMpProperties.getDefaultWxConfig();
        return new RSAAutoCertificateConfig.Builder()
                .merchantId(defaultWxConfig.getMchId())
                // 使用 com.wechat.pay.java.core.util 中的函数从本地文件中加载商户私钥，商户私钥会用来生成请求的签名
                .privateKeyFromPath(defaultWxConfig.getPrivateKeyPath())
                .merchantSerialNumber(defaultWxConfig.getMchSerialNumber())
                .apiV3Key(defaultWxConfig.getApiV3Key())
                .build();
    }


    @Bean
    public JsapiServiceExtension jsapiServiceExtension(RSAAutoCertificateConfig rsaAutoCertificateConfig) {
        return new JsapiServiceExtension.Builder()
                .config(rsaAutoCertificateConfig)
                // .signType("RSA") // 不填则默认为RSA
                .build();
    }

    /**
     * 用来做支付参数的解密
     * @param rsaAutoCertificateConfig
     * @return
     */
    @Bean
    public NotificationParser notificationParser(RSAAutoCertificateConfig rsaAutoCertificateConfig) {
        return new NotificationParser(rsaAutoCertificateConfig);
    }


    /**
     * jsapi下单接口（这里是服务商模式的，各位自行改成普通小程序的吧）
     *
     * @param prepayRequest
     * @return
     */
    public PrepayWithRequestPaymentResponse buildPrepayWithRequestPaymentResponse(PrepayRequest prepayRequest) {
        //子商户应用ID 说明：子商户申请的公众号/小程序appid
        Assert.notNull(prepayRequest.getSubAppid(), () -> PlatformException.create("subAppId can not be null"));
        DeptDto brandByAppId = deptService.getBrandByAppId(prepayRequest.getSubAppid());
        Assert.notNull(brandByAppId, () -> PlatformException.create("subAppId not exists"));
        //子商户号 说明：子商户的商户号，由微信支付生成并下发
        prepayRequest.setSubMchid(brandByAppId.getWxMchid());
        WxMpProperties.WxConfig defaultWxConfig = wxMpProperties.getDefaultWxConfig();
        //服务商应用ID 说明：服务商申请的公众号appid
        prepayRequest.setSpAppid(defaultWxConfig.getAppid());
        //服务商户号 说明：服务商户号，由微信支付生成并下发
        prepayRequest.setSpMchid(defaultWxConfig.getMchId());
        return getJsapiServiceExtension().prepayWithRequestPayment(prepayRequest, prepayRequest.getSpAppid());
    }

    /**
     * 查询订单支付状态
     * 需要补充的参数：
     * transaction_id 微信支付订单号
     * sub_mchid 子商户号
     *
     * @return
     */
    public Transaction queryOrderById(QueryOrderByIdRequest queryOrderByIdRequest) {
        queryOrderByIdRequest.setSpMchid(wxMpProperties.getDefaultWxConfig().getMchId());
        return getJsapiServiceExtension().queryOrderById(queryOrderByIdRequest);
    }

    /**
     * 根据商户订单号查询订单状态
     * out_trade_no:商户订单号
     * sub_mchid: 子商户号
     *
     * @return
     */
    public Transaction queryOrderByOutTradeNo(QueryOrderByOutTradeNoRequest queryOrderByOutTradeNoRequest) {
        queryOrderByOutTradeNoRequest.setSpMchid(wxMpProperties.getDefaultWxConfig().getMchId());
        return getJsapiServiceExtension().queryOrderByOutTradeNo(queryOrderByOutTradeNoRequest);
    }

    /**
     * outTradeNo：商户订单号
     * 关闭订单
     */
    public void closeOrder(CloseOrderRequest closeOrderRequest) {
        closeOrderRequest.setSpMchid(wxMpProperties.getDefaultWxConfig().getMchId());
        getJsapiServiceExtension().closeOrder(closeOrderRequest);
    }


    public JsapiServiceExtension getJsapiServiceExtension() {
        return SpringUtil.getBean(JsapiServiceExtension.class);
    }


}