springboot 对接微信支付V2退款

在 Spring Boot 中对接微信支付 V2 退款，核心难点在于双向证书的配置和XML 格式的交互。以下是基于官方文档和实战经验整理的对接方案：

1. 核心依赖配置

推荐使用wx-java-pay（原 binarywang）SDK，它能自动处理 XML 转换和签名，避免手写复杂的证书逻辑。

• Maven 依赖：

<dependency> <groupId>com.github.binarywang</groupId> <artifactId>wx-java-pay</artifactId> <version>4.6.0</version> <!-- 建议使用最新版本 --> </dependency>

• YAML 配置：重点配置keyPath（API Key）和keyContent（PKCS12 证书内容）。

wx: pay: appId: wx1234567890 mchId: 1234567890 keyPath: 商户API密钥(API Key) keyContent: classpath:cert/apiclient_cert.p12 # 退款必须配置证书路径

2. 退款代码实现

利用 SDK 的WxPayService发起退款请求。注意金额单位需转换为分，且必须使用Integer类型。

@Autowired private WxPayService wxPayService; public WxPayRefundResult refundOrder(String orderNo, String refundNo, BigDecimal totalFee, BigDecimal refundFee) throws WxPayException { WxPayRefundRequest request = new WxPayRefundRequest(); // 1. 设置订单号（二选一，推荐用商户订单号） request.setOutTradeNo(orderNo); // 2. 设置退款单号（商户系统内唯一） request.setOutRefundNo(refundNo); // 3. 金额转换：元转分 (必须使用 int 类型) request.setTotalFee(totalFee.multiply(new BigDecimal(100)).intValue()); request.setRefundFee(refundFee.multiply(new BigDecimal(100)).intValue()); // 4. 异步回调地址（可选，用于处理退款结果通知） request.setNotifyUrl("https://your-domain.com/wx/refund/notify"); // 执行退款 return wxPayService.refund(request); }

3. 关键避坑指南

• 证书加载失败：V2 退款接口强制要求使用商户API证书（PKCS12格式，即.p12文件），而非普通的 RSA 公钥。若报错java.security.InvalidKeyException，请检查证书密码（通常为商户号 MchId）是否正确，以及 Spring Boot 是否成功读取到了资源文件 。

• 金额类型错误：V2 接口的金额字段（total_fee,refund_fee）定义为int。如果传入BigDecimal或String，会导致 XML 解析失败或签名错误，务必做类型转换 。

• 结果判断逻辑：接口返回的return_code仅代表“通信成功”，必须同时判断result_code为SUCCESS才代表业务受理成功。资金实际到账需等待微信异步通知或主动查询 。