SpringBoot实现微信小程序支付功能

2025-04-11 16:50

本文主要是介绍SpringBoot实现微信小程序支付功能,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《SpringBoot实现微信小程序支付功能》小程序支付功能已成为众多应用的核心需求之一,本文主要介绍了SpringBoot实现微信小程序支付功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作...

一、引言

在当今数字化时代,小程序支付功能已成为众多应用的核心需求之一。通过小程序支付,用户可以便捷地完成购物、充值等操作,极大地提升了用户体验和业务效率。Spring Boot作为一款流行的Java开发框架,以其简洁、高效的特点,为实现小程序支付功能提供了强大的支持。本文将详细介绍如何在Spring Boot项目中实现微信小程序支付功能,包括环境搭建、接口开发、支付流程实现以及支付结果通知处理等关键环节。

二、准备工作

(一)微信支付商户平台配置

注册微信支付商户号:在微信支付商户平台(pay.weixin.qq.com/)注册一个商户号,获取商户号(mch_id)、API密钥(key)等基本信息。
申请微信支付证书:在商户平台下载支付证书,用于签名验证和数据加密
配置支付参数:在商户平台配置支付参数,包括回调地址(notify_url)等。

(二)Spring Boot项目搭建

创建Spring Boot项目:通过Spring Initializr(start.spring.io/)快速创建一个Spring Boot项目,选择所需的依赖,如Spring Web、Spring Boot DevTools等。

添加微信支付依赖:在pom.XML文件中添加微信支付相关依赖:

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

(三)配置文件设置

在application.properties或application.yml文件中配置微信支付相关参数:

wx.pay.appId: your_app_id
wx.pay.mchId: your_mch_id
wx.pay.key: your_api_key
wx.pay.notifyUrl: your_notify_url

三、支付功能实现

(一)统一下单接口开发

创建支付服务类:创建WxPayService类,用于处理支付相关逻辑:

@Service
public class WxPayService {
    @Value("${wx.pay.appId}")
    private String appId;
    @Value("${wx.pay.mchId}")
    private String mchId;
    @Value("${wx.pay.key}")
    private String key;
    @Value("${wx.pay.notifyUrl}")
    private String notifyUrl;

    public Map<String, String> unifiedOrder(Map<String, String> params) {
        // 构建统一下单请求参数
        Map<String, String> requestParams = new HashMap<>();
        requestParams.put("appid", appId);
        requestParams.put("mch_id", mchId);
        requestParams.put("nonce_str", UUID.randomUUID().toString().replace("-", ""));
        requestParams.put("body", params.get("body"));
        requestParams.put("out_trade_no", params.get("out_trade_no"));
        requestParams.put("total_fee", params.get("total_fee"));
        requestParams.put("spbill_create_ip", params.get("spbill_create_ip"));
        requestjsParams.put("notify_url", notifyUrl);
        requestParams.put("trade_type", "jsAPI");
        requestParams.put("openid", params.get("openid"));

        // 签名
        String sign = WxPayUtil.createSign(requestParams, key);
        requestParams.put("sign", sign);

        // 发起统一下单请求
        String xml = WxPayUtil.mapToXml(requestParams);
        String result = HttpClientUtil.doPost("https://api.mch.weixin.qq.com/pay/unifiedorder", xml);
        Map<String, String> resultMap = WxPayUtil.xmlToMap(result);

        // 返回前端需要的支付参数
        Map<String, String> payParams = new HashMap<>();
        payParams.put("appId", appId);
        payParams.put("timeStamp", String.valueOf(System.currentTimeMillis() / 1000));
        payParams.put("nonceStr", UUID.randomUUID().toString().replace("-", ""));
        payPjavascriptarams.put("package", "prepay_id=" + resultMap.get("prepay_id"));
        payParams.put("signType", "MD5");
        payParams.put("paySign", WxPayUtil.createSign(payParams, key));

        return payParams;
    }
}

创建支付控制器:创建WxPayController类,用于接收小程序的支付请求并调用统一下单接口:

@RestController
@RequestMapping("/wxpay")
public class WxPayController {
    @Autowired
    private WxPayService wxPayService;

    @PostMapping("/unifiedOrder")
    public Map<String, String> unifiedOrder(@RequestBody Map<String, String> params) {
        return wxPayService.unifiedOrder(params);
    }
}

(二)支付结果通知处理

创建支付结果通知处理接口:创建WxPayNotifyController类,用于接收微信支付结果通知:

@RestController
@RequestMapping("/wxpay")
public class WxPayNotifyController {
    @Autowired
    private WxPayService wxPayService;

    @PostMapping("/notify")
    public String notify(@RequestBody String notifyData) {
        return wxPayService.notify(notifyData);
    }
}

实现支付结果处理逻辑:在WxPayService中实现支付结果处理逻辑:

public String notify(String notifyData) {
    try {
        // 解析通知数据
        Map<String, String> notifyMap = WxPayUtil.xmlToMap(notifyData);
        // 验证签名
        if (!WxPayUtil.verifySignature(notifyMap, key)) {
            return "FAIL";
        }

     www.chinasem.cn   // 处理支付结果
        if ("SUCCESS".equals(notifyMap.get("result_code"))) {
            // 更新订单状态等业务逻辑
            return "SUCCESS";
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return "FAIL";
}

(三)前端调用支付接口

在小程序前端页面中,调用后端接口获取支付参数,并调用微信支付API完成支付:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>WeChat Pay Example</title>
</head>
<body>
    <h1>WeChat Pay Example</h1>
    <button id="payButton">Pay Now</button>
    <script>
        document.getElementById("payButton").addEventListener("click", function() {
  javascript          // 调用后端接口获取支付参数
            fetch('/wxpay/unifiedOrder', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json'
                },
                body: JSON.stringify({
                    body: 'Test Payment',
                    out_trade_no: '123456789',
                    total_fee: '1',
                    spbill_create_ip: '127.0.0.1',
                    openid: 'your_openid'
                })
            })
            .then(response => response.json())
            .then(payParams => {
                // 调用微信支付API
                WeixinJSBridge.invoke(
                    'getBrandwCPayRequest', {
                        "appId": payParams.appId,
                        "timeStamp": payParams.timeStamp,
                        "nonceStr": payParams.nonceStr,
                        "package": payParams.package,
                        "signType": payParams.signType,
                        "paySign": payParams.paySign
                    },
                    function(res) {
                        if (res.err_msg == "get_brand_wcpay_request:ok") {
                            alert("支付成功");
                        } else {
                            alert("支付失败");
                        }
                    }
                );
            });
        });
    </script>
</body>
</html>

四、测试与优化

(一)测试支付流程

  • 模拟支付请求:在小程序中发起支付请求,检查是否能够正确调用后端接口并返回支付参数。
  • 验证支付结果通知:模拟微信支付结果通知,检查后端是否能够正确处理支付结果并更新订单状态。

(二)优化与安全

  • 签名验证:确保在支付结果通知处理中严格验证签名,防止伪造通知。
  • 日志记录:记录支付请求和通知处理的日志,便于排查问题。
  • 异常处理:在支付流程中添加异常处理逻辑,确保系统在遇到错误时能够正常运行。

五、总结

通过以上步骤,我们成功在Spring Boot项目中实现了微信小程序支付功能。从环境搭建到接口开发,再到支付流程实现和支付结果通知处理,每一步都至关重要。在实际开发中,还需要根据具体业务需求进行进一步的优化和调整 。希望本文能够为开发者提供一个清晰的实现思路和参考代码,帮助大家快速实现小程序支付功能。

六、参考代码

以下是完整的参考代码:

(一)WxPayService.java

@Service
public class WxPayService {
    @Value("${wx.pay.appId}")
    private String appId;
    @Value("${wx.pay.mchId}")
    private String mchId;
    @Value("${wx.pay.key}")
    private String key;
    @Value("${wx.pay.notifyUrl}")
    private String notifyUrl;

    public Map<String, String> unifiedOrder(Map<String, String> params) {
        Map<String, String> requestParams = new HashMap<>();
        requestParams.put("appid", appId);
        requestParams.put("mch_id", mchId);
        requestParams.put("nonce_str", UUID.randomUUID().toString().replace("-", ""));
        requestParams.put("body", params.get("body"));
        requestParams.put("out_trade_no", params.get("out_trade_no"));
        requestParams.put("total_fee", params.get("total_fee"));
        requestParams.put("spbill_create_ip", params.get("spbill_create_ip"));
        requestParams.put("notify_url", notifyUrl);
        requestParams.put("trade_type", "JSAPI");
        requestParams.put("openid", params.get("openid"));

        String sign = WxPayUtil.createSign(requestParams, key);
        requestParams.put("sign", sign);

        String xml = WxPayUtil.mapToXml(requestParams);
        String result = HttpClientUtil.doPost("https://api.mch.weixin.qq.com/pay/unifiedorder", xml);
        Map<String, String> resultMap = WxPayUtil.xmlToMap(result);

        Map<String, String> payParams = new HashMap<>();
        payParams.put("appId", appId);
        payParams.put("timeStamp", String.valueOf(System.currentTimeMillis() / 1000));
        payParams.put("nonceStr", UUID.randomUUID().toString().replace("-", ""));
        payParams.put("package", "prepay_id=" + resultMap.get("prepay_id"));
        payParams.put("signType", "MD5");
        payParams.put("paySign", WxPayUtil.createSign(payParams, key));

        return payParams;
    }

    public String notify(String notifyData) {
        try {
            Map<String, String> notifyMap = WxPayUtil.xmlToMap(notifyData);
            if (!WxPayUtil.verifySignature(notifyMap, key)) {
                return "FAIL";
            }

            if ("SUCCESS".equals(notifyMap.get("result_code"))) {
                // Update order status and other business logic
                return "SUCCESS";
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        return "FAIL";
    }
}

(二)WxPayController.java

@RestController
@RequestMapping("/wxpay")
public class WxPayController {
    @Autowired
    private WxPayService wxPayService;

    @PostMapping(编程"/unifiedOrder")
    public Map<String, String> unifiedOrder(@RequestBody Map<String, String> params) {
        return wxPayService.unifiedOrder(params);
    }
}

(三)WxPayNotifyController.java

@RestController
@RequestMapping("/wxpay")
public class WxPayNotifyController {
    @Autowired
    private WxPayService wxPayService;

    @PostMapping("/notify")
    public String notify(@RequestBody String notifyData) {
        return wxPayService.notify(notifyData);
    }
}

通过以上代码示例和详细步骤,可以快速实现微信小程序支付功能。希望能够帮助大家更好地理解和应用Spring Boot实现小程序支付功能。

到此这篇关于SpringBoot实现微信小程序支付功能的文章就介绍到这了,更多相关SpringBoot小程序支付内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于SpringBoot实现微信小程序支付功能的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1154181

相关文章

Python实现精确小数计算的完全指南

《Python实现精确小数计算的完全指南》在金融计算、科学实验和工程领域,浮点数精度问题一直是开发者面临的重大挑战,本文将深入解析Python精确小数计算技术体系,感兴趣的小伙伴可以了解一下... 目录引言:小数精度问题的核心挑战一、浮点数精度问题分析1.1 浮点数精度陷阱1.2 浮点数误差来源二、基础解决

Java实现在Word文档中添加文本水印和图片水印的操作指南

《Java实现在Word文档中添加文本水印和图片水印的操作指南》在当今数字时代,文档的自动化处理与安全防护变得尤为重要,无论是为了保护版权、推广品牌,还是为了在文档中加入特定的标识,为Word文档添加... 目录引言Spire.Doc for Java:高效Word文档处理的利器代码实战:使用Java为Wo

SpringBoot日志级别与日志分组详解

《SpringBoot日志级别与日志分组详解》文章介绍了日志级别(ALL至OFF)及其作用,说明SpringBoot默认日志级别为INFO,可通过application.properties调整全局或... 目录日志级别1、级别内容2、调整日志级别调整默认日志级别调整指定类的日志级别项目开发过程中,利用日志

Java中的抽象类与abstract 关键字使用详解

《Java中的抽象类与abstract关键字使用详解》:本文主要介绍Java中的抽象类与abstract关键字使用详解,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧... 目录一、抽象类的概念二、使用 abstract2.1 修饰类 => 抽象类2.2 修饰方法 => 抽象方法,没有

SpringBoot 多环境开发实战(从配置、管理与控制)

《SpringBoot多环境开发实战(从配置、管理与控制)》本文详解SpringBoot多环境配置,涵盖单文件YAML、多文件模式、MavenProfile分组及激活策略,通过优先级控制灵活切换环境... 目录一、多环境开发基础(单文件 YAML 版)(一)配置原理与优势(二)实操示例二、多环境开发多文件版

Spring 中的切面与事务结合使用完整示例

《Spring中的切面与事务结合使用完整示例》本文给大家介绍Spring中的切面与事务结合使用完整示例,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考... 目录 一、前置知识:Spring AOP 与 事务的关系 事务本质上就是一个“切面”二、核心组件三、完

Java实现远程执行Shell指令

《Java实现远程执行Shell指令》文章介绍使用JSch在SpringBoot项目中实现远程Shell操作,涵盖环境配置、依赖引入及工具类编写,详解分号和双与号执行多指令的区别... 目录软硬件环境说明编写执行Shell指令的工具类总结jsch(Java Secure Channel)是SSH2的一个纯J

使用Python实现Word文档的自动化对比方案

《使用Python实现Word文档的自动化对比方案》我们经常需要比较两个Word文档的版本差异,无论是合同修订、论文修改还是代码文档更新,人工比对不仅效率低下,还容易遗漏关键改动,下面通过一个实际案例... 目录引言一、使用python-docx库解析文档结构二、使用difflib进行差异比对三、高级对比方

深度解析Python中递归下降解析器的原理与实现

《深度解析Python中递归下降解析器的原理与实现》在编译器设计、配置文件处理和数据转换领域,递归下降解析器是最常用且最直观的解析技术,本文将详细介绍递归下降解析器的原理与实现,感兴趣的小伙伴可以跟随... 目录引言:解析器的核心价值一、递归下降解析器基础1.1 核心概念解析1.2 基本架构二、简单算术表达

JavaScript中比较两个数组是否有相同元素(交集)的三种常用方法

《JavaScript中比较两个数组是否有相同元素(交集)的三种常用方法》:本文主要介绍JavaScript中比较两个数组是否有相同元素(交集)的三种常用方法,每种方法结合实例代码给大家介绍的非常... 目录引言:为什么"相等"判断如此重要?方法1:使用some()+includes()(适合小数组)方法2