2026-06-25 a26b31cc9f3ee9b21b1a754e80fa7359e8a7a8f8
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
package cn.iocoder.yudao.module.pay.controller.admin.refund.vo;
 
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
 
import java.time.LocalDateTime;
 
/**
* 退款订单 Base VO,提供给添加、修改、详细的子 VO 使用
* 如果子 VO 存在差异的字段,请不要添加到这里,影响 Swagger 文档生成
*/
@Data
public class PayRefundBaseVO {
 
    @Schema(description = "外部退款号", requiredMode = Schema.RequiredMode.REQUIRED, example = "110")
    private String no;
 
    @Schema(description = "应用编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long appId;
 
    @Schema(description = "渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
    private Long channelId;
 
    @Schema(description = "渠道编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "wx_app")
    private String channelCode;
 
    @Schema(description = "订单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
    private Long orderId;
 
    // ========== 商户相关字段 ==========
 
    @Schema(description = "商户订单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "225")
    private String merchantOrderId;
 
    @Schema(description = "商户退款订单号", requiredMode = Schema.RequiredMode.REQUIRED, example = "512")
    private String merchantRefundId;
 
    @Schema(description = "异步通知地址", requiredMode = Schema.RequiredMode.REQUIRED)
    private String notifyUrl;
 
    // ========== 退款相关字段 ==========
 
    @Schema(description = "退款状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
    private Integer status;
 
    @Schema(description = "支付金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
    private Long payPrice;
 
    @Schema(description = "退款金额,单位分", requiredMode = Schema.RequiredMode.REQUIRED, example = "200")
    private Long refundPrice;
 
    @Schema(description = "退款原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "我要退了")
    private String reason;
 
    @Schema(description = "用户 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "127.0.0.1")
    private String userIp;
 
    // ========== 渠道相关字段 ==========
 
    @Schema(description = "渠道订单号", requiredMode = Schema.RequiredMode.REQUIRED, example = "233")
    private String channelOrderNo;
 
    @Schema(description = "渠道退款单号", example = "2022")
    private String channelRefundNo;
 
    @Schema(description = "退款成功时间")
    private LocalDateTime successTime;
 
    @Schema(description = "调用渠道的错误码")
    private String channelErrorCode;
 
    @Schema(description = "调用渠道的错误提示")
    private String channelErrorMsg;
 
    @Schema(description = "支付渠道的额外参数")
    private String channelNotifyData;
 
}