Spring Boot 对接微信支付的详细

### Spring Boot与微信小程序支付集成教程 #### 添加依赖项 为了使Spring Boot应用程序能够处理来自微信小程序的请求并完成支付流程，需引入必要的依赖库。对于微信支付功能而言，在`pom.xml`文件中加入如下配置： ```xml <dependency> <groupId>com.github.wechatpay-apiv3</groupId> <artifactId>wechatpay-java</artifactId> <version>0.2.1</version> </dependency> ``` 上述代码展示了如何通过Maven管理器向项目添加官方推荐使用的WeChat Pay Java SDK版本[^2]。 #### 创建服务接口 定义用于发起预支付交易的服务方法，该方法接收从前端传来的订单详情参数，并调用微信统一下单API获取prepay_id返回给前端应用以便后续操作。 ```java @Service public class WeChatPayService { @Value("${wechat.pay.appid}") private String appId; public Map<String, Object> unifiedOrder(String outTradeNo, BigDecimal totalAmount) throws Exception { // 构建请求体... // 调用统一下单 API ... // 返回 prepay_id 给前端 return result; } } ``` 这段示例说明了怎样封装一个简单的统一订单服务类来准备发送至微信服务器的数据包以及解析响应消息[^1]。 #### 控制层设计 编写控制器用来接受HTTP POST请求并将业务逻辑委托给之前提到的服务组件执行。这里假设已经完成了安全校验等工作。 ```java @RestController @RequestMapping("/api/pay") public class PaymentController { @Autowired private WeChatPayService weChatPayService; @PostMapping("/create-order") public ResponseEntity<Map<String,Object>> createOrder(@RequestBody OrderRequest request){ try{ var response = this.weChatPayService.unifiedOrder(request.getOutTradeNo(),request.getTotalFee()); return new ResponseEntity<>(response,HttpStatus.OK); }catch (Exception e){ log.error(e.getMessage()); throw new RuntimeException("Create order failed"); } } } ``` 此片段解释了RESTful风格下的控制函数是如何工作的——它负责接收外部输入并通过内部机制触发相应的动作。 #### 前端交互指南 最后一步是在微信小程序侧实现页面跳转到支付界面的功能。通常情况下会利用wx.requestPayment() API 完成这一过程。下面给出了一段简化版的小程序JavaScript脚本样例： ```javascript const app = getApp(); Page({ data: {}, async payNow(orderInfo) { const res = await wx.request({ url: &#39;https://yourdomain.com/api/pay/create-order&#39;, method: "POST", data: { ...orderInfo }, header: {&#39;content-type&#39;: &#39;application/json&#39;} }); let paymentData = {...res.data}; wx.requestPayment({ timeStamp: paymentData.timeStamp, nonceStr: paymentData.nonceStr, package: `prepay_id=${paymentData.prepayId}`, signType: &#39;MD5&#39;, paySign: paymentData.sign, success(res) { console.log(&#39;success&#39;, res); }, fail(err) { console.error(&#39;fail&#39;, err); } }); } }); ``` 以上就是整个从后端搭建直至前端调用的一套完整的方案描述[^3]。