Spring Boot实现微信小程序支付功能
原创
Spring Boot实现微信小程序支付功能
原创
全干程序员demo
发布于 2025-04-11 01:29:34
发布于 2025-04-11 01:29:34
代码可运行
运行总次数：0
代码可运行
Spring Boot实现微信小程序支付功能
一、引言
在当今数字化时代，小程序支付功能已成为众多应用的核心需求之一。通过小程序支付，用户可以便捷地完成购物、充值等操作，极大地提升了用户体验和业务效率。Spring Boot作为一款流行的Java开发框架，以其简洁、高效的特点，为实现小程序支付功能提供了强大的支持。本文将详细介绍如何在Spring Boot项目中实现微信小程序支付功能，包括环境搭建、接口开发、支付流程实现以及支付结果通知处理等关键环节。
二、准备工作
（一）微信支付商户平台配置
- 注册微信支付商户号：在微信支付商户平台（https://pay.weixin.qq.com/）注册一个商户号，获取商户号（
mch_id）、API密钥（key）等基本信息。 - 申请微信支付证书：在商户平台下载支付证书，用于签名验证和数据加密。
- 配置支付参数：在商户平台配置支付参数，包括回调地址（
notify_url）等。
（二）Spring Boot项目搭建
- 创建Spring Boot项目：通过Spring Initializr（https://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")); 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; } } - 创建支付控制器：创建
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"; } // 处理支付结果 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() {
// 调用后端接口获取支付参数
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实现小程序支付功能。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
评论
登录后参与评论
推荐阅读
目录
腾讯云开发者
