签入版本

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/config/AlipayConfig.java

@@ -0,0 +1,474 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.config;
+
+import com.alipay.api.AlipayClient;
+import com.alipay.api.DefaultAlipayClient;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * <p>
+ * 支付宝支付配置类
+ * 负责管理支付宝支付相关的所有配置参数，包括密钥、网关地址、回调地址等
+ * 使用@ConfigurationProperties注解从application.yml/properties文件中读取配置
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+@Configuration
+@ConfigurationProperties(prefix = "alipay") // 配置前缀，对应配置文件中的alipay.*属性
+public class AlipayConfig {
+
+    // ============================== 支付宝基础配置参数 ==============================
+
+    /**
+     * 支付宝网关URL
+     * 用于指定支付宝API的服务器地址
+     * 生产环境：https://openapi.alipay.com/gateway.do
+     * 沙箱环境：https://openapi.alipaydev.com/gateway.do
+     * 必填参数，最大长度256字符
+     */
+    public static String gatewayUrl;
+
+    /**
+     * 支付宝应用ID（APPID）
+     * 在支付宝开放平台创建应用后获取的唯一标识
+     * 格式：20位数字，如：2021000116691234
+     * 必填参数，用于标识商户身份
+     */
+    public static String alipayAppId;
+
+    /**
+     * 商户应用私钥
+     * 使用支付宝提供的密钥生成工具（如openssl）生成的RSA私钥
+     * 格式：PKCS#8格式的私钥字符串
+     * 必填参数，用于生成请求签名，确保请求安全性
+     * 示例：MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...
+     */
+    public static String privateKey;
+
+    /**
+     * 商户应用公钥
+     * 与私钥配对的公钥，需要上传到支付宝开放平台
+     * 格式：RSA公钥字符串
+     * 选填参数，主要用于密钥验证
+     * 注意：此公钥需要与支付宝后台配置的公钥保持一致
+     */
+    public static String publicKey;
+
+    /**
+     * 支付宝公钥
+     * 从支付宝开放平台获取的公钥，用于验证支付宝返回数据的签名
+     * 格式：RSA公钥字符串
+     * 必填参数，确保响应数据的真实性和完整性
+     * 注意：不要与商户应用公钥混淆
+     */
+    public static String alipayPublicKey;
+
+    /**
+     * 支付结果异步通知地址
+     * 支付宝服务器主动通知商户服务器支付结果的URL
+     * 必须是公网可访问的URL，支持http/https协议
+     * 必填参数，用于接收支付成功、失败等状态变更通知
+     * 示例：https://yourdomain.com/api/alipay/notify
+     */
+    public static String notifyUrl;
+
+    /**
+     * 支付完成页面跳转地址
+     * 用户支付完成后浏览器跳转返回的页面URL
+     * 通常用于展示支付成功页面
+     * 选填参数，仅适用于PC网站支付和WAP支付
+     * 示例：https://yourdomain.com/pay/success
+     */
+    public static String returnUrl;
+
+    /**
+     * 签名算法类型
+     * 指定生成和验证签名使用的算法
+     * 可选值：RSA2（推荐）、RSA
+     * RSA2：使用SHA256WithRSA，更安全
+     * RSA：使用SHA1WithRSA，兼容旧版本
+     * 默认值：RSA2
+     */
+    public static String signType;
+
+    /**
+     * 请求数据格式
+     * 指定与支付宝API通信的数据格式
+     * 固定值：json
+     * 目前支付宝API仅支持JSON格式
+     */
+    public static String format;
+
+    /**
+     * 字符编码格式
+     * 指定请求和响应数据的字符编码
+     * 可选值：UTF-8（推荐）、GBK、GB2312
+     * 默认值：UTF-8
+     * 建议使用UTF-8以确保更好的兼容性
+     */
+    public static String charset;
+
+    // ============================== 支付宝客户端实例 ==============================
+
+    /**
+     * 支付宝客户端单例实例
+     * 使用懒加载模式创建，确保线程安全
+     * 采用双重检查锁（Double-Checked Locking）模式
+     * volatile关键字确保多线程环境下的可见性
+     */
+    private static volatile AlipayClient alipayClient = null;
+
+    // ============================== Getter和Setter方法 ==============================
+
+    /**
+     * 获取支付宝网关URL
+     *
+     * @return 支付宝网关URL字符串
+     */
+    public static String getGatewayUrl() {
+        return gatewayUrl;
+    }
+
+    /**
+     * 设置支付宝网关URL
+     * 在Spring配置注入时自动调用
+     *
+     * @param gatewayUrl 网关URL
+     */
+    public void setGatewayUrl(String gatewayUrl) {
+        AlipayConfig.gatewayUrl = gatewayUrl;
+    }
+
+    /**
+     * 获取支付宝应用ID
+     *
+     * @return 支付宝应用ID字符串
+     */
+    public static String getAlipayAppId() {
+        return alipayAppId;
+    }
+
+    /**
+     * 设置支付宝应用ID
+     * 注意：方法名与配置属性名保持一致（alipay-appid对应setAlipayAppid）
+     *
+     * @param alipayAppid 支付宝应用ID
+     */
+    public void setAlipayAppid(String alipayAppid) {
+        AlipayConfig.alipayAppId = alipayAppid;
+    }
+
+    /**
+     * 获取商户应用私钥
+     *
+     * @return 商户私钥字符串
+     */
+    public static String getPrivateKey() {
+        return privateKey;
+    }
+
+    /**
+     * 设置商户应用私钥
+     *
+     * @param privateKey 商户私钥
+     */
+    public void setPrivateKey(String privateKey) {
+        AlipayConfig.privateKey = privateKey;
+    }
+
+    /**
+     * 获取商户应用公钥
+     *
+     * @return 商户公钥字符串
+     */
+    public static String getPublicKey() {
+        return publicKey;
+    }
+
+    /**
+     * 设置商户应用公钥
+     *
+     * @param publicKey 商户公钥
+     */
+    public void setPublicKey(String publicKey) {
+        AlipayConfig.publicKey = publicKey;
+    }
+
+    /**
+     * 获取支付宝公钥
+     *
+     * @return 支付宝公钥字符串
+     */
+    public static String getAlipayPublicKey() {
+        return alipayPublicKey;
+    }
+
+    /**
+     * 设置支付宝公钥
+     *
+     * @param alipayPublicKey 支付宝公钥
+     */
+    public void setAlipayPublicKey(String alipayPublicKey) {
+        AlipayConfig.alipayPublicKey = alipayPublicKey;
+    }
+
+    /**
+     * 获取异步通知地址
+     *
+     * @return 异步通知URL字符串
+     */
+    public static String getNotifyUrl() {
+        return notifyUrl;
+    }
+
+    /**
+     * 设置异步通知地址
+     *
+     * @param notifyUrl 异步通知URL
+     */
+    public void setNotifyUrl(String notifyUrl) {
+        AlipayConfig.notifyUrl = notifyUrl;
+    }
+
+    /**
+     * 获取页面跳转地址
+     *
+     * @return 页面跳转URL字符串
+     */
+    public static String getReturnUrl() {
+        return returnUrl;
+    }
+
+    /**
+     * 设置页面跳转地址
+     *
+     * @param returnUrl 页面跳转URL
+     */
+    public void setReturnUrl(String returnUrl) {
+        AlipayConfig.returnUrl = returnUrl;
+    }
+
+    /**
+     * 获取签名算法类型
+     *
+     * @return 签名算法类型字符串（RSA2或RSA）
+     */
+    public static String getSignType() {
+        return signType;
+    }
+
+    /**
+     * 设置签名算法类型
+     *
+     * @param signType 签名算法类型
+     */
+    public void setSignType(String signType) {
+        AlipayConfig.signType = signType;
+    }
+
+    /**
+     * 获取请求数据格式
+     *
+     * @return 数据格式字符串（固定为json）
+     */
+    public static String getFormat() {
+        return format;
+    }
+
+    /**
+     * 设置请求数据格式
+     *
+     * @param format 数据格式
+     */
+    public void setFormat(String format) {
+        AlipayConfig.format = format;
+    }
+
+    /**
+     * 获取字符编码格式
+     *
+     * @return 字符编码字符串
+     */
+    public static String getCharset() {
+        return charset;
+    }
+
+    /**
+     * 设置字符编码格式
+     *
+     * @param charset 字符编码
+     */
+    public void setCharset(String charset) {
+        AlipayConfig.charset = charset;
+    }
+
+    // ============================== 支付宝客户端管理方法 ==============================
+
+    /**
+     * 获得初始化的AlipayClient实例
+     * 采用单例模式，确保整个应用中只有一个AlipayClient实例
+     * 使用双重检查锁（DCL）模式保证线程安全和性能
+     *
+     * @return 支付宝客户端实例
+     * @throws IllegalStateException 当必要配置参数未设置时抛出
+     * @throws RuntimeException      当创建支付宝客户端失败时抛出
+     */
+    public static AlipayClient getAlipayClient() {
+        // 第一次检查，避免不必要的同步开销
+        if (alipayClient == null) {
+            // 同步代码块，确保线程安全
+            synchronized (AlipayConfig.class) {
+                // 第二次检查，防止多个线程同时通过第一次检查
+                if (null == alipayClient) {
+                    // 验证必要配置参数是否已设置
+                    validateRequiredConfig();
+
+                    // 创建DefaultAlipayClient实例
+                    // 参数说明：
+                    // 1. gatewayUrl - 支付宝网关地址
+                    // 2. alipayAppId - 应用ID
+                    // 3. privateKey - 商户私钥
+                    // 4. format - 数据格式
+                    // 5. charset - 字符编码
+                    // 6. alipayPublicKey - 支付宝公钥
+                    // 7. signType - 签名类型
+                    alipayClient = new DefaultAlipayClient(
+                            gatewayUrl,
+                            alipayAppId,
+                            privateKey,
+                            format,
+                            charset,
+                            alipayPublicKey,
+                            signType
+                    );
+                }
+            }
+        }
+        return alipayClient;
+    }
+
+    /**
+     * 验证必要的配置参数是否已正确设置
+     * 在创建AlipayClient之前调用，确保配置完整性
+     *
+     * @throws IllegalStateException 当必要参数缺失时抛出
+     */
+    private static void validateRequiredConfig() {
+        if (gatewayUrl == null || gatewayUrl.trim().isEmpty()) {
+            throw new IllegalStateException("支付宝网关地址(gatewayUrl)未配置，请在application.yml中设置alipay.gateway-url");
+        }
+        if (alipayAppId == null || alipayAppId.trim().isEmpty()) {
+            throw new IllegalStateException("支付宝应用ID(alipayAppId)未配置，请在application.yml中设置alipay.alipay-appid");
+        }
+        if (privateKey == null || privateKey.trim().isEmpty()) {
+            throw new IllegalStateException("商户私钥(privateKey)未配置，请在application.yml中设置alipay.private-key");
+        }
+        if (alipayPublicKey == null || alipayPublicKey.trim().isEmpty()) {
+            throw new IllegalStateException("支付宝公钥(alipayPublicKey)未配置，请在application.yml中设置alipay.alipay-public-key");
+        }
+
+        // 设置默认值（如果未配置）
+        if (charset == null || charset.trim().isEmpty()) {
+            charset = "UTF-8";
+        }
+        if (signType == null || signType.trim().isEmpty()) {
+            signType = "RSA2";
+        }
+        if (format == null || format.trim().isEmpty()) {
+            format = "json";
+        }
+    }
+
+    /**
+     * 重置支付宝客户端实例
+     * 在配置发生变化时调用，强制重新创建客户端
+     * 使用场景：动态更新配置后需要重新初始化客户端
+     */
+    public static void resetAlipayClient() {
+        synchronized (AlipayConfig.class) {
+            alipayClient = null;
+        }
+    }
+
+    /**
+     * 检查支付宝客户端是否已初始化
+     *
+     * @return true-已初始化，false-未初始化
+     */
+    public static boolean isAlipayClientInitialized() {
+        return alipayClient != null;
+    }
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/AlipayNotifyParamDTO.java

@@ -0,0 +1,195 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import com.alibaba.fastjson2.annotation.JSONField;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.Date;
+
+/**
+ * <p>
+ * 支付宝通知参数VO
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+@Data
+public class AlipayNotifyParamDTO {
+
+    /**
+     * 支付宝应用的APPID
+     */
+    @JSONField(name = "app_id")
+    private String appId;
+    /**
+     * 支付宝交易凭证号
+     */
+    @JSONField(name = "trade_no")
+    private String tradeNo;
+    /**
+     * 商家订单号,原支付请求的商家订单号
+     */
+    @JSONField(name = "out_trade_no")
+    private String outTradeNo;
+    /**
+     * 商家业务号。商家业务ID，通常是退款通知中返回的退款申请流水号
+     */
+    @JSONField(name = "out_biz_no")
+    private String outBizNo;
+    /**
+     * 买家支付宝账号 ID。以 2088 开头的纯 16 位数字
+     */
+    @JSONField(name = "buyer_id")
+    private String buyerId;
+    /**
+     * 买家支付宝账号
+     */
+    @JSONField(name = "buyer_logon_id")
+    private String buyerLogonId;
+    /**
+     * 卖家支付宝用户号
+     */
+    @JSONField(name = "seller_id")
+    private String sellerId;
+    /**
+     * 卖家支付宝账号
+     */
+    @JSONField(name = "seller_email")
+    private String sellerEmail;
+    /**
+     * 交易目前所处的状态，见交易状态说明
+     */
+    @JSONField(name = "trade_status")
+    private String tradeStatus;
+    /**
+     * 订单金额。本次交易支付订单金额，单位为人民币（元），精确到小数点后 2 位
+     */
+    @JSONField(name = "total_amount")
+    private BigDecimal totalAmount;
+    /**
+     * 实收金额（商家在交易中实际收到的款项）。商家在交易中实际收到的款项，单位为人民币（元），精确到小数点后 2 位
+     */
+    @JSONField(name = "receipt_amount")
+    private BigDecimal receiptAmount;
+    /**
+     * 用户在交易中支付的金额，单位为人民币（元），精确到小数点后 2 位
+     */
+    @JSONField(name = "buyer_pay_amount")
+    private BigDecimal buyerPayAmount;
+    /**
+     * 总退款金额。退款通知中，返回总退款金额，单位为人民币（元），精确到小数点后 2 位
+     */
+    @JSONField(name = "refund_fee")
+    private BigDecimal refundFee;
+    /**
+     * 商品的标题/交易标题/订单标题/订单关键字等
+     */
+    private String subject;
+    /**
+     * 商品描述。该订单的备注、描述、明细等。对应请求时的 body 参数，会在通知中原样传回
+     */
+    private String body;
+    /**
+     * 该笔交易创建的时间。格式为yyyy-MM-dd HH:mm:ss
+     */
+    @JSONField(name = "gmt_create", format = "yyyy-MM-dd HH:mm:ss")
+    private Date gmtCreate;
+    /**
+     * 该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss
+     */
+    @JSONField(name = "gmt_payment", format = "yyyy-MM-dd HH:mm:ss")
+    private Date gmtPayment;
+    /**
+     * 该笔交易的退款时间。格式为yyyy-MM-dd HH:mm:ss.S
+     */
+    @JSONField(name = "gmt_refund", format = "yyyy-MM-dd HH:mm:ss")
+    private Date gmtRefund;
+    /**
+     * 该笔交易结束时间。格式为yyyy-MM-dd HH:mm:ss
+     */
+    @JSONField(name = "gmt_close", format = "yyyy-MM-dd HH:mm:ss")
+    private Date gmtClose;
+    /**
+     * 支付成功的各个渠道金额信息,array
+     */
+    @JSONField(name = "fund_bill_list")
+    private String fundBillList;
+    /**
+     * 回传参数，公共回传参数，如果请求时传递了该参数，则返回的异步通知会原样传回。本参数必须进行 UrlEncode 之后才可传入。
+     */
+    @JSONField(name = "passback_params")
+    private String passbackParams;
+
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/PreOrderParamsDTO.java

@@ -0,0 +1,186 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.Map;
+
+/**
+ * <p>
+ * PC网站支付下单参数数据传输对象
+ * 用于封装发起支付宝PC网站支付所需的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class PreOrderParamsDTO {
+
+    /**
+     * 商户订单号
+     * 必填，商户网站唯一订单号，最大长度64个字符
+     * 示例：2024032300010001
+     */
+    private String out_trade_no;
+
+    /**
+     * 订单总金额
+     * 必填，单位为元，精确到小数点后两位
+     * 取值范围：[0.01,100000000.00]
+     * 示例：88.88
+     */
+    private BigDecimal total_amount;
+
+    /**
+     * 订单标题
+     * 必填，商品的标题/交易标题/订单标题
+     * 最大长度256个字符
+     * 示例：iPhone 15 Pro Max 1TB 黑色"
+     */
+    private String subject;
+
+    /**
+     * 订单描述
+     * 选填，对交易或商品的描述
+     * 最大长度128个字符
+     * 示例：苹果手机iPhone 15 Pro Max 1TB 深空黑色"
+     */
+    private String body;
+
+    /**
+     * 产品码
+     * 必填，PC网站支付固定值：FAST_INSTANT_TRADE_PAY
+     * 其他场景可能值：FACE_TO_FACE_PAYMENT（当面付）
+     */
+    private String product_code;
+
+    /**
+     * 商品主类型
+     * 选填，0-虚拟类商品，1-实物类商品
+     * 默认值为1（实物类商品）
+     */
+    private String goods_type;
+
+    /**
+     * 超时时间
+     * 选填，该笔订单允许的最晚付款时间，逾期将关闭交易
+     * 格式：1m～15d，m-分钟，h-小时，d-天
+     * 示例：30m（30分钟）
+     */
+    private String timeout_express;
+
+    /**
+     * 公用回传参数
+     * 选填，如果请求时传递了该参数，则返回给商户时会回传该参数
+     * 支付宝会在异步通知时将该参数原样返回
+     * 最大长度512个字符
+     */
+    private String passback_params;
+
+    /**
+     * 优惠参数
+     * 选填，仅与支付宝协商后使用
+     * 用于商户传入营销信息，JSON格式
+     */
+    private String promo_params;
+
+    /**
+     * 业务扩展参数
+     * 选填，JSON格式，具体参数需要与支付宝业务人员确认
+     * 示例：{"sys_service_provider_id":"2088511833207846"}
+     */
+    private Map<String, Object> extend_params;
+
+    /**
+     * 可用渠道
+     * 选填，用户不可用指定渠道支付时，可用此参数禁用
+     * 多个渠道以逗号分割，如：pcredit,moneyFund,debitCardExpress
+     */
+    private String disable_pay_channels;
+
+    /**
+     * 门店编号
+     * 选填，商户门店编号，通过此参数指定门店编号
+     * 最大长度32个字符
+     */
+    private String store_id;
+
+    /**
+     * 外部指定买家
+     * 选填，JSON格式，包含买家支付宝用户ID等信息
+     * 示例：{"name":"张三","mobile":"13800138000"}
+     */
+    private String ext_user_info;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/RefundQueryParamDTO.java

@@ -0,0 +1,109 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 退款查询参数数据传输对象
+ * 用于封装查询支付宝退款状态所需的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class RefundQueryParamDTO {
+
+    /**
+     * 商户订单号
+     * 与支付宝交易号二选一，请求退款接口时传入的商户订单号
+     * 最大长度64个字符
+     */
+    private String out_trade_no;
+
+    /**
+     * 支付宝交易号
+     * 与商户订单号二选一，支付宝交易号
+     * 最大长度64个字符
+     */
+    private String trade_no;
+
+    /**
+     * 退款请求号
+     * 必填，请求退款接口时传入的退款请求号
+     * 如果在退款请求时未传入，则该值为创建交易时的商户订单号
+     * 最大长度64个字符
+     */
+    private String out_request_no;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/RefundRequestParamDTO.java

@@ -0,0 +1,161 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * <p>
+ * 退款请求参数数据传输对象
+ * 用于封装发起支付宝退款所需的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class RefundRequestParamDTO {
+
+    /**
+     * 商户订单号
+     * 与支付宝交易号二选一，原支付交易对应的商户订单号
+     * 最大长度64个字符
+     */
+    private String out_trade_no;
+
+    /**
+     * 支付宝交易号
+     * 与商户订单号二选一，支付宝交易号
+     * 最大长度64个字符
+     */
+    private String trade_no;
+
+    /**
+     * 退款金额
+     * 必填，需要退款的金额，该金额不能大于订单金额
+     * 单位为元，支持两位小数
+     * 示例：100.00
+     */
+    private BigDecimal refund_amount;
+
+    /**
+     * 退款原因说明
+     * 选填，商家自定义的退款原因，用于记录和展示
+     * 最大长度256个字符
+     * 示例：用户申请退款"
+     */
+    private String refund_reason;
+
+    /**
+     * 退款请求号
+     * 选填，标识一次退款请求，同一交易多次退款需要保证唯一
+     * 如需部分退款，此参数必传
+     * 最大长度64个字符
+     */
+    private String out_request_no;
+
+    /**
+     * 退款明细信息
+     * 选填，JSON格式，包含退款资金明细和退款商品明细
+     * 示例：[
+     * {
+     * "fund_channel":"ALIPAYACCOUNT",
+     * "amount":10.00,
+     * "real_amount":10.00
+     * }
+     * ]
+     */
+    private String refund_detail_item_list;
+
+    /**
+     * 操作员编号
+     * 选填，商户的操作员编号，用于记录操作人员
+     * 最大长度30个字符
+     */
+    private String operator_id;
+
+    /**
+     * 商户门店编号
+     * 选填，商户门店编号，通过此参数指定门店
+     * 最大长度32个字符
+     */
+    private String store_id;
+
+    /**
+     * 终端编号
+     * 选填，商户的终端设备编号
+     * 最大长度32个字符
+     */
+    private String terminal_id;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/TradePrecreateParamDTO.java

@@ -0,0 +1,171 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * <p>
+ * 二维码支付参数数据传输对象
+ * 用于封装生成支付宝当面付二维码所需的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TradePrecreateParamDTO {
+
+    /**
+     * 商户订单号
+     * 必填，商户网站唯一订单号，最大长度64个字符
+     * 示例：2024032300010001
+     */
+    private String out_trade_no;
+
+    /**
+     * 订单总金额
+     * 必填，单位为元，精确到小数点后两位
+     * 取值范围：[0.01,100000000.00]
+     * 示例：199.00
+     */
+    private BigDecimal total_amount;
+
+    /**
+     * 订单标题
+     * 必填，商品的标题/交易标题/订单标题
+     * 最大长度256个字符
+     * 示例：星巴克拿铁咖啡大杯"
+     */
+    private String subject;
+
+    /**
+     * 订单描述
+     * 选填，对交易或商品的描述
+     * 最大长度128个字符
+     * 示例：大杯热拿铁咖啡，加糖"
+     */
+    private String body;
+
+    /**
+     * 卖家支付宝用户ID
+     * 选填，如果该值为空，则默认为商户签约账号对应的支付宝用户ID
+     * 最大长度28个字符
+     */
+    private String seller_id;
+
+    /**
+     * 折扣金额
+     * 选填，商家优惠金额，单位元
+     * 示例：10.00
+     */
+    private BigDecimal discountable_amount;
+
+    /**
+     * 商品信息
+     * 选填，订单包含的商品列表信息，JSON格式
+     * 示例：[
+     * {
+     * "goods_id":"apple-01",
+     * "goods_name":"iPhone",
+     * "quantity":1,
+     * "price":5999.00,
+     * "goods_category":"123456"
+     * }
+     * ]
+     */
+    private String goods_detail;
+
+    /**
+     * 业务扩展参数
+     * 选填，JSON格式，具体参数需要与支付宝业务人员确认
+     * 示例：{"sys_service_provider_id":"2088511833207846"}
+     */
+    private String extend_params;
+
+    /**
+     * 超时时间
+     * 选填，该笔订单允许的最晚付款时间，逾期将关闭交易
+     * 格式：1m～15d，m-分钟，h-小时，d-天
+     * 示例：2h（2小时）
+     */
+    private String timeout_express;
+
+    /**
+     * 商户机具终端编号
+     * 选填，商户机具终端编号
+     * 最大长度32个字符
+     */
+    private String terminal_id;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/dto/TransferParamDTO.java

@@ -0,0 +1,156 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.dto;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * <p>
+ * 支付宝转账参数数据传输对象
+ * 用于封装向支付宝账户发起单笔转账所需的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TransferParamDTO {
+
+    /**
+     * 商户转账唯一订单号
+     * 必填，发起转账来源方定义的转账单据ID，用于幂等控制
+     * 最大长度64个字符
+     * 示例：2024032300010001
+     */
+    private String out_biz_no;
+
+    /**
+     * 转账金额
+     * 必填，转账金额，单位元
+     * 取值范围：[0.1,100000000.00]
+     * 示例：1000.00
+     */
+    private BigDecimal trans_amount;
+
+    /**
+     * 收款方账户
+     * 必填，收款方支付宝账号，支持邮箱、手机号格式
+     * 示例：13800138000 或 example@alipay.com
+     */
+    private String payee_account;
+
+    /**
+     * 收款方真实姓名
+     * 必填，收款方真实姓名
+     * 最大长度64个字符
+     * 示例：张三
+     */
+    private String payee_real_name;
+
+    /**
+     * 转账备注
+     * 选填，转账备注，显示在支付宝账单的备注中
+     * 最大长度100个字符
+     * 示例：2024年3月工资发放"
+     */
+    private String remark;
+
+    /**
+     * 业务产品码
+     * 选填，不同产品码对应不同业务场景
+     * 单笔无密转账到支付宝账户固定为：TRANS_ACCOUNT_NO_PWD
+     */
+    private String product_code;
+
+    /**
+     * 业务场景
+     * 选填，描述转账业务的场景
+     * 示例：DIRECT_TRANSFER（单笔无密转账）
+     */
+    private String biz_scene;
+
+    /**
+     * 订单标题
+     * 选填，转账业务的标题，用于在支付宝账单中展示
+     * 最大长度100个字符
+     * 示例：工资发放"
+     */
+    private String order_title;
+
+    /**
+     * 业务子类型
+     * 选填，业务子类型，如：SALARY（工资）、BONUS（奖金）等
+     */
+    private String business_params;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/service/AlipayService.java

@@ -0,0 +1,211 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.service;
+
+import com.xiaomayi.alipay.dto.*;
+import com.xiaomayi.alipay.vo.*;
+import jakarta.servlet.http.HttpServletRequest;
+
+import java.util.Map;
+
+/**
+ * <p>
+ * 支付宝支付服务接口
+ * 提供完整的支付宝支付能力，包括下单、退款、查询、转账、账单下载等功能
+ * 该接口定义了所有与支付宝支付相关的业务操作方法
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+public interface AlipayService {
+
+    /**
+     * PC网站统一下单支付
+     * 用于生成PC端支付宝支付页面表单，用户扫码或登录支付宝完成支付
+     *
+     * @param preOrderParamsDTO 下单参数DTO，包含订单号、金额、商品标题等信息
+     * @return 支付表单HTML代码，可直接渲染到前端页面
+     * @throws BusinessException 当参数验证失败或支付宝接口调用异常时抛出
+     */
+    String pcPreOrder(PreOrderParamsDTO preOrderParamsDTO);
+
+    /**
+     * 支付宝异步回调通知处理
+     * 接收支付宝服务器发送的支付结果异步通知，验证签名并处理业务逻辑
+     *
+     * @param request HTTP请求对象，包含支付宝回调的所有参数
+     * @return 通知处理结果VO，包含是否接收成功、交易状态等信息
+     */
+    NotifyParamsVO alipayNotify(HttpServletRequest request);
+
+    /**
+     * 支付宝异步回调通知处理（Map参数版本）
+     * 适用于参数已解析为Map格式的场景
+     *
+     * @param params 已解析的回调参数Map
+     * @return 通知处理结果VO
+     */
+    NotifyParamsVO alipayNotify(Map<String, String> params);
+
+    /**
+     * 退款申请
+     * 对已支付的订单发起退款请求，支持部分退款和全额退款
+     *
+     * @param refundRequestParamDTO 退款请求参数DTO，包含订单号、退款金额、退款原因等
+     * @return 退款响应结果VO，包含退款状态、退款时间等信息
+     * @throws BusinessException 当退款参数无效或支付宝退款接口调用失败时抛出
+     */
+    RefundResponseVO pcRefund(RefundRequestParamDTO refundRequestParamDTO);
+
+    /**
+     * 退款查询
+     * 查询指定退款请求的处理状态和详细信息
+     *
+     * @param refundQueryParamDTO 退款查询参数DTO，包含商户退款单号或支付宝退款单号
+     * @return 退款查询结果VO，包含退款状态、退款金额、退款时间等详细信息
+     */
+    RefundQueryResponseVO refundQuery(RefundQueryParamDTO refundQueryParamDTO);
+
+    /**
+     * 生成支付二维码（当面付）
+     * 生成用于线下扫码支付的二维码，适用于门店、自助机等场景
+     *
+     * @param tradePrecreateParamDTO 二维码支付参数DTO，包含订单信息、金额等
+     * @return 二维码支付响应VO，包含二维码内容、订单号等信息
+     * @throws BusinessException 当二维码生成失败时抛出
+     */
+    TradePrecreateResponseVO tradePrecreatePay(TradePrecreateParamDTO tradePrecreateParamDTO);
+
+    /**
+     * 交易查询
+     * 根据商户订单号或支付宝交易号查询订单的详细信息和状态
+     *
+     * @param tradeNo       商户订单号，商户系统内部的订单号
+     * @param alipayTradeNo 支付宝交易号，支付宝系统生成的交易流水号
+     * @return 交易查询结果VO，包含订单状态、金额、买家信息等
+     * @throws BusinessException 当查询参数无效或查询失败时抛出
+     */
+    TradeQueryResponseVO tradeQuery(String tradeNo, String alipayTradeNo);
+
+    /**
+     * 交易关闭
+     * 关闭未支付的交易订单，释放订单占用的资源
+     *
+     * @param tradeNo       商户订单号，需要关闭的商户订单号
+     * @param alipayTradeNo 支付宝交易号，需要关闭的支付宝交易号
+     * @return 交易关闭结果VO，包含关闭操作结果信息
+     * @throws BusinessException 当关闭操作失败时抛出
+     */
+    TradeCloseResponseVO tradeClose(String tradeNo, String alipayTradeNo);
+
+    /**
+     * 转账到支付宝账户
+     * 向指定的支付宝账户进行单笔转账操作
+     *
+     * @param transferParamDTO 转账参数DTO，包含转账金额、收款方信息等
+     * @return 转账结果VO，包含转账状态、支付宝单据号等
+     * @throws BusinessException 当转账参数无效或转账失败时抛出
+     */
+    TransferResponseVO alipayTransfer(TransferParamDTO transferParamDTO);
+
+    /**
+     * 转账查询
+     * 查询转账订单的处理状态和详细信息
+     *
+     * @param outBizNo 商户转账唯一订单号，商户系统内部的转账订单号
+     * @param orderId  支付宝转账单据号，支付宝系统生成的转账流水号
+     * @return 转账查询结果VO，包含转账状态、金额、时间等
+     * @throws BusinessException 当查询失败时抛出
+     */
+    TransferQueryResponseVO transferQuery(String outBizNo, String orderId);
+
+    /**
+     * 账单下载
+     * 获取指定日期的交易账单下载地址，用于财务对账
+     *
+     * @param billDate 账单日期，格式：yyyy-MM-dd
+     * @param billType 账单类型，如：trade、signcustomer等
+     * @return 账单文件下载地址URL
+     * @throws BusinessException 当账单下载链接获取失败时抛出
+     */
+    String billDownload(String billDate, String billType);
+
+    /**
+     * 验证签名
+     * 验证支付宝回调或响应的数字签名，确保数据来源的合法性和完整性
+     *
+     * @param params 待验证的参数Map，包含所有需要验证签名的参数
+     * @return true表示签名验证通过，false表示验证失败
+     */
+    boolean verifySignature(Map<String, String> params);
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/service/impl/AlipayServiceImpl.java

@@ -0,0 +1,866 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.service.impl;
+
+import com.alibaba.fastjson2.JSON;
+import com.alipay.api.*;
+import com.alipay.api.internal.util.AlipaySignature;
+import com.alipay.api.request.*;
+import com.alipay.api.response.*;
+import com.xiaomayi.alipay.config.AlipayConfig;
+import com.xiaomayi.alipay.dto.*;
+import com.xiaomayi.alipay.service.AlipayService;
+import com.xiaomayi.alipay.utils.ParamsUtils;
+import com.xiaomayi.alipay.vo.*;
+import com.xiaomayi.core.exception.BizException;
+import jakarta.servlet.http.HttpServletRequest;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.util.StringUtils;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * <p>
+ * 支付宝支付服务实现类
+ * 实现所有支付宝支付相关功能，包括支付、退款、查询、转账等完整业务流程
+ * 采用阿里巴巴支付宝开放平台SDK进行接口调用
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Slf4j
+@Service
+public class AlipayServiceImpl implements AlipayService {
+
+    /**
+     * PC网站统一下单支付
+     * 生成支付宝支付页面表单，用户可扫码或登录支付宝完成支付
+     * 适用于电商网站、服务平台等PC端支付场景
+     *
+     * @param preOrderParamsDTO 下单参数DTO
+     * @return 支付表单HTML代码
+     * @throws BizException 当参数验证失败或支付宝接口调用异常时抛出
+     */
+    @Override
+    public String pcPreOrder(PreOrderParamsDTO preOrderParamsDTO) {
+        // 记录请求日志，便于问题排查和审计
+        log.info("【支付宝PC支付】下单开始，商户订单号：{}，订单金额：{}元",
+                preOrderParamsDTO.getOut_trade_no(), preOrderParamsDTO.getTotal_amount());
+
+        // 参数验证，确保必要参数不为空且符合业务规则
+        validatePreOrderParams(preOrderParamsDTO);
+
+        try {
+            // 创建PC网站支付请求对象
+            AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
+
+            // 设置同步回调地址，支付完成后跳转的页面
+            request.setReturnUrl(AlipayConfig.returnUrl);
+            // 设置异步通知地址，接收支付结果通知
+            request.setNotifyUrl(AlipayConfig.notifyUrl);
+
+            // 设置网站支付产品码，固定值：FAST_INSTANT_TRADE_PAY
+            preOrderParamsDTO.setProduct_code("FAST_INSTANT_TRADE_PAY");
+            // 将业务参数转换为JSON字符串并设置到请求中
+            request.setBizContent(JSON.toJSONString(preOrderParamsDTO));
+
+            // 调用支付宝SDK执行页面支付请求，获取响应
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradePagePayResponse response = alipayClient.pageExecute(request);
+
+            // 检查响应是否成功
+            if (response.isSuccess()) {
+                log.info("【支付宝PC支付】下单成功，商户订单号：{}，支付宝交易号：{}",
+                        preOrderParamsDTO.getOut_trade_no(), response.getTradeNo());
+                // 返回支付表单HTML，前端可直接渲染
+                return response.getBody();
+            } else {
+                // 处理支付宝返回的业务错误
+                log.error("【支付宝PC支付】下单失败，商户订单号：{}，错误码：{}，错误信息：{}",
+                        preOrderParamsDTO.getOut_trade_no(),
+                        response.getSubCode(),
+                        response.getSubMsg());
+                throw new BizException("支付宝支付下单失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            // 处理支付宝API调用异常
+            log.error("【支付宝PC支付】下单异常，商户订单号：{}，异常信息：{}",
+                    preOrderParamsDTO.getOut_trade_no(), e.getMessage(), e);
+            throw new BizException("支付宝支付系统异常，请稍后重试");
+        }
+    }
+
+    /**
+     * 支付宝异步回调通知处理
+     * 接收支付宝服务器POST方式发送的支付结果通知
+     * 必须进行签名验证以确保通知的合法性
+     *
+     * @param request HTTP请求对象
+     * @return 通知处理结果
+     */
+    @Override
+    public NotifyParamsVO alipayNotify(HttpServletRequest request) {
+        // 将HTTP请求参数转换为Map格式，便于处理
+        Map<String, String> params = ParamsUtils.ParamstoMap(request);
+        log.info("【支付宝回调】接收到HTTP请求回调，参数数量：{}", params.size());
+
+        // 调用内部处理方法处理回调参数
+        return processAlipayNotify(params);
+    }
+
+    /**
+     * 支付宝异步回调通知处理（Map参数版本）
+     * 适用于参数已从其他来源解析为Map格式的场景
+     *
+     * @param params 已解析的回调参数
+     * @return 通知处理结果
+     */
+    @Override
+    public NotifyParamsVO alipayNotify(Map<String, String> params) {
+        log.info("【支付宝回调】接收到Map参数回调，参数数量：{}", params.size());
+        return processAlipayNotify(params);
+    }
+
+    /**
+     * 处理支付宝回调通知的核心方法
+     * 包含签名验证、参数解析、业务处理等完整流程
+     *
+     * @param params 回调参数Map
+     * @return 处理结果VO
+     */
+    private NotifyParamsVO processAlipayNotify(Map<String, String> params) {
+        log.info("【支付宝回调】开始处理回调通知，商户订单号：{}", params.get("out_trade_no"));
+
+        // 初始化返回结果，默认设置为未接收成功
+        NotifyParamsVO result = new NotifyParamsVO();
+        result.setIsreceive(false);
+
+        try {
+            // 第一步：验证签名，确保请求来自支付宝且数据未被篡改
+            boolean signVerified = verifySignature(params);
+
+            if (signVerified) {
+                log.info("【支付宝回调】签名验证成功，商户订单号：{}", params.get("out_trade_no"));
+
+                // 获取交易状态，这是最重要的业务参数
+                String tradeStatus = params.get("trade_status");
+
+                // 设置回调处理结果
+                result.setIsreceive(true);
+                result.setTran_starus(tradeStatus);
+                result.setOut_trade_no(params.get("out_trade_no"));
+                result.setTrade_no(params.get("trade_no"));
+                result.setTotal_amount(params.get("total_amount"));
+                result.setBuyer_id(params.get("buyer_id"));
+                result.setSeller_id(params.get("seller_id"));
+
+                // 根据交易状态进行相应的业务处理
+                handleTradeStatus(tradeStatus, params);
+
+                log.info("【支付宝回调】处理完成，订单号：{}，交易状态：{}",
+                        params.get("out_trade_no"), tradeStatus);
+            } else {
+                log.warn("【支付宝回调】签名验证失败，可能存在安全风险，商户订单号：{}",
+                        params.get("out_trade_no"));
+            }
+        } catch (Exception e) {
+            // 捕获所有异常，避免回调处理失败导致支付宝重复通知
+            log.error("【支付宝回调】处理过程中发生异常，商户订单号：{}，异常信息：{}",
+                    params.get("out_trade_no"), e.getMessage(), e);
+        }
+
+        return result;
+    }
+
+    /**
+     * 根据交易状态处理相应的业务逻辑
+     * 这是支付回调的核心业务处理部分
+     *
+     * @param tradeStatus 交易状态
+     * @param params      回调参数
+     */
+    private void handleTradeStatus(String tradeStatus, Map<String, String> params) {
+        String outTradeNo = params.get("out_trade_no");
+        String tradeNo = params.get("trade_no");
+        String totalAmount = params.get("total_amount");
+
+        // 根据支付宝定义的不同交易状态进行分支处理
+        switch (tradeStatus) {
+            case "TRADE_SUCCESS":
+                // 交易支付成功：指用户付款成功，资金已到账
+                log.info("【支付宝回调】订单支付成功，订单号：{}，支付宝交易号：{}，金额：{}元",
+                        outTradeNo, tradeNo, totalAmount);
+                // TODO: 实现支付成功业务逻辑，如更新订单状态、发放商品、记录日志等
+                // updateOrderStatus(outTradeNo, OrderStatus.PAID);
+                // grantProductToUser(outTradeNo);
+                break;
+
+            case "TRADE_FINISHED":
+                // 交易完结：指交易已经结束，不可再进行退款操作
+                log.info("【支付宝回调】订单交易完结，订单号：{}，支付宝交易号：{}", outTradeNo, tradeNo);
+                // TODO: 实现交易完结业务逻辑，如更新订单为已完成状态
+                // updateOrderStatus(outTradeNo, OrderStatus.FINISHED);
+                break;
+
+            case "TRADE_CLOSED":
+                // 交易关闭：指交易在未付款情况下超时关闭，或在付款完成后全额退款
+                log.info("【支付宝回调】订单交易关闭，订单号：{}，支付宝交易号：{}", outTradeNo, tradeNo);
+                // TODO: 实现交易关闭业务逻辑，如释放库存、更新订单状态等
+                // updateOrderStatus(outTradeNo, OrderStatus.CLOSED);
+                // releaseInventory(outTradeNo);
+                break;
+
+            case "WAIT_BUYER_PAY":
+                // 等待用户付款：指用户创建了交易但未付款
+                log.info("【支付宝回调】等待用户付款，订单号：{}", outTradeNo);
+                // TODO: 可在此处处理等待付款的逻辑，如发送提醒等
+                break;
+
+            default:
+                // 未知状态，记录警告日志以便排查问题
+                log.warn("【支付宝回调】未知交易状态：{}，订单号：{}，请检查支付宝接口文档",
+                        tradeStatus, outTradeNo);
+        }
+    }
+
+    /**
+     * 退款申请
+     * 对已支付的订单发起退款请求，支持部分退款和全额退款
+     * 退款金额不能超过订单原支付金额
+     *
+     * @param refundRequestParamDTO 退款请求参数
+     * @return 退款响应结果
+     * @throws BizException 当退款参数无效或支付宝退款接口调用失败时抛出
+     */
+    @Override
+    public RefundResponseVO pcRefund(RefundRequestParamDTO refundRequestParamDTO) {
+        log.info("【支付宝退款】申请开始，商户订单号：{}，退款金额：{}元",
+                refundRequestParamDTO.getOut_trade_no(), refundRequestParamDTO.getRefund_amount());
+
+        // 验证退款参数的有效性
+        validateRefundParams(refundRequestParamDTO);
+
+        try {
+            // 创建退款请求对象
+            AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
+            // 设置退款业务参数
+            request.setBizContent(JSON.toJSONString(refundRequestParamDTO));
+
+            // 调用支付宝退款接口
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradeRefundResponse response = alipayClient.execute(request);
+
+            // 检查退款请求是否成功
+            if (response.isSuccess()) {
+                log.info("【支付宝退款】申请成功，商户订单号：{}，支付宝退款单号：{}",
+                        refundRequestParamDTO.getOut_trade_no(), response.getTradeNo());
+
+                // 解析退款响应数据
+                RefundResponseSignVO refundResponseSign = JSON.parseObject(response.getBody(), RefundResponseSignVO.class);
+                return refundResponseSign.getAlipay_trade_refund_response();
+            } else {
+                log.error("【支付宝退款】申请失败，商户订单号：{}，错误码：{}，错误信息：{}",
+                        refundRequestParamDTO.getOut_trade_no(),
+                        response.getSubCode(),
+                        response.getSubMsg());
+                throw new BizException("退款申请失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝退款】申请异常，商户订单号：{}，异常信息：{}",
+                    refundRequestParamDTO.getOut_trade_no(), e.getMessage(), e);
+            throw new BizException("退款系统异常，请稍后重试");
+        }
+    }
+
+    /**
+     * 退款查询
+     * 查询指定退款请求的处理状态和详细信息
+     * 可用于轮询退款进度或对账
+     *
+     * @param refundQueryParamDTO 退款查询参数
+     * @return 退款查询结果
+     */
+    @Override
+    public RefundQueryResponseVO refundQuery(RefundQueryParamDTO refundQueryParamDTO) {
+        log.info("【支付宝退款查询】开始，查询参数：{}", JSON.toJSONString(refundQueryParamDTO));
+
+        try {
+            AlipayTradeFastpayRefundQueryRequest request = new AlipayTradeFastpayRefundQueryRequest();
+            request.setBizContent(JSON.toJSONString(refundQueryParamDTO));
+
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradeFastpayRefundQueryResponse response = alipayClient.execute(request);
+
+            // 解析响应数据
+            RefundQueryResponseSignVO refundQueryResponseSign = JSON.parseObject(
+                    response.getBody(), RefundQueryResponseSignVO.class);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝退款查询】成功，退款状态：{}",
+                        refundQueryResponseSign.getAlipay_trade_fastpay_refund_query_response().getRefund_status());
+                return refundQueryResponseSign.getAlipay_trade_fastpay_refund_query_response();
+            } else {
+                log.warn("【支付宝退款查询】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                // 对于查询接口，即使失败也返回包含错误信息的响应，便于调用方处理
+                RefundQueryResponseVO errorResponse = new RefundQueryResponseVO();
+                errorResponse.setCode(response.getSubCode());
+                errorResponse.setMsg(response.getSubMsg());
+                return errorResponse;
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝退款查询】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("退款查询系统异常");
+        }
+    }
+
+    /**
+     * 生成支付二维码（当面付）
+     * 生成用于线下扫码支付的二维码，适用于门店、自助机等场景
+     * 用户使用支付宝App扫描二维码完成支付
+     *
+     * @param tradePrecreateParamDTO 二维码支付参数
+     * @return 二维码支付响应
+     * @throws BizException 当二维码生成失败时抛出
+     */
+    @Override
+    public TradePrecreateResponseVO tradePrecreatePay(TradePrecreateParamDTO tradePrecreateParamDTO) {
+        log.info("【支付宝二维码支付】生成开始，商户订单号：{}，订单金额：{}元",
+                tradePrecreateParamDTO.getOut_trade_no(), tradePrecreateParamDTO.getTotal_amount());
+
+        validateTradePrecreateParams(tradePrecreateParamDTO);
+
+        try {
+            AlipayTradePrecreateRequest request = new AlipayTradePrecreateRequest();
+            request.setBizContent(JSON.toJSONString(tradePrecreateParamDTO));
+            // 设置异步通知地址，接收支付结果
+            request.setNotifyUrl(AlipayConfig.notifyUrl);
+
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradePrecreateResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝二维码支付】生成成功，商户订单号：{}，二维码内容：{}",
+                        tradePrecreateParamDTO.getOut_trade_no(), response.getQrCode());
+                QRCodeResponseVO qrResponse = JSON.parseObject(response.getBody(), QRCodeResponseVO.class);
+                return qrResponse.getAlipay_trade_precreate_response();
+            } else {
+                log.error("【支付宝二维码支付】生成失败，商户订单号：{}，错误码：{}，错误信息：{}",
+                        tradePrecreateParamDTO.getOut_trade_no(),
+                        response.getSubCode(),
+                        response.getSubMsg());
+                throw new BizException("二维码生成失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝二维码支付】生成异常，商户订单号：{}，异常信息：{}",
+                    tradePrecreateParamDTO.getOut_trade_no(), e.getMessage(), e);
+            throw new BizException("二维码生成系统异常");
+        }
+    }
+
+    /**
+     * 交易查询
+     * 根据商户订单号或支付宝交易号查询订单的详细信息和状态
+     * 用于确认支付状态、获取交易详情等场景
+     *
+     * @param tradeNo       商户订单号
+     * @param alipayTradeNo 支付宝交易号
+     * @return 交易查询结果
+     * @throws BizException 当查询参数无效或查询失败时抛出
+     */
+    @Override
+    public TradeQueryResponseVO tradeQuery(String tradeNo, String alipayTradeNo) {
+        log.info("【支付宝交易查询】开始，商户订单号：{}，支付宝交易号：{}", tradeNo, alipayTradeNo);
+
+        // 至少需要提供一个订单号
+        if (!StringUtils.hasText(tradeNo) && !StringUtils.hasText(alipayTradeNo)) {
+            throw new BizException("商户订单号和支付宝交易号不能同时为空");
+        }
+
+        try {
+            AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
+
+            // 构建查询参数
+            Map<String, String> bizContent = new HashMap<>();
+            if (StringUtils.hasText(tradeNo)) {
+                bizContent.put("out_trade_no", tradeNo);
+            }
+            if (StringUtils.hasText(alipayTradeNo)) {
+                bizContent.put("trade_no", alipayTradeNo);
+            }
+
+            request.setBizContent(JSON.toJSONString(bizContent));
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradeQueryResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝交易查询】成功，交易状态：{}", response.getTradeStatus());
+                return parseTradeQueryResponse(response);
+            } else {
+                log.warn("【支付宝交易查询】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                throw new BizException("交易查询失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝交易查询】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("交易查询系统异常");
+        }
+    }
+
+    /**
+     * 交易关闭
+     * 关闭未支付的交易订单，释放订单占用的资源
+     * 适用于用户放弃支付或订单超时场景
+     *
+     * @param tradeNo       商户订单号
+     * @param alipayTradeNo 支付宝交易号
+     * @return 交易关闭结果
+     * @throws BizException 当关闭操作失败时抛出
+     */
+    @Override
+    public TradeCloseResponseVO tradeClose(String tradeNo, String alipayTradeNo) {
+        log.info("【支付宝交易关闭】开始，商户订单号：{}，支付宝交易号：{}", tradeNo, alipayTradeNo);
+
+        if (!StringUtils.hasText(tradeNo) && !StringUtils.hasText(alipayTradeNo)) {
+            throw new BizException("商户订单号和支付宝交易号不能同时为空");
+        }
+
+        try {
+            AlipayTradeCloseRequest request = new AlipayTradeCloseRequest();
+
+            Map<String, String> bizContent = new HashMap<>();
+            if (StringUtils.hasText(tradeNo)) {
+                bizContent.put("out_trade_no", tradeNo);
+            }
+            if (StringUtils.hasText(alipayTradeNo)) {
+                bizContent.put("trade_no", alipayTradeNo);
+            }
+
+            request.setBizContent(JSON.toJSONString(bizContent));
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayTradeCloseResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝交易关闭】成功");
+                return parseTradeCloseResponse(response);
+            } else {
+                log.error("【支付宝交易关闭】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                throw new BizException("交易关闭失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝交易关闭】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("交易关闭系统异常");
+        }
+    }
+
+    /**
+     * 转账到支付宝账户
+     * 向指定的支付宝账户进行单笔转账操作
+     * 适用于佣金发放、退款到支付宝等场景
+     *
+     * @param transferParamDTO 转账参数
+     * @return 转账结果
+     * @throws BizException 当转账参数无效或转账失败时抛出
+     */
+    @Override
+    public TransferResponseVO alipayTransfer(TransferParamDTO transferParamDTO) {
+        log.info("【支付宝转账】开始，商户转账单号：{}，转账金额：{}元，收款账户：{}",
+                transferParamDTO.getOut_biz_no(),
+                transferParamDTO.getTrans_amount(),
+                transferParamDTO.getPayee_account());
+
+        validateTransferParams(transferParamDTO);
+
+        try {
+            AlipayFundTransUniTransferRequest request = new AlipayFundTransUniTransferRequest();
+
+            Map<String, Object> bizContent = new HashMap<>();
+            bizContent.put("out_biz_no", transferParamDTO.getOut_biz_no());
+            bizContent.put("trans_amount", transferParamDTO.getTrans_amount());
+            // 设置产品码，表示单笔无密转账到支付宝账户
+            bizContent.put("product_code", "TRANS_ACCOUNT_NO_PWD");
+            bizContent.put("biz_scene", "DIRECT_TRANSFER");
+
+            // 构建收款方信息
+            Map<String, String> payeeInfo = new HashMap<>();
+            payeeInfo.put("identity", transferParamDTO.getPayee_account());
+            payeeInfo.put("identity_type", "ALIPAY_LOGON_ID");
+            payeeInfo.put("name", transferParamDTO.getPayee_real_name());
+            bizContent.put("payee_info", payeeInfo);
+
+            bizContent.put("remark", transferParamDTO.getRemark());
+
+            request.setBizContent(JSON.toJSONString(bizContent));
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayFundTransUniTransferResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝转账】成功，支付宝转账单据号：{}", response.getOrderId());
+                return parseTransferResponse(response);
+            } else {
+                log.error("【支付宝转账】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                throw new BizException("转账失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝转账】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("转账系统异常");
+        }
+    }
+
+    /**
+     * 转账查询
+     * 查询转账订单的处理状态和详细信息
+     * 用于确认转账是否成功、获取转账详情等
+     *
+     * @param outBizNo 商户转账唯一订单号
+     * @param orderId  支付宝转账单据号
+     * @return 转账查询结果
+     * @throws BizException 当查询失败时抛出
+     */
+    @Override
+    public TransferQueryResponseVO transferQuery(String outBizNo, String orderId) {
+        log.info("【支付宝转账查询】开始，商户转账单号：{}，支付宝单据号：{}", outBizNo, orderId);
+
+        try {
+            AlipayFundTransCommonQueryRequest request = new AlipayFundTransCommonQueryRequest();
+
+            Map<String, String> bizContent = new HashMap<>();
+            if (StringUtils.hasText(outBizNo)) {
+                bizContent.put("out_biz_no", outBizNo);
+            }
+            if (StringUtils.hasText(orderId)) {
+                bizContent.put("order_id", orderId);
+            }
+            bizContent.put("product_code", "TRANS_ACCOUNT_NO_PWD");
+
+            request.setBizContent(JSON.toJSONString(bizContent));
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayFundTransCommonQueryResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝转账查询】成功，转账状态：{}", response.getStatus());
+                return parseTransferQueryResponse(response);
+            } else {
+                log.warn("【支付宝转账查询】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                throw new BizException("转账查询失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝转账查询】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("转账查询系统异常");
+        }
+    }
+
+    /**
+     * 账单下载
+     * 获取指定日期的交易账单下载地址，用于财务对账
+     * 支持不同类型的账单，如交易账单、余额账单等
+     *
+     * @param billDate 账单日期
+     * @param billType 账单类型
+     * @return 账单文件下载地址
+     * @throws BizException 当账单下载链接获取失败时抛出
+     */
+    @Override
+    public String billDownload(String billDate, String billType) {
+        log.info("【支付宝账单下载】开始，账单日期：{}，账单类型：{}", billDate, billType);
+
+        try {
+            AlipayDataDataserviceBillDownloadurlQueryRequest request =
+                    new AlipayDataDataserviceBillDownloadurlQueryRequest();
+
+            Map<String, String> bizContent = new HashMap<>();
+            bizContent.put("bill_date", billDate);
+            bizContent.put("bill_type", billType);
+
+            request.setBizContent(JSON.toJSONString(bizContent));
+            AlipayClient alipayClient = AlipayConfig.getAlipayClient();
+            AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);
+
+            if (response.isSuccess()) {
+                log.info("【支付宝账单下载】成功，下载地址已获取");
+                return response.getBillDownloadUrl();
+            } else {
+                log.error("【支付宝账单下载】失败，错误码：{}，错误信息：{}",
+                        response.getSubCode(), response.getSubMsg());
+                throw new BizException("账单下载失败：" + response.getSubMsg());
+            }
+        } catch (AlipayApiException e) {
+            log.error("【支付宝账单下载】异常，异常信息：{}", e.getMessage(), e);
+            throw new BizException("账单下载系统异常");
+        }
+    }
+
+    /**
+     * 验证签名
+     * 使用支付宝公钥验证请求参数的签名
+     * 确保数据来源的合法性和数据完整性
+     *
+     * @param params 待验证的参数
+     * @return 验证结果
+     */
+    @Override
+    public boolean verifySignature(Map<String, String> params) {
+        try {
+            boolean isValid = AlipaySignature.rsaCheckV1(params,
+                    AlipayConfig.alipayPublicKey,
+                    AlipayConfig.getCharset(),
+                    AlipayConfig.signType);
+
+            log.debug("【签名验证】结果：{}", isValid ? "通过" : "失败");
+            return isValid;
+
+        } catch (AlipayApiException e) {
+            log.error("【签名验证】异常，异常信息：{}", e.getMessage(), e);
+            return false;
+        }
+    }
+
+    // ============================== 参数验证方法 ==============================
+
+    /**
+     * 验证下单参数的有效性
+     * 确保必要参数不为空且符合业务规则
+     *
+     * @param params 下单参数
+     * @throws BizException 当参数验证失败时抛出
+     */
+    private void validatePreOrderParams(PreOrderParamsDTO params) {
+        if (params == null) {
+            throw new BizException("下单参数不能为空");
+        }
+        if (!StringUtils.hasText(params.getOut_trade_no())) {
+            throw new BizException("商户订单号不能为空");
+        }
+        if (params.getTotal_amount() == null || params.getTotal_amount().compareTo(java.math.BigDecimal.ZERO) <= 0) {
+            throw new BizException("订单金额必须大于0");
+        }
+        if (!StringUtils.hasText(params.getSubject())) {
+            throw new BizException("订单标题不能为空");
+        }
+        // 订单号长度限制检查
+        if (params.getOut_trade_no().length() > 64) {
+            throw new BizException("商户订单号长度不能超过64个字符");
+        }
+    }
+
+    /**
+     * 验证退款参数的有效性
+     * 确保退款请求参数合法
+     *
+     * @param params 退款参数
+     * @throws BizException 当参数验证失败时抛出
+     */
+    private void validateRefundParams(RefundRequestParamDTO params) {
+        if (params == null) {
+            throw new BizException("退款参数不能为空");
+        }
+        if (!StringUtils.hasText(params.getOut_trade_no()) && !StringUtils.hasText(params.getTrade_no())) {
+            throw new BizException("商户订单号和支付宝交易号不能同时为空");
+        }
+        if (params.getRefund_amount() == null || params.getRefund_amount().compareTo(java.math.BigDecimal.ZERO) <= 0) {
+            throw new BizException("退款金额必须大于0");
+        }
+        if (!StringUtils.hasText(params.getRefund_reason()) || params.getRefund_reason().length() > 256) {
+            throw new BizException("退款原因不能为空且长度不能超过256个字符");
+        }
+    }
+
+    /**
+     * 验证二维码支付参数的有效性
+     *
+     * @param params 二维码支付参数
+     * @throws BizException 当参数验证失败时抛出
+     */
+    private void validateTradePrecreateParams(TradePrecreateParamDTO params) {
+        if (params == null) {
+            throw new BizException("二维码支付参数不能为空");
+        }
+        if (!StringUtils.hasText(params.getOut_trade_no())) {
+            throw new BizException("商户订单号不能为空");
+        }
+        if (params.getTotal_amount() == null || params.getTotal_amount().compareTo(java.math.BigDecimal.ZERO) <= 0) {
+            throw new BizException("订单金额必须大于0");
+        }
+        if (!StringUtils.hasText(params.getSubject())) {
+            throw new BizException("订单标题不能为空");
+        }
+    }
+
+    /**
+     * 验证转账参数的有效性
+     *
+     * @param params 转账参数
+     * @throws BizException 当参数验证失败时抛出
+     */
+    private void validateTransferParams(TransferParamDTO params) {
+        if (params == null) {
+            throw new BizException("转账参数不能为空");
+        }
+        if (!StringUtils.hasText(params.getOut_biz_no())) {
+            throw new BizException("商户转账订单号不能为空");
+        }
+        if (params.getTrans_amount() == null || params.getTrans_amount().compareTo(java.math.BigDecimal.ZERO) <= 0) {
+            throw new BizException("转账金额必须大于0");
+        }
+        if (!StringUtils.hasText(params.getPayee_account())) {
+            throw new BizException("收款方账户不能为空");
+        }
+        if (!StringUtils.hasText(params.getPayee_real_name())) {
+            throw new BizException("收款方真实姓名不能为空");
+        }
+        // 支付宝账号格式简单验证
+        if (!params.getPayee_account().contains("@")) {
+            log.warn("收款方账户可能不是标准支付宝账号格式：{}", params.getPayee_account());
+        }
+    }
+
+    // ============================== 响应解析方法 ==============================
+
+    /**
+     * 解析交易查询响应
+     * 将支付宝SDK响应对象转换为业务VO对象
+     *
+     * @param response 支付宝交易查询响应
+     * @return 业务VO对象
+     */
+    private TradeQueryResponseVO parseTradeQueryResponse(AlipayTradeQueryResponse response) {
+        TradeQueryResponseVO result = new TradeQueryResponseVO();
+        result.setTrade_no(response.getTradeNo());
+        result.setOut_trade_no(response.getOutTradeNo());
+        result.setTrade_status(response.getTradeStatus());
+        result.setTotal_amount(response.getTotalAmount());
+        result.setBuyer_logon_id(response.getBuyerLogonId());
+        result.setBuyer_user_id(response.getBuyerUserId());
+//        result.setSeller_id(response.getSellerId());
+        result.setSend_pay_date(response.getSendPayDate());
+        result.setCode("10000"); // 成功状态码
+        result.setMsg("Success");
+        return result;
+    }
+
+    /**
+     * 解析交易关闭响应
+     *
+     * @param response 支付宝交易关闭响应
+     * @return 业务VO对象
+     */
+    private TradeCloseResponseVO parseTradeCloseResponse(AlipayTradeCloseResponse response) {
+        TradeCloseResponseVO result = new TradeCloseResponseVO();
+        result.setTrade_no(response.getTradeNo());
+        result.setOut_trade_no(response.getOutTradeNo());
+//        result.setAction(response.getAction());
+        result.setCode("10000");
+        result.setMsg("Success");
+        return result;
+    }
+
+    /**
+     * 解析转账响应
+     *
+     * @param response 支付宝转账响应
+     * @return 业务VO对象
+     */
+    private TransferResponseVO parseTransferResponse(AlipayFundTransUniTransferResponse response) {
+        TransferResponseVO result = new TransferResponseVO();
+        result.setOrder_id(response.getOrderId());
+        result.setOut_biz_no(response.getOutBizNo());
+        result.setStatus(response.getStatus());
+        result.setTrans_date(response.getTransDate());
+        result.setCode("10000");
+        result.setMsg("Success");
+        return result;
+    }
+
+    /**
+     * 解析转账查询响应
+     *
+     * @param response 支付宝转账查询响应
+     * @return 业务VO对象
+     */
+    private TransferQueryResponseVO parseTransferQueryResponse(AlipayFundTransCommonQueryResponse response) {
+        TransferQueryResponseVO result = new TransferQueryResponseVO();
+        result.setOrder_id(response.getOrderId());
+        result.setOut_biz_no(response.getOutBizNo());
+        result.setStatus(response.getStatus());
+        result.setTrans_amount(response.getTransAmount());
+        result.setPay_date(response.getPayDate());
+        result.setCode("10000");
+        result.setMsg("Success");
+        return result;
+    }
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/utils/ParamsUtils.java

@@ -0,0 +1,112 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.utils;
+
+import jakarta.servlet.http.HttpServletRequest;
+
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+
+/**
+ * <p>
+ * 参数处理工具类
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+public class ParamsUtils {
+
+    /**
+     * 将异步通知的参数转化为Map
+     *
+     * @return 返回结果
+     */
+    public static Map<String, String> ParamstoMap(HttpServletRequest request) {
+        Map<String, String> params = new HashMap<String, String>();
+        Map<String, String[]> requestParams = request.getParameterMap();
+        for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext(); ) {
+            String name = (String) iter.next();
+            String[] values = (String[]) requestParams.get(name);
+            String valueStr = "";
+            for (int i = 0; i < values.length; i++) {
+                valueStr = (i == values.length - 1) ? valueStr + values[i] : valueStr + values[i] + ",";
+            }
+            // 乱码解决，这段代码在出现乱码时使用。
+            // valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
+            params.put(name, valueStr);
+        }
+        return params;
+    }
+
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/NotifyParamsVO.java

@@ -0,0 +1,202 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 支付宝异步通知参数值对象
+ * 封装支付宝异步回调通知的业务参数
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class NotifyParamsVO {
+
+    /**
+     * 是否成功接收通知
+     * true-成功接收并验证通过，false-接收失败或验证失败
+     * 示例：true
+     */
+    private Boolean isreceive;
+
+    /**
+     * 交易状态
+     * WAIT_BUYER_PAY-交易创建，等待买家付款
+     * TRADE_CLOSED-未付款交易超时关闭，或支付完成后全额退款
+     * TRADE_SUCCESS-交易支付成功
+     * TRADE_FINISHED-交易结束，不可退款
+     * 示例：TRADE_SUCCESS
+     */
+    private String tran_starus;
+
+    /**
+     * 商户订单号
+     * 商户网站唯一订单号
+     * 示例：2024032300010001
+     */
+    private String out_trade_no;
+
+    /**
+     * 支付宝交易号
+     * 支付宝系统内部生成的交易流水号
+     * 示例：20240323220014000105000000000001
+     */
+    private String trade_no;
+
+    /**
+     * 订单金额
+     * 本次交易支付的订单金额，单位为元
+     * 示例：88.88
+     */
+    private String total_amount;
+
+    /**
+     * 实收金额
+     * 商家在交易中实际收到的款项，单位为元
+     * 示例：88.88
+     */
+    private String receipt_amount;
+
+    /**
+     * 买家支付宝用户ID
+     * 买家支付宝账号对应的支付宝唯一用户号
+     * 示例：2088102146225135
+     */
+    private String buyer_id;
+
+    /**
+     * 卖家支付宝用户ID
+     * 卖家支付宝用户号
+     * 示例：2088102146225136
+     */
+    private String seller_id;
+
+    /**
+     * 通知时间
+     * 通知的发送时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 15:30:45
+     */
+    private String notify_time;
+
+    /**
+     * 通知类型
+     * 通知的类型，trade_status_sync-交易状态同步
+     * 示例：trade_status_sync
+     */
+    private String notify_type;
+
+    /**
+     * 通知校验ID
+     * 通知校验ID，用于在查询通知详情时使用
+     * 示例：ac05099524730693a8b330c5ecf72da9786
+     */
+    private String notify_id;
+
+    /**
+     * 编码格式
+     * 编码格式，如utf-8、gbk、gb2312等
+     * 示例：utf-8
+     */
+    private String charset;
+
+    /**
+     * 接口版本
+     * 调用的接口版本，固定为1.0
+     * 示例：1.0
+     */
+    private String version;
+
+    /**
+     * 签名类型
+     * 商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA
+     * 示例：RSA2
+     */
+    private String sign_type;
+
+    /**
+     * 签名
+     * 商户对请求参数的签名，详见支付宝文档签名机制
+     * 示例：详见支付宝文档
+     */
+    private String sign;
+
+    /**
+     * 授权方的app_id
+     * 授权方的app_id，由于开放平台接口有可能会授权给第三方调用
+     * 示例：2014072300007148
+     */
+    private String auth_app_id;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/QRCodeResponseVO.java

@@ -0,0 +1,100 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 二维码支付响应签名值对象
+ * 封装支付宝二维码支付接口返回的完整响应数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class QRCodeResponseVO {
+
+    /**
+     * 二维码支付响应对象
+     * 包含二维码支付业务数据的核心响应对象
+     */
+    private TradePrecreateResponseVO alipay_trade_precreate_response;
+
+    /**
+     * 响应签名
+     * 支付宝对返回参数的签名
+     * 示例：ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE
+     */
+    private String sign;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/RefundQueryResponseSignVO.java

@@ -0,0 +1,100 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 退款查询响应签名值对象
+ * 封装支付宝退款查询接口返回的完整响应数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class RefundQueryResponseSignVO {
+
+    /**
+     * 退款查询响应对象
+     * 包含退款查询业务数据的核心响应对象
+     */
+    private RefundQueryResponseVO alipay_trade_fastpay_refund_query_response;
+
+    /**
+     * 响应签名
+     * 支付宝对返回参数的签名
+     * 示例：ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE
+     */
+    private String sign;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/RefundQueryResponseVO.java

@@ -0,0 +1,127 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 退款查询VO
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+@Data
+public class RefundQueryResponseVO {
+
+    /**
+     * 响应编码
+     */
+    private String code;
+
+    /**
+     * 响应描述
+     */
+    private String msg;
+
+    /**
+     * 本笔退款对应的退款请求号
+     */
+    private String out_request_no;
+
+    /**
+     * 创建交易传入的商户订单号
+     */
+    private String out_trade_no;
+
+    /**
+     * 本次退款金额
+     */
+    private String refund_amount;
+
+    /**
+     * 退款状态(成功：REFUND_SUCCESS)
+     */
+    private String refund_status;
+
+    /**
+     * 该笔退款所对应的交易的订单金额
+     */
+    private String total_amount;
+
+    /**
+     * 支付宝交易号
+     */
+    private String trade_no;
+
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/RefundResponseSignVO.java

@@ -0,0 +1,100 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 退款响应签名值对象
+ * 封装支付宝退款接口返回的完整响应数据（包含签名信息）
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class RefundResponseSignVO {
+
+    /**
+     * 退款响应对象
+     * 包含退款业务数据的核心响应对象
+     */
+    private RefundResponseVO alipay_trade_refund_response;
+
+    /**
+     * 响应签名
+     * 支付宝对返回参数的签名，用于验证响应数据的完整性
+     * 示例：ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE
+     */
+    private String sign;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/RefundResponseVO.java

@@ -0,0 +1,146 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import com.alipay.api.domain.TradeFundBill;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * <p>
+ * 退款请求返响应VO
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+@Data
+public class RefundResponseVO {
+
+    /**
+     * 响应编码
+     */
+    private String code;
+
+    /**
+     * 响应描述
+     */
+    private String msg;
+
+    /**
+     * 支付宝交易号
+     */
+    private String trade_no;
+
+    /**
+     * 商户订单号
+     */
+    private String out_trade_no;
+
+    /**
+     * 用户的登录ID
+     */
+    private String buyer_logon_id;
+
+    /**
+     * 本次退款是否发生了资金变化(示例值：Y)
+     */
+    private String fund_change;
+
+    /**
+     * 退款总金额
+     * 指该笔交易累计已经退款成功的金额
+     */
+    private String refund_fee;
+
+    /**
+     * 退款使用的资金渠道
+     * 只有在签约中指定需要返回资金明细，或者入参的query_options中指定时才返回该字段信息
+     */
+    private List<TradeFundBill> refund_detail_item_list;
+
+    /**
+     * 店铺名称
+     */
+    private String store_name;
+
+    /**
+     * 买家在支付宝的用户ID
+     */
+    private String buyer_user_id;
+
+    private String gmt_refund_pay;
+
+    private String send_back_fee;
+
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/TradeCloseResponseVO.java

@@ -0,0 +1,143 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 支付宝交易关闭响应值对象
+ * 封装关闭支付宝交易返回的业务数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TradeCloseResponseVO {
+
+    /**
+     * 支付宝交易号
+     * 支付宝系统内部生成的交易流水号
+     * 示例：20240323220014000105000000000001
+     */
+    private String trade_no;
+
+    /**
+     * 商户订单号
+     * 商户网站唯一订单号
+     * 示例：2024032300010001
+     */
+    private String out_trade_no;
+
+    /**
+     * 是否需要重试
+     * 关闭交易时返回的操作结果，标识是否需要调用方重试
+     * 示例：N
+     */
+    private String retry_flag;
+
+    /**
+     * 本次撤销触发的交易动作
+     * close-关闭交易，无退款，refund-产生了退款
+     * 示例：close
+     */
+    private String action;
+
+    /**
+     * 错误码
+     * 网关返回码
+     * 示例：10000
+     */
+    private String code;
+
+    /**
+     * 错误描述
+     * 网关返回码描述
+     * 示例：Success
+     */
+    private String msg;
+
+    /**
+     * 子错误码
+     * 业务返回码
+     * 示例：ACQ.TRADE_HAS_SUCCESS
+     */
+    private String sub_code;
+
+    /**
+     * 子错误描述
+     * 业务返回码描述
+     * 示例：交易已支付，无法关闭
+     */
+    private String sub_msg;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/TradePrecreateResponseVO.java

@@ -0,0 +1,107 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 二维码生成VO
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-07-21
+ */
+@Data
+public class TradePrecreateResponseVO {
+
+    /**
+     * 返回的状态码
+     */
+    private String code;
+
+    /**
+     * 返回的信息
+     */
+    private String msg;
+
+    /**
+     * 交易的流水号
+     */
+    private String out_trade_no;
+
+    /**
+     * 生成二维码的内容
+     */
+    private String qr_code;
+
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/TradeQueryResponseVO.java

@@ -0,0 +1,224 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+import java.util.Date;
+
+/**
+ * <p>
+ * 支付宝交易查询响应值对象
+ * 封装查询支付宝交易状态返回的业务数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TradeQueryResponseVO {
+
+    /**
+     * 支付宝交易号
+     * 支付宝系统内部生成的交易流水号
+     * 示例：20240323220014000105000000000001
+     */
+    private String trade_no;
+
+    /**
+     * 商户订单号
+     * 商户网站唯一订单号
+     * 示例：2024032300010001
+     */
+    private String out_trade_no;
+
+    /**
+     * 交易状态
+     * WAIT_BUYER_PAY-交易创建，等待买家付款
+     * TRADE_CLOSED-未付款交易超时关闭，或支付完成后全额退款
+     * TRADE_SUCCESS-交易支付成功
+     * TRADE_FINISHED-交易结束，不可退款
+     * 示例：TRADE_SUCCESS
+     */
+    private String trade_status;
+
+    /**
+     * 订单总金额
+     * 本次交易支付的订单金额，单位为元
+     * 示例：88.88
+     */
+    private String total_amount;
+
+    /**
+     * 实收金额
+     * 商家在交易中实际收到的款项，单位为元
+     * 示例：88.88
+     */
+    private String receipt_amount;
+
+    /**
+     * 买家实付金额
+     * 买家实际支付的金额，单位为元
+     * 示例：88.88
+     */
+    private String buyer_pay_amount;
+
+    /**
+     * 积分金额
+     * 使用积分支付的金额，单位为元
+     * 示例：0.00
+     */
+    private String point_amount;
+
+    /**
+     * 开票金额
+     * 交易中用户付款的开票金额
+     * 示例：88.88
+     */
+    private String invoice_amount;
+
+    /**
+     * 买家支付宝账号
+     * 买家支付宝登录账号，通常是邮箱或手机号
+     * 示例：138****8000
+     */
+    private String buyer_logon_id;
+
+    /**
+     * 买家支付宝用户ID
+     * 买家支付宝账号对应的支付宝唯一用户号
+     * 示例：2088102146225135
+     */
+    private String buyer_user_id;
+
+    /**
+     * 卖家支付宝用户ID
+     * 卖家支付宝用户号
+     * 示例：2088102146225136
+     */
+    private String seller_id;
+
+    /**
+     * 发送交易时间
+     * 发送交易时间，格式为yyyy-MM-dd HH:mm:ss
+     */
+    private Date send_pay_date;
+
+    /**
+     * 交易创建时间
+     * 交易创建的时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 14:30:00
+     */
+    private String gmt_create;
+
+    /**
+     * 付款时间
+     * 交易付款时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 14:35:00
+     */
+    private String gmt_payment;
+
+    /**
+     * 交易结束时间
+     * 交易结束时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 14:40:00
+     */
+    private String gmt_close;
+
+    /**
+     * 错误码
+     * 网关返回码
+     * 示例：10000
+     */
+    private String code;
+
+    /**
+     * 错误描述
+     * 网关返回码描述
+     * 示例：Success
+     */
+    private String msg;
+
+    /**
+     * 子错误码
+     * 业务返回码
+     * 示例：ACQ.TRADE_NOT_EXIST
+     */
+    private String sub_code;
+
+    /**
+     * 子错误描述
+     * 业务返回码描述
+     * 示例：交易不存在
+     */
+    private String sub_msg;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/TransferQueryResponseVO.java

@@ -0,0 +1,164 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 支付宝转账查询响应值对象
+ * 封装查询支付宝转账状态返回的业务数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TransferQueryResponseVO {
+
+    /**
+     * 支付宝转账单据号
+     * 支付宝系统内部生成的转账单据号
+     * 示例：20190627100020000100800000000001
+     */
+    private String order_id;
+
+    /**
+     * 商户转账唯一订单号
+     * 商户生成的转账请求号
+     * 示例：2024032300010001
+     */
+    private String out_biz_no;
+
+    /**
+     * 转账状态
+     * SUCCESS-成功，FAIL-失败，DEALING-处理中，REFUND-退票，CLOSED-关闭
+     * 示例：SUCCESS
+     */
+    private String status;
+
+    /**
+     * 转账金额
+     * 实际转账金额，单位元
+     * 示例：1000.00
+     */
+    private String trans_amount;
+
+    /**
+     * 支付时间
+     * 转账成功时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 15:30:45
+     */
+    private String pay_date;
+
+    /**
+     * 错误码
+     * 网关返回码，10000表示成功，其他为失败
+     * 示例：10000
+     */
+    private String code;
+
+    /**
+     * 错误描述
+     * 网关返回码描述
+     * 示例：Success
+     */
+    private String msg;
+
+    /**
+     * 子错误码
+     * 业务返回码
+     * 示例：ORDER_NOT_EXIST
+     */
+    private String sub_code;
+
+    /**
+     * 子错误描述
+     * 业务返回码描述
+     * 示例：转账订单不存在
+     */
+    private String sub_msg;
+
+    /**
+     * 失败原因
+     * 转账失败时的具体原因描述
+     * 示例：账户余额不足
+     */
+    private String fail_reason;
+
+    /**
+     * 业务场景
+     * 标识转账业务的场景
+     * 示例：DIRECT_TRANSFER
+     */
+    private String biz_scene;
+}

xiaomayi-common/xiaomayi-alipay/src/main/java/com/xiaomayi/alipay/vo/TransferResponseVO.java

@@ -0,0 +1,143 @@
+// +======================================================================
+// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
+// +----------------------------------------------------------------------
+// | 核心价值：赋能开发者 · 服务企业 · 共建生态
+// +----------------------------------------------------------------------
+// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
+// +----------------------------------------------------------------------
+// | 官方平台: https://www.xiaomayicloud.com
+// +======================================================================
+// | 【知识产权声明】
+// | 1. 权属声明：本软件是受《中华人民共和国著作权法》
+// |    保护的专有财产，完整版权归小蚂蚁云团队所有
+// | 2. 权利范围：所有知识产权（商标、专利、著作权、
+// |    商业秘密等）均归小蚂蚁云团队所有，受法律保护
+// | 3. 授权性质：用户仅可获得有限的、非独占的使用许可
+// | 4. 禁止行为：未经书面授权，禁止对本软件本身
+// |    申请任何知识产权
+// | 5. 权利保留：未在本协议中明示授予的一切权利
+// |    均由小蚂蚁云团队保留
+// +======================================================================
+// | 【授权状态说明】
+// | 1. 未授权状态：用户未购买有效的商业许可证
+// | 2. 商业授权：已购买正式商业许可证的用户
+// +======================================================================
+// | 【绝对禁止条款】
+// | 无论授权状态如何，任何用户均严格禁止以下行为：
+// | 1. 逆向工程：对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
+// | 2. 版权破坏：移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
+// | 3. 非法传播：复制、分发、出租、出借、转售、再许可本软件或其许可权利
+// | 4. 竞争性使用：利用本软件的代码、架构、设计开发直接竞争的产品或服务
+// | 5. 侵权使用：将软件用于侵犯第三方知识产权或其他合法权益的用途
+// +======================================================================
+// | 【商业授权许可范围】
+// | 购买有效商业许可证的用户，在遵守上述禁止条款的前提下，获得：
+// | 1. 使用权利：在许可证约定的项目数量、开发者数量范围内使用本软件
+// | 2. 技术支持：商业授权用户可以获取本地开发部署的技术支持服务
+// | 3. 版本更新：在许可证有效期内获取软件更新、安全补丁和功能增强
+// | 4. 商业部署：将基于本软件开发的应用程序用于商业运营和生产环境
+// +======================================================================
+// | 【许可证获取】
+// | 1. 获取途径：仅通过小蚂蚁云官方渠道购买（官网、授权代理商），购买记录凭证
+// | 2. 转让限制：许可证与购买主体绑定，未经书面同意不得转让
+// | 3. 终止情形：许可证到期、违反协议、破产清算等情况下自动终止
+// +======================================================================
+// | 【合法使用要求】
+// | 1. 仅限用于合法合规的软件研发
+// | 2. 严禁用于任何违法、侵权或恶意行为
+// | 3. 严禁违反我国法律法规和政策
+// +======================================================================
+// | 【免责声明】
+// | 因使用本框架导致的以下情况，我们概不负责：
+// | 1. 项目研发中的意外、疏忽、违约等风险
+// | 2. 侵犯第三方知识产权或其他合法权益
+// | 3. 任何直接、间接、附带或衍生一切损失
+// | 4. 用户违规违法行为的一切法律后果
+// +======================================================================
+// | 【协议重要提示】
+// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
+// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
+// | 3. 我们保留单方面修改本声明的权利，修改后的版本在官网公布即生效
+// | 4. 用户有义务定期查看最新版本，继续使用视为接受修改
+// +======================================================================
+// | 【侵权举报与合规】
+// | 1. 知识产权侵权举报：请联系官方客服
+// | 2. 许可证合规咨询：xiaomayicloud@163.com
+// | 3. 违规使用将终止授权并追究责任
+// | 4. 无条件配合司法机关调查取证
+// | 5. 保留一切法律追诉权利
+// | 6. 对有效举报和合规建议，我们将给予感谢和奖励
+// +======================================================================
+
+package com.xiaomayi.alipay.vo;
+
+import lombok.Data;
+
+/**
+ * <p>
+ * 支付宝转账响应值对象
+ * 封装支付宝转账接口返回的业务数据
+ * </p>
+ *
+ * @author 小蚂蚁云团队
+ * @since 2024-03-23
+ */
+@Data
+public class TransferResponseVO {
+
+    /**
+     * 支付宝转账单据号
+     * 支付宝系统内部生成的转账单据号，用于后续查询
+     * 示例：20190627100020000100800000000001
+     */
+    private String order_id;
+
+    /**
+     * 商户转账唯一订单号
+     * 商户生成的转账请求号，原样返回
+     * 示例：2024032300010001
+     */
+    private String out_biz_no;
+
+    /**
+     * 转账状态
+     * 转账状态：SUCCESS-成功，FAIL-失败，DEALING-处理中
+     * 示例：SUCCESS
+     */
+    private String status;
+
+    /**
+     * 订单支付时间
+     * 转账成功时间，格式为yyyy-MM-dd HH:mm:ss
+     * 示例：2024-03-23 15:30:45
+     */
+    private String trans_date;
+
+    /**
+     * 错误码
+     * 网关返回码，10000表示成功，其他为失败
+     * 示例：10000
+     */
+    private String code;
+
+    /**
+     * 错误描述
+     * 网关返回码描述，成功时为"Success"
+     * 示例：Success
+     */
+    private String msg;
+
+    /**
+     * 子错误码
+     * 业务返回码，具体业务错误码
+     * 示例：PAYEE_NOT_EXIST
+     */
+    private String sub_code;
+
+    /**
+     * 子错误描述
+     * 业务返回码描述
+     * 示例：收款方账户不存在
+     */
+    private String sub_msg;
+}

xiaomayi-common/xiaomayi-alipay/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -0,0 +1 @@
+com.xiaomayi.alipay.config.AlipayConfig