springboot对接微信扫码支付

### Spring Boot 应用中集成微信扫码支付 #### 一、项目准备与依赖引入 为了使Spring Boot应用程序能够处理来自微信服务器的消息并发起支付请求，需先在`pom.xml`文件里加入必要的依赖项。 ```xml <dependency> <groupId>com.github.binarywang</groupId> <artifactId>weixin-java-pay</artifactId> <version>${wx.java.version}</version> </dependency> ``` 上述操作确保了开发环境具备访问微信开放平台所提供的接口的能力[^1]。 #### 二、配置微信公众账号信息 创建名为`application.yml`的应用程序配置文件，在其中定义用于连接到微信服务的关键参数： ```yaml wepay: appId: wxxxxxxxxxxxxxxx # 微信分配的小程序ID mchId: "1900000109" # 商户号 key: T1mXXXXXX # API密钥 certLocalPath: /path/to/cert.p12 # 安全证书路径 notifyUrl: http://yourdomain.com/wxpay/notify # 支付回调地址 ``` 此步骤为后续调用微信API提供了基础设置[^2]。 #### 三、编写控制器逻辑 接下来设计一个RESTful风格的服务端点来接收客户端发来的预订单详情，并向微信提交统一订单请求。下面是一个简单的例子展示如何构建这样的方法： ```java @RestController @RequestMapping("/api/pay") public class PayController { private final WxPayService wxPayService; @PostMapping("/createOrder") public ResponseEntity<String> createOrder(@RequestBody Map<String, Object> orderInfo) { try { // 构建统一下单对象 WxPayUnifiedOrderV3Request request = new WxPayUnifiedOrderV3Request(); request.setOutTradeNo((String)orderInfo.get("out_trade_no")); request.setDescription((String)orderInfo.get("description")); Amount amount = new Amount(); amount.setTotal(Integer.parseInt(orderInfo.get("total_fee").toString())); request.setAmount(amount); // 发起下单请求 WxPayNativeResponse response = wxPayService.createOrder(request); // 返回二维码URL给前端 return ResponseEntity.ok(response.getCodeUrl()); } catch (Exception e) { log.error(e.getMessage(),e); return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null); } } } ``` 这段代码展示了当接收到创建新订单的HTTP POST请求时，会尝试通过微信支付SDK发送一条新的交易记录至微信支付系统，并最终返回可用于扫描付款的QR Code链接。 #### 四、前端交互实现 最后一步是在网页或其他界面提供一种方式让用户触发这个过程。这通常意味着要在HTML文档内放置一个按钮或链接供用户点击启动支付流程。例如可以这样写入模板引擎中的视图层代码片段： ```html <a id="wechat-payment-link">立即支付</a> <script type="text/javascript"> document.getElementById('wechat-payment-link').addEventListener('click', function(event){ event.preventDefault(); fetch('/api/pay/createOrder',{ method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({ out_trade_no:new Date().getTime(), description:"商品描述", total_fee:1, }) }).then(res=>res.json()) .then(data=>{ const qrcode = new QRCode(document.body,{ text:data }); }); }); </script> ``` 这里利用JavaScript动态生成了一个可被扫描的二维条形码图像，使得顾客可以直接使用手机上的微信应用完成支付动作[^4]。 ---