关于微信小程序V3支付部分的模板NOTE

迷迷的k

已于 2025-03-11 09:16:41 修改

阅读量1k

点赞数 14

分类专栏：笔记 Java 微信小程序文章标签：微信微信小程序 java 笔记

于 2024-12-10 16:12:47 首次发布

本文链接：https://blog.youkuaiyun.com/qq_66862911/article/details/144294994

版权

Java 同时被 3 个专栏收录

9 篇文章

订阅专栏

笔记

8 篇文章

订阅专栏

微信小程序

1 篇文章

订阅专栏

前言

微信小程序官方文档中，参数的请求字段与返回字段，一般只要【必填】的字段；另外，微信小程序的 V2 与 V3 版本的方法有所不同，一般V3的方法中都带有 V3 的字样，需要先引入以下 service 来进行后续调用
@Resource
private WxPayService wxPayService;
前端传入的 Body 参数 有时候不需要根据官方文档规定的必填字段进行传入，可以根据自身项目需求，进行封装 Body 请求体参数，按需传入自定义的 Body

1.小程序下单

JSAPI/小程序下单_小程序支付|微信支付商户文档中心https://pay.weixin.qq.com/doc/v3/merchant/4012791897

以下的 PaymentInfo 对象参数如下所示（需要根据需求传递参数）：

@Schema(description = "支付信息")
@Data
public class PaymentInfo implements Serializable {

    @Schema(description = "支付方式：0 未支付；1 微信")
    private Integer payType;

    @Schema(description = "商户订单号")
    private String outTradeNo;

    @Schema(description = "订单金额")
    private Integer totalAmount;

    @Schema(description = "用户标识")
    private String openid;

    @Schema(description = "商户id")
    private Integer merchantId;

    @Schema(description = "商品描述")
    private String description;

    @Serial
    private static final long serialVersionUID = 1L;
}

相关的模板代码：

    /**
     * 小程序下单
     */
    @Override
    public MiniprogramPaymentResponse miniprogramPay(PaymentInfo paymentInfo) throws WxPayException {

        //1.创建请求对象
        WxPayPartnerUnifiedOrderV3Request request = new WxPayPartnerUnifiedOrderV3Request();

        //2.根据商户ID查询对应商户的微信商户号
        MerchantDTO merchantDTO = merchantService.get(paymentInfo.getMerchantId());
        if(merchantDTO==null) {
            throw new MyException(HttpStatus.NOT_FOUND.value(),"当前商户不存在");
        }
        String merchantCode = merchantDTO.getMerchantCode();

        request.setSpMchId(merchantCode);
        request.setDescription(paymentInfo.getDescription());
        request.setOutTradeNo(paymentInfo.getOutTradeNo());

        WxPayPartnerUnifiedOrderV3Request.Amount amount = new WxPayPartnerUnifiedOrderV3Request.Amount();
        amount.setTotal(paymentInfo.getTotalAmount());
        amount.setCurrency("CNY");  //人名币/元
        request.setAmount(amount);

        WxPayPartnerUnifiedOrderV3Request.Payer payer = new WxPayPartnerUnifiedOrderV3Request.Payer();
        payer.setSpOpenid(paymentInfo.getOpenid());
        request.setPayer(request.getPayer());

        //3.更新交易账单表 bill 中的数据
        WechatBill wechatBill = new WechatBill();
        wechatBill.setSubMchId(merchantCode);
        wechatBill.setTradeNo(paymentInfo.getOutTradeNo());
        wechatBill.setTotalFee(BigDecimal.valueOf(paymentInfo.getTotalAmount()));
        wechatBill.setOpenid(paymentInfo.getOpenid());

        int res = wechatBillService.insertSelective(wechatBill); //更新信息
        if(res<=0){
            throw new MyException(HttpStatus.INTERNAL_SERVER_ERROR.value(), "交易账单信息插入失败");
        }

        //4.将 微信小程序V3 中的 request 进行传入，获取到结果集
        WxPayUnifiedOrderV3Result wxPayUnifiedOrderV3Result = wxPayService.unifiedPartnerOrderV3(TradeTypeEnum.JSAPI, request);

        //5.传入会话标识，并返回
        String prepayId = wxPayUnifiedOrderV3Result.getPrepayId();
        MiniprogramPaymentResponse response = new MiniprogramPaymentResponse();
        response.setPrepayId(prepayId);

        return response;
    }

2.小程序退款申请

退款申请_小程序支付|微信支付商户文档中心https://pay.weixin.qq.com/doc/v3/merchant/4012791903相关的模板代码：

     /**
     * 退款申请
     */
    @Override
    public MiniProgramRefundResponse miniProgramRefundV3(String outTradeNo) throws WxPayException {
        WxPayRefundV3Request request = new WxPayRefundV3Request();

        //1.根据订单号获取交易账单信息
        WechatBill wechatBill = wechatBillService.selectWechatBillByTradeNo(outTradeNo);
        if(wechatBill == null){
            throw new MyException(HttpStatus.NOT_FOUND.value(), "当前交易账单不存在");
        }

        //2.封装微信退款请求体
        request.setOutTradeNo(wechatBill.getTradeNo());
        WxPayRefundV3Request.Amount amount = new WxPayRefundV3Request.Amount();
        Money orderAmount = new Money(wechatBill.getTotalFee());
        amount.setRefund((int) orderAmount.getCent());
        amount.setTotal((int) orderAmount.getCent());
        amount.setCurrency(String.valueOf(orderAmount.getCurrency()));
        request.setAmount(amount);

        //2.1 拼接商户退款单号
        String tradeNo = wechatBill.getTradeNo();
        String refundNo = TradeModule.REFUND + tradeNo;
        request.setOutRefundNo(refundNo);

        WxPayRefundV3Result wxPayRefundV3Result = wxPayService.refundV3(request);

        //3.封装 response 对象返回
        MiniProgramRefundResponse refundResponse = new MiniProgramRefundResponse();
        BeanUtils.copyProperties(wxPayRefundV3Result,refundResponse);

        return refundResponse;
    }

3.小程序查询订单

商户订单号查询订单_小程序支付|微信支付商户文档中心https://pay.weixin.qq.com/doc/v3/merchant/4012791900相关的模板代码：

    /**
     * 查询订单
     * @param outTradeNo 交易订单号
     */
    @Override
    public MiniProgramQueryOrderResponse queryOrderInfo(String outTradeNo) throws WxPayException {

        WxPayOrderQueryV3Request request = new WxPayOrderQueryV3Request();
        request.setOutTradeNo(outTradeNo);

        WxPayOrderQueryV3Result orderV3 = wxPayService.queryOrderV3(request);

        //1.查询对应的交易账单表
        WechatBill wechatBill = wechatBillService.selectWechatBillByTradeNo(outTradeNo);

        if(wechatBill==null){
            throw new MyException(HttpStatus.NOT_FOUND.value(), "当前交易账单不存在");
        }

        //2.获取交易账单中的 订单号，并根据类型更新状态
        String orderType = outTradeNo.substring(0, 2);

        switch (orderType) {
            case TICKET ->
                //更新门票订单交易状态
                    orderStatusService.updateRefundOrderStatus(outTradeNo, wechatBill.getRefundStatus());
            case HOTEL ->
                //更新酒店订单交易状态
                    orderStatusService.updateRefundOrderStatus(outTradeNo, wechatBill.getRefundStatus());
            case GOODS ->
                //更新商品订单交易状态
                    orderStatusService.updateRefundOrderStatus(outTradeNo, wechatBill.getRefundStatus());
        }

        //3.封装 response 返回
        MiniProgramQueryOrderResponse response = new MiniProgramQueryOrderResponse();
        response.setMchId(orderV3.getMchid());
        response.setOutTradeNo(orderV3.getOutTradeNo());
        response.setTradeState(orderV3.getTradeState());
        response.setTradeStateDesc(orderV3.getTradeStateDesc());

        return response;
    }

4.小程序支付通知

支付成功回调通知_小程序支付|微信支付商户文档中心https://pay.weixin.qq.com/doc/v3/merchant/4012791902

注意：支付通知功能，与其他功能不太一样，需要传入以下相关参数信息，进行签名认证

除了以上参数，notifyData 这个参数也是微信支付异步通知的一部分，当用户完成支付操作后，微信支付平台会向商户事先设定的回调URL发送一个POST请求，其中就包含了这个 notifyData

相关的模板代码：

    /**
     * 支付通知
     */
    @Override
    public String orderNotify(String notifyData, String signature, String timestamp, String nonce, String serial) throws WxPayException {

        //1.进行签名的认证
        SignatureHeader signatureHeader = new SignatureHeader();
        signatureHeader.setSignature(signature);
        signatureHeader.setNonce(nonce);
        signatureHeader.setSerial(serial);
        signatureHeader.setTimeStamp(timestamp);

        WxPayNotifyV3Result notifyResult = this.wxPayService.parseOrderNotifyV3Result(notifyData, signatureHeader);
        if (!"TRANSACTION.SUCCESS".equals(notifyResult.getRawData().getEventType())) {
            return WxPayNotifyResponse.fail("notifyResult error: " + notifyResult.getRawData().getEventType());
        }
        WxPayNotifyV3Result.DecryptNotifyResult result = notifyResult.getResult();
        if (StrUtil.isEmpty(result.getOutTradeNo()) || StrUtil.isEmpty(result.getTransactionId())) {
            return WxPayNotifyResponse.fail("TradeNo/TransactionId is empty");
        }

        List<WechatBill> billList = wechatBillService.selectAllByTradeNo(result.getOutTradeNo());
        if (billList.size() != 1) {
            return WxPayNotifyResponse.fail("TradeNo error");
        }

        WechatBill wechatBill = billList.get(0);
        //当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。
        if (StrUtil.isNotEmpty(wechatBill.getTradeState())
                && WxPayConstants.WxpayTradeStatus.SUCCESS.equals(wechatBill.getTradeState())) {
            return WxPayNotifyResponse.success("SUCCESS");
        }

        Money totalFee = new Money();
        totalFee.setCent(result.getAmount().getTotal());
        Money wechatBillTotalFee = new Money(wechatBill.getTotalFee());
        if (wechatBillTotalFee.compareTo(totalFee) != 0) {
            return WxPayNotifyResponse.fail("totalFee error");
        }
        wechatBill.setTransactionId(result.getTransactionId());
        switch (result.getTradeState()) {
            case WxPayConstants.ResultCode.SUCCESS:
                wechatBill.setTradeState(WxPayConstants.WxpayTradeStatus.SUCCESS);
                break;
            case WxPayConstants.ResultCode.FAIL:
                wechatBill.setTradeState(WxPayConstants.WxpayTradeStatus.PAY_ERROR);
                break;
            default:
                return WxPayNotifyResponse.fail("ResultCode error");
        }
        wechatBill.setTimeEnd(result.getSuccessTime());

        wechatBillService.updateByPrimaryKeySelective(wechatBill);

        //更改订单状态
        orderStatusService.updateOrderStatus(result.getOutTradeNo(), wechatBill.getTradeState());

        return WxPayNotifyResponse.success("SUCCESS");
    }

5.小程序关闭账单

关闭订单_小程序支付|微信支付商户文档中心https://pay.weixin.qq.com/doc/v3/merchant/4012791901相关的模板代码：

/**
     * 关闭账单
     */
    @Override
    public void closeOrder(String outTradeNo) throws WxPayException {

        wxPayService.closePartnerOrderV3(outTradeNo);
    }