xuhy
2026-03-27 0923c2a6f1a7b4d28e39f566f9ff27557e2bf250
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
package com.ruoyi.system.wxPay.utils;
 
 
import com.alibaba.fastjson2.JSONObject;
import com.google.gson.annotations.SerializedName;
import com.google.gson.annotations.Expose;
import com.ruoyi.common.utils.OrderNos;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
 
import java.io.IOException;
import java.io.UncheckedIOException;
import java.security.PrivateKey;
import java.security.PublicKey;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
 
/**
 * 退款申请
 */
//@Component
public class WxRefundUtil {
  private static String HOST = "https://api.mch.weixin.qq.com";
  private static String METHOD = "POST";
  private static String PATH = "/v3/refund/domestic/refunds";
 
  @Autowired
  private WxV3Pay wxV3Pay;
 
  public WxRefundUtil() {
  }
 
  public WxRefundUtil(String mchid, String certificateSerialNo, PrivateKey privateKey, String wechatPayPublicKeyId, PublicKey wechatPayPublicKey) {
    this.mchid = mchid;
    this.certificateSerialNo = certificateSerialNo;
    this.privateKey = privateKey;
    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
    this.wechatPayPublicKey = wechatPayPublicKey;
  }
 
  public String refund(int money,String outTradeNo,String outRefundNo) {
    // TODO: 请准备商户开发必要参数,参考:https://pay.weixin.qq.com/doc/v3/merchant/4013070756
    WxRefundUtil client = new WxRefundUtil(
           this. wxV3Pay.getConfig().getMchId(),                    // 商户号,是由微信支付系统生成并分配给每个商户的唯一标识符,商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
            this. wxV3Pay.getConfig().getV3().getMchSerialNo(),         // 商户API证书序列号,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
            this. wxV3Pay.getConfig().getV3().getPrivateKeyPath() ,     // 商户API证书私钥文件路径,本地文件路径
            this. wxV3Pay.getConfig().getV3().getPublicKeyId() ,      // 微信支付公钥ID,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
            this. wxV3Pay.getConfig().getV3().getPublicKeyPath()         // 微信支付公钥文件路径,本地文件路径
    );
 
    CreateRequest request = new CreateRequest();
    request.outTradeNo = outTradeNo;
    request.reason = "退款";
    request.notifyUrl =this.wxV3Pay.getConfig().getV3().getNotifyRefundUrl();
    request.fundsAccount = ReqFundsAccount.AVAILABLE;
    request.amount = new AmountReq();
    request.amount.refund = money;
    request.outRefundNo =outRefundNo;
    request.amount.total = money;
    request.amount.currency = "CNY";
    request.goodsDetail = new ArrayList<>();
    try {
      Refund response = client.run(request);
        // TODO: 请求成功,继续业务逻辑
        System.out.println(response);
        return null;
    } catch (WXPayUtility.ApiException e) {
      String body = e.getBody();
      JSONObject jsonObject = JSONObject.parseObject(body);
      String result = jsonObject.get("message").toString();
      return result;
 
      // TODO: 请求失败,根据状态码执行不同的逻辑
    }
  }
  public String refundInsurance(int money,String outTradeNo,String outRefundNo) {
    // TODO: 请准备商户开发必要参数,参考:https://pay.weixin.qq.com/doc/v3/merchant/4013070756
    WxRefundUtil client = new WxRefundUtil(
           this. wxV3Pay.getConfig().getMchId(),                    // 商户号,是由微信支付系统生成并分配给每个商户的唯一标识符,商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756
            this. wxV3Pay.getConfig().getV3().getMchSerialNo(),         // 商户API证书序列号,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053
            this. wxV3Pay.getConfig().getV3().getPrivateKeyPath() ,     // 商户API证书私钥文件路径,本地文件路径
            this. wxV3Pay.getConfig().getV3().getPublicKeyId() ,      // 微信支付公钥ID,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816
            this. wxV3Pay.getConfig().getV3().getPublicKeyPath()         // 微信支付公钥文件路径,本地文件路径
    );
 
    CreateRequest request = new CreateRequest();
    request.outTradeNo = outTradeNo;
    request.reason = "退款";
    request.fundsAccount = ReqFundsAccount.AVAILABLE;
    request.notifyUrl =this.wxV3Pay.getConfig().getV3().getNotifyInsuranceRefundUrl();
    request.amount = new AmountReq();
    request.amount.refund = money;
    request.outRefundNo =outRefundNo;
    request.amount.total = money;
    request.amount.currency = "CNY";
    request.goodsDetail = new ArrayList<>();
    try {
      Refund response = client.run(request);
        // TODO: 请求成功,继续业务逻辑
        System.out.println(response);
        return null;
    } catch (WXPayUtility.ApiException e) {
      String body = e.getBody();
      JSONObject jsonObject = JSONObject.parseObject(body);
      String result = jsonObject.get("message").toString();
      return result;
 
      // TODO: 请求失败,根据状态码执行不同的逻辑
    }
  }
 
  public Refund run(CreateRequest request) {
    String uri = PATH;
    String reqBody = WXPayUtility.toJson(request);
 
    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
    reqBuilder.addHeader("Accept", "application/json");
    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
    reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo,privateKey, METHOD, uri, reqBody));
    reqBuilder.addHeader("Content-Type", "application/json");
    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
    reqBuilder.method(METHOD, requestBody);
    Request httpRequest = reqBuilder.build();
 
    // 发送HTTP请求
    OkHttpClient client = new OkHttpClient.Builder().build();
    try (Response httpResponse = client.newCall(httpRequest).execute()) {
      String respBody = WXPayUtility.extractBody(httpResponse);
      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
        // 2XX 成功,验证应答签名
        WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
            httpResponse.headers(), respBody);
 
        // 从HTTP应答报文构建返回数据
        return WXPayUtility.fromJson(respBody, Refund.class);
      } else {
        throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
      }
    } catch (IOException e) {
      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
    }
  }
 
  private  String mchid;
  private  String certificateSerialNo;
  private  PrivateKey privateKey;
  private  String wechatPayPublicKeyId;
  private  PublicKey wechatPayPublicKey;
 
  public WxRefundUtil(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
    this.mchid = mchid;
    this.certificateSerialNo = certificateSerialNo;
    this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath);
    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
    this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
  }
 
  public static class CreateRequest {
 
    @SerializedName("out_trade_no")
    public String outTradeNo;
  
    @SerializedName("out_refund_no")
    public String outRefundNo;
  
    @SerializedName("reason")
    public String reason;
  
    @SerializedName("notify_url")
    public String notifyUrl;
  
    @SerializedName("funds_account")
    public ReqFundsAccount fundsAccount;
  
    @SerializedName("amount")
    public AmountReq amount;
  
    @SerializedName("goods_detail")
    public List<GoodsDetail> goodsDetail;
  
  }
  
  public static class Refund {
    @SerializedName("refund_id")
    public String refundId;
  
    @SerializedName("out_refund_no")
    public String outRefundNo;
  
    @SerializedName("transaction_id")
    public String transactionId;
  
    @SerializedName("out_trade_no")
    public String outTradeNo;
  
    @SerializedName("channel")
    public Channel channel;
  
    @SerializedName("user_received_account")
    public String userReceivedAccount;
  
    @SerializedName("success_time")
    public String successTime;
  
    @SerializedName("create_time")
    public String createTime;
  
    @SerializedName("status")
    public Status status;
  
    @SerializedName("funds_account")
    public FundsAccount fundsAccount;
  
    @SerializedName("amount")
    public Amount amount;
  
    @SerializedName("promotion_detail")
    public List<Promotion> promotionDetail;
  
  }
  
  public enum ReqFundsAccount {
    @SerializedName("AVAILABLE")
    AVAILABLE,
    @SerializedName("UNSETTLED")
    UNSETTLED
  }
  
  public static class AmountReq {
    @SerializedName("refund")
    public Integer refund;
  
    @SerializedName("from")
    public List<FundsFromItem> from;
  
    @SerializedName("total")
    public Integer total;
  
    @SerializedName("currency")
    public String currency;
  }
  
  public static class GoodsDetail {
    @SerializedName("merchant_goods_id")
    public String merchantGoodsId;
  
    @SerializedName("wechatpay_goods_id")
    public String wechatpayGoodsId;
  
    @SerializedName("goods_name")
    public String goodsName;
  
    @SerializedName("unit_price")
    public Long unitPrice;
  
    @SerializedName("refund_amount")
    public Long refundAmount;
  
    @SerializedName("refund_quantity")
    public Long refundQuantity;
  }
  
  
  public enum Channel {
    @SerializedName("ORIGINAL")
    ORIGINAL,
    @SerializedName("BALANCE")
    BALANCE,
    @SerializedName("OTHER_BALANCE")
    OTHER_BALANCE,
    @SerializedName("OTHER_BANKCARD")
    OTHER_BANKCARD
  }
  
  public enum Status {
    @SerializedName("SUCCESS")
    SUCCESS,
    @SerializedName("CLOSED")
    CLOSED,
    @SerializedName("PROCESSING")
    PROCESSING,
    @SerializedName("ABNORMAL")
    ABNORMAL
  }
  
  public enum FundsAccount {
    @SerializedName("UNSETTLED")
    UNSETTLED,
    @SerializedName("AVAILABLE")
    AVAILABLE,
    @SerializedName("UNAVAILABLE")
    UNAVAILABLE,
    @SerializedName("OPERATION")
    OPERATION,
    @SerializedName("BASIC")
    BASIC,
    @SerializedName("ECNY_BASIC")
    ECNY_BASIC
  }
  
  public static class Amount {
    @SerializedName("total")
    public Long total;
  
    @SerializedName("refund")
    public Long refund;
  
    @SerializedName("from")
    public List<FundsFromItem> from;
  
    @SerializedName("payer_total")
    public Long payerTotal;
  
    @SerializedName("payer_refund")
    public Long payerRefund;
  
    @SerializedName("settlement_refund")
    public Long settlementRefund;
  
    @SerializedName("settlement_total")
    public Long settlementTotal;
  
    @SerializedName("discount_refund")
    public Long discountRefund;
  
    @SerializedName("currency")
    public String currency;
  
    @SerializedName("refund_fee")
    public Long refundFee;
  }
  
  public static class Promotion {
    @SerializedName("promotion_id")
    public String promotionId;
  
    @SerializedName("scope")
    public PromotionScope scope;
  
    @SerializedName("type")
    public PromotionType type;
  
    @SerializedName("amount")
    public Long amount;
  
    @SerializedName("refund_amount")
    public Long refundAmount;
  
    @SerializedName("goods_detail")
    public List<GoodsDetail> goodsDetail;
  }
  
  public static class FundsFromItem {
    @SerializedName("account")
    public Account account;
  
    @SerializedName("amount")
    public Integer amount;
  }
  
  public enum PromotionScope {
    @SerializedName("GLOBAL")
    GLOBAL,
    @SerializedName("SINGLE")
    SINGLE
  }
  
  public enum PromotionType {
    @SerializedName("CASH")
    CASH,
    @SerializedName("NOCASH")
    NOCASH
  }
 
 
  public enum Account {
    @SerializedName("AVAILABLE")
    AVAILABLE,
    @SerializedName("UNAVAILABLE")
    UNAVAILABLE
  }
}