feat:转账

2025-12-31 17:20:10 +08:00
1 parent 64ab364ac5
commit b6373210c8
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.pay.api.refund.dto;
+
+import lombok.Data;
+
+/**
+ * 转账单创建 Response DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class PayTransferCreateRespDTO {
+
+    /**
+     * 编号
+     */
+    private Long id;
+
+    // ========== 其它字段 ==========
+
+    /**
+     * 渠道 package 信息
+     *
+     * 特殊：目前只有微信转账有这个东西！！！
+     * @see <a href="https://pay.weixin.qq.com/doc/v3/merchant/4012716430">JSAPI 调起用户确认收款</a>
+     */
+    private String channelPackageInfo;
+
+}
@@ -1,5 +1,6 @@
 package cn.iocoder.yudao.module.pay.api.transfer;

+import cn.iocoder.yudao.module.pay.api.refund.dto.PayTransferCreateRespDTO;
 import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferCreateReqDTO;
 import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferRespDTO;

@@ -18,7 +19,7 @@ public interface PayTransferApi {
     * @param reqDTO 创建请求
     * @return 转账单编号
     */
-    Long createTransfer(@Valid PayTransferCreateReqDTO reqDTO);
+    PayTransferCreateRespDTO createTransfer(@Valid PayTransferCreateReqDTO reqDTO);

    /**
     * 获得转账单
@@ -3,6 +3,8 @@ package cn.iocoder.yudao.module.pay.api.transfer.dto;
 import cn.iocoder.yudao.module.pay.enums.transfer.PayTransferStatusEnum;
 import lombok.Data;

+import java.time.LocalDateTime;
+
@Data
 public class PayTransferRespDTO {

@@ -16,6 +18,22 @@ public class PayTransferRespDTO {
     */
    private String no;

+    /**
+     * 转账渠道编码
+     * <p>
+     * 枚举 {PayChannelEnum}
+     */
+    private String channelCode;
+
+    // ========== 商户相关字段 ==========
+
+    /**
+     * 商户转账单编号
+     */
+    private String merchantTransferId;
+
+    // ========== 转账相关字段 ==========
+
    /**
     * 转账金额，单位：分
     */
@@ -23,9 +41,42 @@ public class PayTransferRespDTO {

    /**
     * 转账状态
-     *
+     * <p>
     * 枚举 {@link PayTransferStatusEnum}
     */
    private Integer status;

+    /**
+     * 订单转账成功时间
+     */
+    private LocalDateTime successTime;
+
+    // ========== 其它字段 ==========
+
+    /**
+     * 调用渠道的错误码
+     */
+    private String channelErrorCode;
+    /**
+     * 调用渠道的错误提示
+     */
+    private String channelErrorMsg;
+
+    /**
+     * 渠道 package 信息
+     * <p>
+     * 特殊：目前只有微信转账有这个东西！！！
+     *
+     * @see <a href="https://pay.weixin.qq.com/doc/v3/merchant/4012716430">JSAPI 调起用户确认收款</a>
+     */
+    private String channelPackageInfo;
+    /**
+     * 渠道商户号
+     * <p>
+     * 特殊：目前只有微信转账有这个东西！！！
+     *
+     * @see <a href="https://pay.weixin.qq.com/doc/v3/merchant/4012716430">JSAPI 调起用户确认收款</a>
+     */
+    private String channelMchId;
+
 }
@@ -73,7 +73,8 @@ public interface ErrorCodeConstants {
    ErrorCode PAY_SAME_MERCHANT_TRANSFER_PRICE_NOT_MATCH = new ErrorCode(1_007_009_003, "两次相同转账请求的金额不匹配");
    ErrorCode PAY_MERCHANT_TRANSFER_EXISTS = new ErrorCode(1_007_009_004, "该笔业务的转账已经发起,请查询转账订单相关状态");
    ErrorCode PAY_TRANSFER_STATUS_IS_NOT_WAITING = new ErrorCode(1_007_009_005, "转账单不处于待转账");
-    ErrorCode PAY_TRANSFER_STATUS_IS_NOT_PENDING = new ErrorCode(1_007_009_006, "转账单不处于待转账或转账中");
+    ErrorCode PAY_TRANSFER_NOTIFY_FAIL_STATUS_IS_NOT_WAITING = new ErrorCode(1_007_009_006, "转账单不处于待转账或转账中");
+    ErrorCode PAY_TRANSFER_NOTIFY_FAIL_STATUS_NOT_WAITING_OR_PROCESSING = new ErrorCode(1_007_009_007, "通知转账结果失败，原因：转账单不处于待转账或转账中");

    // ========== 钱包用户转账模块 1-007-010-000 ==========
    ErrorCode WALLET_USER_TRANSFER_NOT_FOUND = new ErrorCode(1_007_010_000, "用户转账单不存在");
@@ -44,16 +44,18 @@ public enum PayTransferStatusEnum {
    public static boolean isWaiting(Integer status) {
        return Objects.equals(status, WAITING.getStatus());
    }
+
    public static boolean isInProgress(Integer status) {
        return Objects.equals(status, IN_PROGRESS.getStatus());
    }

    /**
     * 是否处于待转账或者转账中的状态
+     *
     * @param status 状态
     */
    public static boolean isPendingStatus(Integer status) {
-        return Objects.equals(status, WAITING.getStatus()) || Objects.equals(status, IN_PROGRESS.getStatus());
+        return Objects.equals(status, IN_PROGRESS.getStatus());
    }

 }