Pay: 转账单实现

2025-11-04 04:08:43 +08:00 · 2023-09-29 13:50:06 +08:00
parent 437185cb1d
commit aa2f651124
20 changed files with 777 additions and 12 deletions
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/api/transfer/PayTransferApiImpl.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/api/transfer/PayTransferApiImpl.java
@@ -0,0 +1,18 @@
+package cn.iocoder.yudao.module.pay.api.transfer;
+
+import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferCreateReqDTO;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+/**
+ * @author jason
+ */
+@Service
+@Validated
+public class PayTransferApiImpl implements PayTransferApi {
+    @Override
+    public Long createTransfer(PayTransferCreateReqDTO reqDTO) {
+
+        return null;
+    }
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/PayTransferController.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/PayTransferController.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.pay.controller.admin.transfer;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitReqVO;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitRespVO;
+import cn.iocoder.yudao.module.pay.service.transfer.PayTransferService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.annotation.Resource;
+import javax.validation.Valid;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.servlet.ServletUtils.getClientIP;
+
+@Tag(name = "管理后台 - 转账单")
+@RestController
+@RequestMapping("/pay/transfer")
+@Validated
+public class PayTransferController {
+
+    @Resource
+    private PayTransferService payTransferService;
+
+    @PostMapping("/submit")
+    @Operation(summary = "提交转账订单")
+    public CommonResult<PayTransferSubmitRespVO> submitPayTransfer(@Valid @RequestBody PayTransferSubmitReqVO reqVO) {
+        PayTransferSubmitRespVO respVO = payTransferService.submitTransfer(reqVO, getClientIP());
+        return success(respVO);
+    }
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/vo/PayTransferSubmitReqVO.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/vo/PayTransferSubmitReqVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.pay.controller.admin.transfer.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import java.util.Map;
+
+@Schema(description = "管理后台 - 转账单提交 Request VO")
+@Data
+public class PayTransferSubmitReqVO {
+
+    @Schema(description = "转账单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "转账单编号不能为空")
+    private Long id;
+
+    @Schema(description = "转账渠道", requiredMode = Schema.RequiredMode.REQUIRED, example = "alipay_transfer")
+    @NotEmpty(message = "转账渠道不能为空")
+    private String channelCode;
+
+    @Schema(description = "转账渠道的额外参数")
+    private Map<String, String> channelExtras;
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/vo/PayTransferSubmitRespVO.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/controller/admin/transfer/vo/PayTransferSubmitRespVO.java
@@ -0,0 +1,12 @@
+package cn.iocoder.yudao.module.pay.controller.admin.transfer.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 转账单提交 Response VO")
+@Data
+public class PayTransferSubmitRespVO {
+
+    @Schema(description = "转账状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1") // 参见 PayTransferStatusEnum 枚举
+    private Integer status;
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/convert/transfer/PayTransferConvert.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/convert/transfer/PayTransferConvert.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.pay.convert.transfer;
+
+import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferCreateReqDTO;
+import cn.iocoder.yudao.module.pay.controller.admin.demo.vo.transfer.PayDemoTransferCreateReqVO;
+import cn.iocoder.yudao.module.pay.dal.dataobject.transfer.PayTransferDO;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import org.mapstruct.factory.Mappers;
+
+/**
+ * @author jason
+ */
+@Mapper
+public interface PayTransferConvert {
+
+    PayTransferConvert  INSTANCE = Mappers.getMapper(PayTransferConvert.class);
+
+    PayTransferDO convert(PayTransferCreateReqDTO dto);
+    @Mapping(source = "transferType", target = "type")
+    PayTransferCreateReqDTO convert(PayDemoTransferCreateReqVO vo);
+
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/dataobject/transfer/PayTransferDO.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/dataobject/transfer/PayTransferDO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.pay.dal.dataobject.transfer;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.Map;
+
+/**
+ * 转账单 DO
+ *
+ * @author jason
+ */
+@TableName(value ="pay_transfer", autoResultMap = true)
+@KeySequence("pay_transfer_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+public class PayTransferDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+
+    /**
+     * 类型
+     */
+    private Integer type;
+
+    /**
+     * 应用编号
+     */
+    private Long appId;
+
+    /**
+     * 商户订单编号
+     */
+    private String merchantOrderId;
+
+    /**
+     * 转账金额，单位：分
+     */
+    private Integer price;
+
+    /**
+     * 转账标题
+     */
+    private String title;
+
+    /**
+     * 收款人信息，不同类型和渠道不同
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private Map<String, String> payeeInfo;
+
+    /**
+     * 转账状态
+     */
+    private Integer status;
+
+    /**
+     * 订单转账成功时间
+     *
+     */
+    private LocalDateTime successTime;
+
+    /**
+     * 转账成功的转账拓展单编号
+     *
+     * 关联 {@link PayTransferExtensionDO#getId()}
+     */
+    private Long extensionId;
+
+    /**
+     * 转账成功的转账拓展单号
+     *
+     * 关联 {@link PayTransferExtensionDO#getNo()}
+     */
+    private String no;
+
+    /**
+     * 转账渠道编号
+     */
+    private Long channelId;
+
+    /**
+     * 转账渠道编码
+     */
+    private String channelCode;
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/dataobject/transfer/PayTransferExtensionDO.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/dataobject/transfer/PayTransferExtensionDO.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.pay.dal.dataobject.transfer;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.Data;
+
+import java.util.Map;
+
+/**
+ * 转账拓展单 DO
+ *
+ * @author jason
+ */
+@TableName(value ="pay_transfer_extension",autoResultMap = true)
+@KeySequence("pay_transfer_extension_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+public class PayTransferExtensionDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+
+    /**
+     * 转账单号
+     */
+    private String no;
+
+    /**
+     * 转账单编号
+     */
+    private Long transferId;
+
+    /**
+     * 转账渠道编号
+     */
+    private Long channelId;
+
+    /**
+     * 转账渠道编码
+     */
+    private String channelCode;
+
+    /**
+     * 支付渠道的额外参数
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private Map<String, String> channelExtras;
+
+    /**
+     * 转账状态
+     */
+    private Integer status;
+
+    /**
+     * 支付渠道异步通知的内容
+     */
+    private String channelNotifyData;
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/mysql/transfer/PayTransferExtensionMapper.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/mysql/transfer/PayTransferExtensionMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.pay.dal.mysql.transfer;
+
+import cn.iocoder.yudao.module.pay.dal.dataobject.transfer.PayTransferExtensionDO;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface PayTransferExtensionMapper extends BaseMapperX<PayTransferExtensionDO> {
+
+    default PayTransferExtensionDO selectByNo(String no){
+       return  selectOne(PayTransferExtensionDO::getNo, no);
+    }
+
+    default int updateByIdAndStatus(Long id, List<Integer> status, PayTransferExtensionDO updateObj){
+        return update(updateObj, new LambdaQueryWrapper<PayTransferExtensionDO>()
+                .eq(PayTransferExtensionDO::getId, id).in(PayTransferExtensionDO::getStatus, status));
+    }
+}
+
+
+
+
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/mysql/transfer/PayTransferMapper.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/dal/mysql/transfer/PayTransferMapper.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.pay.dal.mysql.transfer;
+
+import cn.iocoder.yudao.module.pay.dal.dataobject.transfer.PayTransferDO;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface PayTransferMapper extends BaseMapperX<PayTransferDO> {
+
+    default int updateByIdAndStatus(Long id, List<Integer> status, PayTransferDO updateObj) {
+        return update(updateObj, new LambdaQueryWrapper<PayTransferDO>()
+                .eq(PayTransferDO::getId, id).in(PayTransferDO::getStatus, status));
+    }
+}
+
+
+
+
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/service/transfer/PayTransferService.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/service/transfer/PayTransferService.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.pay.service.transfer;
+
+import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferCreateReqDTO;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitReqVO;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitRespVO;
+
+import javax.validation.Valid;
+
+/**
+ * @author jason
+ */
+public interface PayTransferService {
+
+    /**
+     * 提交转账单
+     *
+     * 此时，会发起支付渠道的调用
+     *
+     * @param reqVO 请求
+     * @param userIp 用户 ip
+     * @return 渠道的返回结果
+     */
+    PayTransferSubmitRespVO submitTransfer(@Valid PayTransferSubmitReqVO reqVO, String userIp);
+
+    /**
+     * 创建转账单
+     *
+     * @param reqDTO 创建请求
+     * @return 转账单编号
+     */
+    Long createTransfer(@Valid PayTransferCreateReqDTO reqDTO);
+}
--- a/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/service/transfer/PayTransferServiceImpl.java
+++ b/yudao-module-pay/yudao-module-pay-biz/src/main/java/cn/iocoder/yudao/module/pay/service/transfer/PayTransferServiceImpl.java
@@ -0,0 +1,266 @@
+package cn.iocoder.yudao.module.pay.service.transfer;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.extra.spring.SpringUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.pay.core.client.PayClient;
+import cn.iocoder.yudao.framework.pay.core.client.PayClientFactory;
+import cn.iocoder.yudao.framework.pay.core.client.dto.transfer.PayTransferRespDTO;
+import cn.iocoder.yudao.framework.pay.core.client.dto.transfer.PayTransferUnifiedReqDTO;
+import cn.iocoder.yudao.framework.pay.core.enums.channel.PayChannelEnum;
+import cn.iocoder.yudao.framework.pay.core.enums.transfer.PayTransferStatusRespEnum;
+import cn.iocoder.yudao.framework.pay.core.enums.transfer.PayTransferTypeEnum;
+import cn.iocoder.yudao.module.pay.api.transfer.dto.PayTransferCreateReqDTO;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitReqVO;
+import cn.iocoder.yudao.module.pay.controller.admin.transfer.vo.PayTransferSubmitRespVO;
+import cn.iocoder.yudao.module.pay.convert.transfer.PayTransferConvert;
+import cn.iocoder.yudao.module.pay.dal.dataobject.channel.PayChannelDO;
+import cn.iocoder.yudao.module.pay.dal.dataobject.transfer.PayTransferDO;
+import cn.iocoder.yudao.module.pay.dal.dataobject.transfer.PayTransferExtensionDO;
+import cn.iocoder.yudao.module.pay.dal.mysql.transfer.PayTransferExtensionMapper;
+import cn.iocoder.yudao.module.pay.dal.mysql.transfer.PayTransferMapper;
+import cn.iocoder.yudao.module.pay.dal.redis.no.PayNoRedisDAO;
+import cn.iocoder.yudao.module.pay.enums.transfer.PayTransferStatusEnum;
+import cn.iocoder.yudao.module.pay.service.app.PayAppService;
+import cn.iocoder.yudao.module.pay.service.channel.PayChannelService;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import javax.annotation.Resource;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.pay.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.pay.enums.transfer.PayTransferStatusEnum.*;
+
+/**
+ * @author jason
+ */
+@Service
+@Slf4j
+public class PayTransferServiceImpl implements PayTransferService {
+    private static final String TRANSFER_NO_PREFIX = "T";
+
+    @Resource
+    private PayTransferMapper transferMapper;
+    @Resource
+    private PayTransferExtensionMapper transferExtensionMapper;
+    @Resource
+    private PayAppService appService;
+    @Resource
+    private PayChannelService channelService;
+    @Resource
+    private PayClientFactory payClientFactory;
+    @Resource
+    private PayNoRedisDAO noRedisDAO;
+
+    @Override
+    public PayTransferSubmitRespVO submitTransfer(PayTransferSubmitReqVO reqVO, String userIp) {
+        // 1.1 校验转账单是否可以提交
+        PayTransferDO transfer = validateTransferCanSubmit(reqVO.getId());
+        // 1.2 校验转账类型和渠道是否匹配
+        validateChannelCodeAndTypeMatch(reqVO.getChannelCode(), transfer.getType());
+        // 1.3 校验支付渠道是否有效
+        PayChannelDO channel = validateChannelCanSubmit(transfer.getAppId(), reqVO.getChannelCode());
+        PayClient client = payClientFactory.getPayClient(channel.getId());
+
+        // 2 新增转账拓展单
+        String no = noRedisDAO.generate(TRANSFER_NO_PREFIX);
+        PayTransferExtensionDO transferExtension = new PayTransferExtensionDO().setNo(no)
+                .setTransferId(transfer.getId()).setChannelId(channel.getId())
+                .setChannelCode(channel.getCode()).setStatus(WAITING.getStatus());
+        transferExtensionMapper.insert(transferExtension);
+
+        // 3. 调用三方渠道发起转账
+        PayTransferUnifiedReqDTO transferUnifiedReq = new PayTransferUnifiedReqDTO()
+                .setOutTransferNo(transferExtension.getNo()).setPrice(transfer.getPrice())
+                .setType(transfer.getType()).setTitle(transfer.getTitle())
+                .setPayeeInfo(transfer.getPayeeInfo()).setUserIp(userIp)
+                .setChannelExtras(reqVO.getChannelExtras());
+        PayTransferRespDTO unifiedTransferResp = client.unifiedTransfer(transferUnifiedReq);
+
+        // 4. 通知转账结果
+        getSelf().notifyTransfer(channel, unifiedTransferResp);
+        // 如有渠道错误码，则抛出业务异常，提示用户
+        if (StrUtil.isNotEmpty(unifiedTransferResp.getChannelErrorCode())) {
+            throw exception(PAY_TRANSFER_SUBMIT_CHANNEL_ERROR, unifiedTransferResp.getChannelErrorCode(),
+                    unifiedTransferResp.getChannelErrorMsg());
+        }
+        return new PayTransferSubmitRespVO().setStatus(unifiedTransferResp.getStatus());
+    }
+
+    @Override
+    public Long createTransfer(PayTransferCreateReqDTO reqDTO) {
+        // 校验 App
+        appService.validPayApp(reqDTO.getAppId());
+        // 创建转账单
+        PayTransferDO transfer = PayTransferConvert.INSTANCE.convert(reqDTO)
+                        .setStatus(WAITING.getStatus());
+        transferMapper.insert(transfer);
+        return transfer.getId();
+    }
+
+    @Transactional(rollbackFor = Exception.class)
+    // 注意，如果是方法内调用该方法，需要通过 getSelf().notifyTransfer(channel, notify) 调用，否则事务不生效
+    public void notifyTransfer(PayChannelDO channel, PayTransferRespDTO notify) {
+        // 转账成功的回调
+        if (PayTransferStatusRespEnum.isSuccess(notify.getStatus())) {
+            notifyTransferSuccess(channel, notify);
+        }
+        // 转账关闭的回调
+        if (PayTransferStatusRespEnum.isClosed(notify.getStatus())) {
+            notifyTransferClosed(channel, notify);
+        }
+        // WAITING 状态无需处理
+        // TODO IN_PROGRESS  待处理
+    }
+    private void notifyTransferSuccess(PayChannelDO channel, PayTransferRespDTO notify) {
+        // 1. 更新 PayTransferExtensionDO 转账成功
+        PayTransferExtensionDO transferExtension = updateTransferExtensionSuccess(notify);
+
+        // 2. 更新 PayTransferDO 转账成功
+        Boolean transferred = updateTransferSuccess(channel,transferExtension, notify);
+        if (transferred) {
+            return ;
+        }
+        // 3. TODO 插入转账通知记录
+    }
+
+    private Boolean updateTransferSuccess(PayChannelDO channel, PayTransferExtensionDO transferExtension,
+                                          PayTransferRespDTO notify) {
+        // 1.校验
+        PayTransferDO transfer = transferMapper.selectById(transferExtension.getTransferId());
+        if (transfer == null) {
+            throw exception(PAY_TRANSFER_NOT_FOUND);
+        }
+        if (isSuccess(transfer.getStatus()) && Objects.equals(transfer.getExtensionId(), transferExtension.getId())) {
+            log.info("[updateTransferSuccess][transfer({}) 已经是已转账，无需更新]", transfer.getId());
+            return true;
+        }
+        if (!isPendingStatus(transfer.getStatus())) {
+            throw exception(PAY_TRANSFER_STATUS_IS_NOT_PENDING);
+        }
+        // 2.更新
+        int updateCounts = transferMapper.updateByIdAndStatus(transfer.getId(),
+                CollUtil.newArrayList(WAITING.getStatus(), IN_PROGRESS.getStatus()),
+                new PayTransferDO().setStatus(SUCCESS.getStatus()).setSuccessTime(notify.getSuccessTime())
+                        .setChannelId(channel.getId()).setChannelCode(channel.getCode())
+                        .setExtensionId(transferExtension.getId()).setNo(transferExtension.getNo()));
+        if (updateCounts == 0) {
+            throw exception(PAY_TRANSFER_STATUS_IS_NOT_PENDING);
+        }
+        log.info("[updateTransferSuccess][transfer({}) 更新为已转账]", transfer.getId());
+        return false;
+    }
+
+    private PayTransferExtensionDO updateTransferExtensionSuccess(PayTransferRespDTO notify) {
+        // 1 校验
+        PayTransferExtensionDO transferExtension = transferExtensionMapper.selectByNo(notify.getOutTransferNo());
+        if (transferExtension == null) {
+            throw exception(PAY_TRANSFER_EXTENSION_NOT_FOUND);
+        }
+        if (isSuccess(transferExtension.getStatus())) { // 如果已成功，直接返回，不用重复更新
+            log.info("[updateTransferExtensionSuccess][transferExtension({}) 已经是成功状态，无需更新]", transferExtension.getId());
+            return transferExtension;
+        }
+        if (!isPendingStatus(transferExtension.getStatus())) {
+            throw exception(PAY_TRANSFER_EXTENSION_STATUS_IS_NOT_PENDING);
+        }
+        // 2. 更新 PayTransferExtensionDO
+        int updateCount = transferExtensionMapper.updateByIdAndStatus(transferExtension.getId(),
+                CollUtil.newArrayList(WAITING.getStatus(), IN_PROGRESS.getStatus()),
+                new PayTransferExtensionDO().setStatus(SUCCESS.getStatus())
+                        .setChannelNotifyData(JsonUtils.toJsonString(notify)));
+        if (updateCount == 0) {
+            throw exception(PAY_TRANSFER_EXTENSION_STATUS_IS_NOT_PENDING);
+        }
+        log.info("[updateTransferExtensionSuccess][transferExtension({}) 更新为已转账]", transferExtension.getId());
+        return transferExtension;
+    }
+
+    private void notifyTransferClosed(PayChannelDO channel, PayTransferRespDTO notify) {
+        //  更新 PayTransferExtensionDO 转账关闭
+        updateTransferExtensionClosed(notify);
+    }
+
+    private void updateTransferExtensionClosed(PayTransferRespDTO notify) {
+        // 1 校验
+        PayTransferExtensionDO transferExtension = transferExtensionMapper.selectByNo(notify.getOutTransferNo());
+        if (transferExtension == null) {
+            throw exception(PAY_TRANSFER_EXTENSION_NOT_FOUND);
+        }
+        if (isClosed(transferExtension.getStatus())) { // 如果已是关闭状态，直接返回，不用重复更新
+            log.info("[updateTransferExtensionSuccess][transferExtension({}) 已经是关闭状态，无需更新]", transferExtension.getId());
+            return;
+        }
+        if (!isPendingStatus(transferExtension.getStatus())) {
+            throw exception(PAY_TRANSFER_EXTENSION_STATUS_IS_NOT_PENDING);
+        }
+        // 2. 更新 PayTransferExtensionDO
+        int updateCount = transferExtensionMapper.updateByIdAndStatus(transferExtension.getId(),
+                CollUtil.newArrayList(WAITING.getStatus(), IN_PROGRESS.getStatus()),
+                new PayTransferExtensionDO().setStatus(CLOSED.getStatus())
+                        .setChannelNotifyData(JsonUtils.toJsonString(notify)));
+        if (updateCount == 0) {
+            throw exception(PAY_TRANSFER_EXTENSION_STATUS_IS_NOT_PENDING);
+        }
+        log.info("[updateTransferExtensionSuccess][transferExtension({}) 更新为关闭状态]", transferExtension.getId());
+    }
+
+    private void validateChannelCodeAndTypeMatch(String channelCode, Integer type) {
+        PayTransferTypeEnum transferType = PayTransferTypeEnum.ofType(type);
+        PayChannelEnum payChannel = PayChannelEnum.getByCode(channelCode);
+        switch (transferType) {
+            case ALIPAY_BALANCE: {
+                if (payChannel != PayChannelEnum.ALIPAY_TRANSFER) {
+                    throw exception(PAY_TRANSFER_TYPE_AND_CHANNEL_NOT_MATCH);
+                }
+                break;
+            }
+            case WX_BALANCE:
+            case BANK_CARD:
+            case WALLET_BALANCE: {
+                throw new UnsupportedOperationException("待实现");
+            }
+        }
+    }
+
+    private PayChannelDO validateChannelCanSubmit(Long appId, String channelCode) {
+        // 校验 App
+        appService.validPayApp(appId);
+        // 校验支付渠道是否有效
+        PayChannelDO channel = channelService.validPayChannel(appId, channelCode);
+        PayClient client = payClientFactory.getPayClient(channel.getId());
+        if (client == null) {
+            log.error("[validateChannelCanSubmit][渠道编号({}) 找不到对应的支付客户端]", channel.getId());
+            throw exception(CHANNEL_NOT_FOUND);
+        }
+        return channel;
+    }
+
+    private PayTransferDO validateTransferCanSubmit(Long id) {
+        PayTransferDO transfer = transferMapper.selectById(id);
+        if (transfer == null) { // 是否存在
+            throw exception(PAY_TRANSFER_NOT_FOUND);
+        }
+        if (PayTransferStatusEnum.isSuccess(transfer.getStatus())) {
+            throw exception(PAY_TRANSFER_STATUS_IS_SUCCESS);
+        }
+        if (!PayTransferStatusEnum.isWaiting(transfer.getStatus())) {
+            throw exception(PAY_TRANSFER_STATUS_IS_NOT_WAITING);
+        }
+        // TODO 查询拓展单是否未已转账和转账中
+        return transfer;
+    }
+
+    /**
+     * 获得自身的代理对象，解决 AOP 生效问题
+     *
+     * @return 自己
+     */
+    private PayTransferServiceImpl getSelf() {
+        return SpringUtil.getBean(getClass());
+    }
+}