@pisell/pisellos 2.1.4 → 2.1.5

package/lib/modules/Payment/types.d.ts

@@ -1,47 +1,767 @@
-export declare enum PaymentHooks {
-    OnPaymentInit = "payment:onPaymentInit",
-    OnPaymentSuccess = "payment:onPaymentSuccess",
-    OnPaymentFailure = "payment:onPaymentFailure",
-    OnPaymentRefund = "payment:onPaymentRefund"
+/**
+ * 支付相关类型定义
+ */
+/**
+ * 支付方式枚举
+ */
+export declare enum PaymentMethodType {
+    Cash = "CASHMANUAL",
+    Eftpos = "EFTPOS",
+    Wallet = "WALLET"
 }
 /**
- * 支付方式
+ * 支付状态枚举
  */
-export type PaymentMethod = 'credit_card' | 'debit_card' | 'paypal' | 'alipay' | 'wechat_pay' | 'bank_transfer';
+export declare enum PaymentStatus {
+    /** 支付处理中 - 订单正在进行支付操作 */
+    Processing = "payment_processing",
+    /** 同步中 - 暂时不使用，为了向后兼容保留 */
+    Sync = "sync",
+    /** 部分支付 - 支付金额不足订单总金额 */
+    PartiallyPaid = "partially_paid",
+    /** 已完成 - 本地支付完成，后台自动同步到服务器 */
+    Finished = "finish"
+}
 /**
- * 支付状态
+ * 任务状态枚举
  */
-export type PaymentStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'refunded';
+export declare enum TaskRunStatus {
+    Pending = "pending",
+    Running = "running",
+    Success = "success",
+    Failed = "failed"
+}
+/**
+ * 舍入规则枚举
+ */
+export declare enum RoundingRule {
+    /** 标准舍入（中点向上） */
+    Standard = "standard_rounding",
+    /** 标准舍入（中点向下） */
+    StandardDown = "standard_down",
+    /** 总是向上舍入 */
+    AlwaysUp = "always_up",
+    /** 总是向下舍入 */
+    AlwaysDown = "always_down"
+}
+/**
+ * 舍入结果
+ */
+export interface RoundingResult {
+    /** 原始金额 */
+    originalAmount: string;
+    /** 舍入后的金额 */
+    roundedAmount: string;
+    /** 舍入差额（舍入后金额 - 原始金额） */
+    roundingDifference: string;
+}
+/**
+ * 舍入间隔枚举
+ */
+export declare enum RoundingInterval {
+    /** 0.05 间隔 */
+    Interval005 = 0.05,
+    /** 0.1 间隔 */
+    Interval01 = 0.1,
+    /** 0.5 间隔 */
+    Interval05 = 0.5,
+    /** 1 间隔 */
+    Interval1 = 1
+}
 /**
- * 支付信息
+ * 支付方式信息
  */
-export interface Payment {
+export interface PaymentMethod {
+    /** 支付方式ID */
+    id: number;
+    /** 支付方式代码 */
+    code: string;
+    /** 支付方式名称 */
+    name: string;
+    /** 支付方式类型 */
+    type: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 其他配置信息 */
+    [key: string]: any;
+}
+/**
+ * 支付项
+ */
+export interface PaymentItem {
+    /** 当前支付项的唯一 ID */
+    uuid: string;
+    /** 当前支付方式付出去多少钱 */
+    amount: string;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+    /** 拓展参数字段 */
+    metadata?: {
+        /** 钱箱 ID */
+        shop_wallet_pass_id?: string;
+        /** 唯一支付号 */
+        unique_payment_number?: string;
+        /** rouding规则 */
+        rounding_rule?: any;
+        /** 实付金额（现金支付时的实际给出金额） */
+        actual_paid_amount?: number;
+        /** 找零金额（现金支付时的找零金额） */
+        change_given_amount?: number;
+    };
+    /** rouding金额 */
+    rounding_amount?: string;
+    /** 三方支付手续费 */
+    service_charge?: {
+        percentage?: string;
+        amount?: string;
+    };
+    /** 支付项状态 */
+    status?: 'active' | 'voided';
+    /** 原始金额（用于记录撤销前的金额） */
+    origin_amount?: string;
+    /** 订单支付类型 */
+    order_payment_type?: 'normal' | 'deposit';
+}
+/**
+ * 订单信息
+ */
+export interface OrderInfo {
+    /** 订单 id */
+    order_id: number;
+    /** 订单总金额 */
+    total_amount: string;
+    /** 是否是定金订单 */
+    is_deposit: number;
+    /** 定金金额 */
+    deposit_amount: string;
+}
+/**
+ * 支付订单（简化版，仅保留支付相关信息）
+ */
+export interface PaymentOrder {
+    /** 当前订单的唯一 ID */
+    uuid: string;
+    /** 订单ID（字符串类型，支持本地虚拟ID） */
     id: string;
-    orderId: string;
-    amount: number;
-    currency: string;
-    method: PaymentMethod;
-    status: PaymentStatus;
-    transactionId?: string;
-    createdAt: Date;
-    updatedAt: Date;
-    metadata?: Record<string, any>;
+    /** 订单ID（数字类型，兼容旧版本） */
+    order_id: string;
+    /** 支付项列表 */
+    payment: PaymentItem[];
+    /** 修改的支付项列表 */
+    adjust_offline_payments: PaymentItem[];
+    /** 总计金额 */
+    total_amount: string;
+    /** 待付金额 */
+    expect_amount: string;
+    /** 支付状态 */
+    payment_status: PaymentStatus;
+    /** 是否是定金订单 */
+    is_deposit: number;
+    /** 定金金额 */
+    deposit_amount: string;
+    /** 总税费 */
+    tax_fee: string;
+    /** 原始订单数据（由 Checkout 模块传入） */
+    order_info?: any;
 }
 /**
- * 支付模块状态
+ * 支付状态
  */
 export interface PaymentState {
-    currentPayment: Payment | null;
-    paymentHistory: Payment[];
 }
 /**
- * 支付模块 API
+ * 推送订单参数（简化版）
+ */
+export interface PushOrderParams {
+    /** 订单ID */
+    order_id: string;
+    /** 总金额 */
+    total_amount: string;
+    /** 是否是定金订单 */
+    is_deposit?: number;
+    /** 定金金额 */
+    deposit_amount?: string;
+    /** 原始订单数据（可选，由 Checkout 模块传入） */
+    order_info?: any;
+}
+/**
+ * 更新订单参数
+ */
+export interface UpdateOrderParams {
+    /** 订单UUID */
+    uuid: string;
+    /** 更新的字段 */
+    [key: string]: any;
+}
+/**
+ * 支付项输入类型（允许 amount 为数字）
+ */
+export interface PaymentItemInput {
+    /** 当前支付方式付出去多少钱 */
+    amount: string | number;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+    /** 三方支付手续费 */
+    service_charge?: {
+        percentage?: string;
+        amount?: string;
+    };
+    /** 舍入金额 */
+    rounding_amount?: string;
+    /** 订单支付类型 */
+    order_payment_type?: 'normal' | 'deposit';
+    /** 扩展参数字段 */
+    metadata?: {
+        /** 钱箱 ID */
+        shop_wallet_pass_id?: string;
+        /** 唯一支付号 */
+        unique_payment_number?: string;
+        /** rounding规则 */
+        rounding_rule?: any;
+        /** 实付金额（现金支付时的实际给出金额） */
+        actual_paid_amount?: number;
+        /** 找零金额（现金支付时的找零金额） */
+        change_given_amount?: number;
+    };
+}
+/**
+ * 推送支付项参数
+ */
+export interface PushPaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项信息 */
+    paymentItem: PaymentItemInput;
+}
+/**
+ * 更新支付项参数中的字段类型（允许 amount 为数字）
+ */
+export interface PaymentUpdateFields {
+    /** 当前支付项的唯一 ID */
+    uuid?: string;
+    /** 当前支付方式付出去多少钱 */
+    amount?: string | number;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code?: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id?: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name?: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type?: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+    /** 该支付项是否已经同步给后端服务器（只有网络请求成功后才为true） */
+    isSynced?: boolean;
+    /** 同步错误信息（业务错误时记录错误信息，用于区分"未同步"和"同步失败"） */
+    syncError?: {
+        error: string;
+        errorCode?: string;
+        statusCode?: number;
+        timestamp: number;
+    };
+}
+/**
+ * 更新支付项参数
+ */
+export interface UpdatePaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项UUID */
+    paymentUuid: string;
+    /** 更新的字段 */
+    params: PaymentUpdateFields;
+}
+/**
+ * 删除支付项参数
+ */
+export interface DeletePaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项UUID */
+    paymentUuid: string;
+}
+/**
+ * 现金支付接口
+ */
+export interface CashPayment {
+    /** 处理现金支付 */
+    processCashPayment: (amount: number, orderUuid: string) => Promise<void>;
+    /** 获取现金余额 */
+    getCashBalance: () => Promise<number>;
+}
+/**
+ * Eftpos支付接口
+ */
+export interface EftposPayment {
+    /** 处理Eftpos支付 */
+    processEftposPayment: (amount: number, orderUuid: string) => Promise<void>;
+    /** 检查Eftpos设备状态 */
+    checkDeviceStatus: () => Promise<boolean>;
+}
+/**
+ * 钱包支付接口
+ */
+export interface WalletPassPayment {
+    /** 生成钱包API默认参数 */
+    generateWalletParams: (businessData: WalletInitBusinessData) => WalletDeductionRecommendParams;
+    /** 获取已存储的钱包参数 */
+    getStoredWalletParams: () => WalletDeductionRecommendParams | null;
+    /** 清理已存储的钱包参数 */
+    clearStoredWalletParams: () => void;
+    /** 初始化钱包数据（从业务数据开始，内部生成参数） */
+    initializeWalletDataFromBusinessAsync: (businessData: WalletInitBusinessData) => Promise<{
+        walletRecommendList: WalletRecommendItem[];
+        userIdentificationCodes: UserIdentificationCodeItem[];
+    }>;
+    /** 初始化钱包数据（先获取推荐列表，再获取用户识别码列表） */
+    initializeWalletDataAsync: (baseParams: WalletDeductionRecommendParams) => Promise<{
+        walletRecommendList: WalletRecommendItem[];
+        userIdentificationCodes: UserIdentificationCodeItem[];
+    }>;
+    /** 获取钱包推荐扣款列表（异步获取并缓存） */
+    getWalletPassRecommendListAsync: (params: WalletDeductionRecommendParams) => Promise<WalletRecommendItem[]>;
+    /** 查询用户识别码列表（异步获取并缓存） */
+    getUserIdentificationCodeListAsync: (params: UserIdentificationCodeParams) => Promise<UserIdentificationCodeItem[]>;
+    /** 搜索识别码信息 */
+    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams) => Promise<SearchIdentificationCodeResult>;
+    /** 获取缓存的搜索结果列表 */
+    getSearchResults: () => SearchIdentificationCodeItem[];
+    /** 根据识别码查找搜索结果 */
+    findSearchResultByCode: (code: string) => SearchIdentificationCodeItem | undefined;
+    /** 获取缓存的钱包推荐列表 */
+    getWalletRecommendList: () => WalletRecommendItem[];
+    /** 获取缓存的用户识别码列表 */
+    getUserIdentificationCodes: () => UserIdentificationCodeItem[];
+    /** 清除钱包推荐列表 */
+    clearWalletRecommendList: () => void;
+    /** 清除用户识别码列表 */
+    clearUserIdentificationCodes: () => void;
+    /** 清除搜索结果缓存 */
+    clearSearchResults: () => void;
+    /** 清除所有缓存数据 */
+    clearAllCache: () => void;
+    /** 处理钱包支付 */
+    processWalletPayment: (amount: number, orderUuid: string, voucherId?: string) => Promise<void>;
+    /** 获取钱包余额 */
+    getWalletBalance: (voucherId: string) => Promise<number>;
+}
+/**
+ * 支付模块API接口
  */
 export interface PaymentModuleAPI {
-    processPayment: (paymentId: string) => Promise<void>;
-    getPayment: (paymentId: string) => Promise<Payment>;
-    getPaymentHistory: () => Promise<Payment[]>;
-    refund: (paymentId: string) => Promise<void>;
-    getAvailablePaymentMethods: () => PaymentMethod[];
-    checkPaymentStatus: (paymentId: string) => Promise<PaymentStatus>;
+    /** 现金支付相关方法 */
+    cash: CashPayment;
+    /** Eftpos支付相关方法 */
+    eftpos: EftposPayment;
+    /** 钱包支付相关方法 */
+    wallet: WalletPassPayment;
+    /** 获取支付方式列表 */
+    getPayMethodListAsync: () => Promise<PaymentMethod[]>;
+    /** 创建支付订单（仅保存支付相关信息） */
+    createPaymentOrderAsync: (params: PushOrderParams) => Promise<PaymentOrder>;
+    /** 根据订单UUID获取支付订单 */
+    getPaymentOrderByUuidAsync: (orderUuid: string) => Promise<PaymentOrder | null>;
+    /** 基于UUID替换订单ID */
+    replaceOrderIdByUuidAsync: (orderUuid: string, newOrderId: string) => Promise<PaymentOrder | null>;
+    /** 删除支付订单 */
+    deletePaymentOrderAsync: (orderUuid: string) => Promise<void>;
+    /** 获取支付项 */
+    getPaymentItemsAsync: (orderUuid: string, includeVoided?: boolean) => Promise<PaymentItem[]>;
+    /** 获取所有支付项（包括已撤销的） */
+    getAllPaymentItemsAsync: (orderUuid: string) => Promise<PaymentItem[]>;
+    /** 为某个订单添加支付项 */
+    addPaymentItemAsync: (orderUuid: string, paymentItem: PaymentItemInput) => Promise<void>;
+    /** 删除支付项 */
+    deletePaymentAsync: (orderUuid: string, paymentUuid: string) => Promise<void>;
+    /** 更新支付项 */
+    updatePaymentAsync: (orderUuid: string, paymentUuid: string, params: PaymentUpdateFields) => Promise<void>;
+    /** 批量更新代金券类支付项（覆盖更新） */
+    updateVoucherPaymentItemsAsync: (orderUuid: string, voucherPaymentItems: PaymentItemInput[]) => Promise<void>;
+    /** 获取订单剩余待付金额 */
+    getRemainingOrderAmountAsync: (orderUuid: string) => Promise<number>;
+    /** 获取订单剩余待付金额（基于用户输入的金额） */
+    getRemainingOrderAmountWithInputAsync: (inputAmount: string | number, orderUuid: string) => Promise<number>;
+    /**
+     * 智能金额舍入
+     * @param originalAmount 原始金额
+     * @param interval 舍入间隔 (0.05, 0.1, 0.5, 1)
+     * @param rule 舍入规则 (standard, standard_down, always_up, always_down)
+     * @returns 舍入后的金额
+     */
+    roundAmountAsync: (originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string) => Promise<RoundingResult>;
+    /** 提交支付 */
+    submitPayAsync: (orderUuid?: string) => Promise<{
+        status: 'success' | 'failed';
+    }>;
+    /** 获取部分支付的订单 */
+    getPartiallyPaidOrdersAsync: () => Promise<PaymentOrder[]>;
+}
+/**
+ * 订单变化事件数据
+ */
+export interface OnOrderChangedEventData {
+    /** 操作类型 */
+    action: 'add' | 'delete' | 'update' | 'payment_add' | 'payment_delete' | 'payment_update' | 'submit';
+    /** 当前订单 */
+    order: PaymentOrder;
+    /** 原始订单（仅在 update 操作时提供） */
+    originalOrder?: PaymentOrder;
+    /** 相关的支付项（仅在 payment_* 操作时提供） */
+    paymentItem?: PaymentItem;
+}
+/**
+ * 支付方式变化事件数据
+ */
+export interface OnPaymentMethodsChangedEventData {
+    /** 旧的支付方式列表 */
+    oldMethods: PaymentMethod[];
+    /** 新的支付方式列表 */
+    newMethods: PaymentMethod[];
+}
+/**
+ * 支付同步错误事件数据
+ */
+export interface OnPaymentSyncErrorEventData {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 订单ID */
+    orderId: number;
+    /** 错误信息 */
+    error: string;
+    /** 错误代码 */
+    errorCode?: string;
+    /** HTTP状态码 */
+    statusCode?: number;
+    /** 错误发生时间 */
+    timestamp: number;
+    /** 响应数据（当HTTP请求成功但业务失败时） */
+    responseData?: any;
+}
+/**
+ * 支付同步成功事件数据
+ */
+export interface OnPaymentSyncSuccessEventData {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 订单ID */
+    orderId: number;
+    /** 成功时间 */
+    timestamp: number;
+}
+/**
+ * 钱包推荐列表更新事件数据
+ */
+export interface OnWalletRecommendListUpdatedEventData {
+    /** 新的钱包推荐列表 */
+    walletRecommendList: WalletRecommendItem[];
+}
+/**
+ * 用户识别码列表更新事件数据
+ */
+export interface OnUserIdentificationCodesUpdatedEventData {
+    /** 新的用户识别码列表 */
+    userIdentificationCodes: UserIdentificationCodeItem[];
+}
+/**
+ * 钱包缓存清除事件数据
+ */
+export interface OnWalletCacheClearedEventData {
+    /** 清除的数据类型 */
+    clearedTypes: ('walletRecommendList' | 'userIdentificationCodes' | 'all')[];
+}
+/**
+ * 搜索识别码完成事件数据
+ */
+export interface OnSearchIdentificationCodeCompletedEventData {
+    /** 当前搜索的识别码 */
+    searchCode: string;
+    /** 当前搜索返回的结果 */
+    currentSearchResults: SearchIdentificationCodeItem[];
+    /** 缓存中的所有搜索结果 */
+    cachedSearchResults: SearchIdentificationCodeItem[];
+    /** 搜索参数 */
+    searchParams: SearchIdentificationCodeParams;
+}
+/**
+ * 钱包初始化开始事件数据
+ */
+export interface OnWalletInitializationStartedEventData {
+    /** 业务数据 */
+    businessData: WalletInitBusinessData;
+    /** 开始时间 */
+    startTime: number;
+}
+/**
+ * 钱包初始化完成事件数据
+ */
+export interface OnWalletInitializationCompletedEventData {
+    /** 业务数据 */
+    businessData: WalletInitBusinessData;
+    /** 初始化结果 */
+    result: {
+        walletRecommendList: WalletRecommendItem[];
+        userIdentificationCodes: UserIdentificationCodeItem[];
+    };
+    /** 开始时间 */
+    startTime: number;
+    /** 结束时间 */
+    endTime: number;
+    /** 执行时长（毫秒） */
+    duration: number;
+}
+/**
+ * 钱包初始化失败事件数据
+ */
+export interface OnWalletInitializationFailedEventData {
+    /** 业务数据 */
+    businessData: WalletInitBusinessData;
+    /** 错误信息 */
+    error: Error;
+    /** 开始时间 */
+    startTime: number;
+    /** 结束时间 */
+    endTime: number;
+    /** 执行时长（毫秒） */
+    duration: number;
+}
+/**
+ * 钱包支付事件枚举
+ */
+export declare enum WalletPassHooks {
+    OnWalletRecommendListUpdated = "wallet:onWalletRecommendListUpdated",
+    OnWalletRecommendListCleared = "wallet:onWalletRecommendListCleared",
+    OnUserIdentificationCodesUpdated = "wallet:onUserIdentificationCodesUpdated",
+    OnUserIdentificationCodesCleared = "wallet:onUserIdentificationCodesCleared",
+    OnWalletCacheCleared = "wallet:onWalletCacheCleared",
+    OnSearchIdentificationCodeCompleted = "wallet:onSearchIdentificationCodeCompleted",
+    OnWalletInitializationStarted = "wallet:onWalletInitializationStarted",
+    OnWalletInitializationCompleted = "wallet:onWalletInitializationCompleted",
+    OnWalletInitializationFailed = "wallet:onWalletInitializationFailed"
+}
+/**
+ * 支付钩子事件（统一接口）
+ */
+export declare enum PaymentHooks {
+    OnPaymentMethodsLoaded = "payment:onPaymentMethodsLoaded",
+    OnPaymentMethodsChanged = "payment:onPaymentMethodsChanged",
+    OnOrderChanged = "payment:onOrderChanged",
+    OnOrderAdded = "payment:onOrderAdded",
+    OnOrderUpdated = "payment:onOrderUpdated",
+    OnOrderDeleted = "payment:onOrderDeleted",
+    OnPaymentAdded = "payment:onPaymentAdded",
+    OnPaymentUpdated = "payment:onPaymentUpdated",
+    OnPaymentDeleted = "payment:onPaymentDeleted",
+    OnPaymentSubmitted = "payment:onPaymentSubmitted",
+    OnOrderAmountChanged = "payment:onOrderAmountChanged",
+    OnPaymentSyncError = "payment:onPaymentSyncError",
+    OnPaymentSyncSuccess = "payment:onPaymentSyncSuccess",
+    OnWalletRecommendListUpdated = "wallet:onWalletRecommendListUpdated",
+    OnWalletRecommendListCleared = "wallet:onWalletRecommendListCleared",
+    OnUserIdentificationCodesUpdated = "wallet:onUserIdentificationCodesUpdated",
+    OnUserIdentificationCodesCleared = "wallet:onUserIdentificationCodesCleared",
+    OnWalletCacheCleared = "wallet:onWalletCacheCleared",
+    OnSearchIdentificationCodeCompleted = "wallet:onSearchIdentificationCodeCompleted"
+}
+/**
+ * 钱包推荐扣款请求参数
+ */
+export interface WalletDeductionRecommendParams {
+    /** 销售渠道 */
+    sale_channel: string;
+    /** 前端设置只想要的字段 */
+    expect_columns?: string[];
+    /** 客户id */
+    customer_id?: number;
+    /** 订单总计金额 */
+    order_expect_amount: number;
+    /** 订单小计金额 */
+    order_product_amount: number;
+    /** 订单待支付金额 */
+    order_wait_pay_amount: number;
+    /** 统计计数用户id */
+    order_behavior_count_customer_id?: number;
+    /** 已选商品 */
+    products: {
+        /** 商品id */
+        product_id: number;
+        /** 商品variant_id */
+        product_variant_id: string;
+        /** 商品数量 */
+        quantity: number;
+        /** 商品使用了所有优惠后的最终价格 */
+        selling_price: number;
+    }[];
+    /** 预备支付 */
+    prepare_payments?: {
+        voucher_id: number;
+        amount: number;
+        tag: string;
+    }[];
+}
+/**
+ * 钱包初始化业务数据接口
+ * 用于生成钱包API参数的必要业务信息
+ */
+export interface WalletInitBusinessData {
+    /** 客户ID（可选） */
+    customer_id?: number;
+    /** 金额信息 */
+    amountInfo: {
+        totalAmount: string;
+        subTotal: string;
+    };
+    /** 商品列表 */
+    products: {
+        product_id: number;
+        product_variant_id: string;
+        quantity: number;
+        selling_price: number;
+    }[];
+    order_wait_pay_amount?: number;
+}
+/**
+ * 查询用户识别码列表请求参数
+ */
+export interface UserIdentificationCodeParams extends WalletDeductionRecommendParams {
+    /** 是否可用 */
+    available?: 0 | 1 | 2;
+    /** 其他精确码 */
+    other_exact_codes?: string[];
+    /** 过滤预备钱包通行证 */
+    filter_prepare_wallet_pass?: 0 | 1;
+    /** 预备支付 */
+    prepare_payments?: {
+        voucher_id: number;
+        amount: number;
+        tag: string;
+    }[];
+}
+/**
+ * 钱包推荐扣款响应数据
+ */
+export interface WalletDeductionRecommendResponse {
+    /** 响应状态码 */
+    code?: number;
+    /** 响应消息 */
+    message?: string;
+    /** 响应数据 */
+    data?: WalletRecommendItem[];
+}
+/**
+ * 用户识别码列表响应数据
+ */
+export interface UserIdentificationCodeResponse {
+    /** 响应状态码 */
+    code?: number;
+    /** 响应消息 */
+    message?: string;
+    /** 响应数据 */
+    data?: UserIdentificationCodeItem[];
+}
+/**
+ * 用户识别码项目
+ */
+export interface UserIdentificationCodeItem {
+    /** 识别码ID */
+    id: number;
+    /** 识别码 */
+    code: string;
+    /** 识别码名称 */
+    name: string;
+    /** 识别码类型 */
+    type: string;
+    /** 是否可用 */
+    available: boolean;
+    /** 余额信息 */
+    balance?: number;
+    /** 有效期 */
+    expires_at?: string;
+    /** 其他扩展字段 */
+    [key: string]: any;
+}
+/**
+ * 搜索识别码请求参数
+ * 基于 WalletDeductionRecommendParams 并增加 code 字段
+ */
+export interface SearchIdentificationCodeParams extends WalletDeductionRecommendParams {
+    /** 识别码 */
+    code: string;
+}
+/**
+ * 搜索识别码响应数据
+ */
+export interface SearchIdentificationCodeResponse {
+    /** 响应状态码 */
+    code?: number;
+    /** 响应消息 */
+    message?: string;
+    /** 响应数据 */
+    data?: SearchIdentificationCodeItem[];
+}
+/**
+ * 搜索识别码结果类型
+ */
+export type SearchIdentificationCodeResult = {
+    type: 'walletCode';
+    data: SearchIdentificationCodeItem[];
+} | {
+    type: 'normalCode';
+    data: SearchIdentificationCodeItem[];
+};
+/**
+ * 搜索识别码项目
+ */
+export interface SearchIdentificationCodeItem {
+    /** 识别码ID */
+    id: number;
+    /** 识别码 */
+    code: string;
+    /** 识别码名称 */
+    name: string;
+    /** 识别码类型 */
+    type: string;
+    /** 标签 */
+    tag?: string;
+    /** 是否可用 */
+    available: boolean;
+    /** 余额信息 */
+    balance?: number;
+    /** 有效期 */
+    expires_at?: string;
+}
+/**
+ * 钱包推荐项目
+ */
+export interface WalletRecommendItem {
+    /** 推荐项目ID */
+    id: number;
+    /** 推荐项目名称 */
+    name: string;
+    /** 推荐金额 */
+    amount: number;
+    /** 项目类型 */
+    type: string;
+    /** 是否可用 */
+    available: boolean;
+    /** 优先级 */
+    priority?: number;
+    /** 其他扩展字段 */
+    [key: string]: any;
 }