@seaverse/payment-sdk 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -9,7 +9,7 @@
  * - monthly: Monthly credits (expires 30 days after last grant)
  * - permanent: Permanent credits (never expires)
  */
-type CreditPoolType = 'daily' | 'event' | 'monthly' | 'permanent';
+type CreditPoolType$1 = 'daily' | 'event' | 'monthly' | 'permanent';
 /**
  * Single credit pool detail
  */
@@ -17,7 +17,7 @@ interface CreditPoolDetail {
     /**
      * Pool type
      */
-    type: CreditPoolType;
+    type: CreditPoolType$1;
     /**
      * Balance in this pool (decimal string for precision)
      */
@@ -32,7 +32,7 @@ interface CreditPoolDetail {
 /**
  * Credit detail response data
  */
-interface CreditDetailResponse {
+interface CreditDetailResponse$1 {
     /**
      * Total balance across all pools
      */
@@ -48,7 +48,7 @@ interface CreditDetailResponse {
 interface CreditDetailSuccessResponse {
     code: 0;
     message: string;
-    data: CreditDetailResponse;
+    data: CreditDetailResponse$1;
 }
 /**
  * Credit account model
@@ -249,7 +249,7 @@ declare class PaymentClient {
      * });
      * ```
      */
-    getCreditDetail(): Promise<CreditDetailResponse>;
+    getCreditDetail(): Promise<CreditDetailResponse$1>;
     /**
      * Get authenticated user's credit account information
      *
@@ -445,6 +445,8 @@ interface CheckoutOptions extends BaseCheckoutOptions {
 interface SubscribeOptions extends CheckoutOptions {
     /** 计费周期（可选，"month" 或 "year"，默认 "month"） */
     billing_period?: BillingPeriod;
+    /** 购买类型：1-一次性，2-订阅（必填） */
+    purchaseType: PurchaseType;
 }
 /**
  * 显示支付弹窗选项
@@ -1030,6 +1032,1377 @@ declare const BIZ_CODE: {
     readonly INVALID_ORDER_STATUS: 4006;
 };
 
+/**
+ * SeaartPayment Types
+ * SeaartPaymentComponent SDK 相关类型定义
+ */
+declare global {
+    interface Window {
+        SeaartPaymentComponent: SeaartPaymentComponentSDK;
+    }
+}
+/**
+ * SeaartPaymentComponent SDK 接口
+ */
+interface SeaartPaymentComponentSDK {
+    /**
+     * 初始化 SDK
+     */
+    init(config: {
+        client_id: string;
+        language?: string;
+    }): Promise<void>;
+    /**
+     * 获取支付方式列表
+     */
+    getPaymentMethodList(params: {
+        country_code: string;
+        business_type: number;
+    }): Promise<PaymentMethodListResponse>;
+    /**
+     * 创建支付实例
+     */
+    createPayment(params: {
+        sys_order_id: string;
+        account_token?: string;
+    }): SeaartPaymentInstance;
+}
+/**
+ * 支付实例接口
+ */
+interface SeaartPaymentInstance {
+    /**
+     * 获取订单信息
+     */
+    getOrderInfo(): Promise<OrderInfoResponse>;
+    /**
+     * 创建 Link 支付
+     */
+    createLink(paymentMethod: PaymentMethod, options: {
+        callback_url: string;
+    }): SeaartLinkPayment;
+    /**
+     * 创建 Dropin 支付
+     */
+    createDropin(paymentMethod: PaymentMethod, callbacks: DropinCallbacks): SeaartDropinPayment;
+    /**
+     * 创建 BindCard 支付
+     */
+    createBindCard(paymentMethod: PaymentMethod, callbacks: BindCardCallbacks): SeaartBindCardPayment;
+}
+/**
+ * Link 支付接口
+ */
+interface SeaartLinkPayment {
+    /**
+     * 创建订单并获取支付链接
+     */
+    createOrder(): Promise<{
+        data: {
+            payment_url: string;
+            transaction_id: string;
+        };
+    }>;
+}
+/**
+ * Dropin 支付接口
+ */
+interface SeaartDropinPayment {
+    /**
+     * 渲染支付组件到指定容器
+     */
+    render(selector: string): Promise<void>;
+    /**
+     * 销毁支付组件
+     */
+    destroy(): void;
+}
+/**
+ * BindCard 支付接口
+ */
+interface SeaartBindCardPayment {
+    /**
+     * 获取用户已绑定的卡列表
+     */
+    getCardList(): Promise<BindCardListResponse>;
+    /**
+     * 使用已绑定的卡创建订单
+     */
+    createOrder(instrumentId: string): Promise<void>;
+}
+/**
+ * Dropin 回调集合
+ */
+interface DropinCallbacks {
+    onSubmit?: (payload: any) => void;
+    onError?: (payload: any, error: any) => void;
+    onCreateOrder?: (payload: any) => void;
+    onCompleted?: (payload: any) => void;
+    onFailed?: (payload: any) => void;
+    onLoading?: (loading: boolean) => void;
+}
+/**
+ * BindCard 回调集合
+ */
+interface BindCardCallbacks {
+    onCompleted?: (payload: any) => void;
+    onFailed?: (payload: any) => void;
+}
+/**
+ * 支付方式列表响应
+ */
+interface PaymentMethodListResponse {
+    err: number;
+    message?: string;
+    data?: {
+        payment_method_list: PaymentMethod[];
+    };
+}
+/**
+ * 订单信息响应
+ */
+interface OrderInfoResponse {
+    err: number;
+    message?: string;
+    data?: {
+        order_info: OrderInfo;
+    };
+}
+/**
+ * 已绑卡列表响应
+ */
+interface BindCardListResponse {
+    err: number;
+    message?: string;
+    data?: {
+        user_bind_info_list: BindCard[];
+    };
+}
+/**
+ * SDK 配置
+ */
+interface SeaartPaymentSDKConfig {
+    /** 脚本 URL */
+    scriptUrl: string;
+    /** 客户端 ID */
+    clientId: string;
+    /** 语言 */
+    language?: string;
+    /** 脚本加载超时（毫秒） */
+    scriptTimeout?: number;
+    /** CSS 样式表 URL（可选） */
+    cssUrl?: string;
+}
+/**
+ * 支付方式
+ */
+interface PaymentMethod {
+    /** 渠道方支付id */
+    channel_pay_id: string;
+    /** 支付渠道名称 */
+    payment_channel_name: string;
+    /** 支付渠道 1-adyen 2-paypal 3-v5pay 5-wallet */
+    payment_channel_type: number;
+    /** 支付方式图标 */
+    payment_method_icon: string;
+    /** 支付方式id */
+    payment_method_id: string;
+    /** 支付方式名称 */
+    payment_method_name: string;
+    /** 支付类型 1:link 2:dropin */
+    payment_type: 1 | 2;
+    /** 支付方式类型 */
+    payment_method_type: string;
+}
+/**
+ * 支付方式查询参数
+ */
+interface PaymentMethodsParams {
+    /** 国家/地区代码 */
+    country_code: string;
+    /** 业务类型：1-一次性购买，2-订阅 */
+    business_type: 1 | 2;
+}
+/**
+ * 订单信息
+ */
+interface OrderInfo {
+    /** 平台订单号 */
+    sys_order_id?: string;
+    /** 订单状态 1=>待支付,2=>已支付 */
+    order_status?: number;
+    /** 订单剩余时间（秒） */
+    expire_time: number;
+    /** 语言码 */
+    language_code?: string;
+    /** 国家码 */
+    country_code?: string;
+    /** 接入方订单id */
+    cp_order_id?: string;
+    /** 币种 */
+    currency?: string;
+    /** 三方平台订单id */
+    flow_id?: string;
+    /** 包名 */
+    package_name?: string;
+    /** 支付类型,1-一次性购买,2-订阅 */
+    pay_type?: number;
+    /** 应付价格 */
+    price?: number;
+    /** 商品id */
+    product_id?: string;
+    /** 商品名称 */
+    product_name?: string;
+    /** 购买数量 */
+    quantity?: string;
+    /** 应付价格 */
+    mark_price?: number;
+}
+/**
+ * Link 支付参数
+ */
+interface LinkPaymentOptions {
+    /** 回调 URL */
+    callback_url: string;
+}
+/**
+ * Dropin 支付参数
+ */
+interface DropinPaymentOptions {
+    /** 容器 ID（CSS 选择器） */
+    containerId: string;
+    /** 用户提交支付表单时触发 */
+    onSubmit?: (payload: any) => void;
+    /** 创建支付组件过程中发生错误时触发 */
+    onError?: (payload: any, error: any) => void;
+    /** 创建支付订单时触发 */
+    onCreateOrder?: (payload: any) => void;
+    /** 支付成功完成时触发 */
+    onCompleted?: (payload: any) => void;
+    /** 支付失败时触发 */
+    onFailed?: (payload: any) => void;
+    /** 加载状态变化时触发 */
+    onLoading?: (loading: boolean) => void;
+}
+/**
+ * BindCard 支付参数
+ */
+interface BindCardPaymentOptions {
+    /** 支付完成回调 */
+    onCompleted?: (payload: any) => void;
+    /** 支付失败回调 */
+    onFailed?: (payload: any) => void;
+}
+/**
+ * 已绑定的卡信息
+ */
+interface BindCard {
+    /** 卡号(掩码) */
+    card_no?: string;
+    /** 支付渠道 1-adyen 2-paypal 3-v5pay 4-payermax */
+    channel_type?: number;
+    /** 用户支付方式记录唯一id */
+    instrument_id?: string;
+    /** 最后使用时间 */
+    last_use_at?: number;
+    /** 支付方式类型 */
+    payment_method_type?: string;
+    /** 支付方式卡品牌 */
+    stored_payment_method_type?: string;
+    /** 用户ID */
+    user_id?: string;
+    /** 用户类型 1-identify_id 2-cp_account_id */
+    user_type?: number;
+}
+/**
+ * Generic package interface that supports all package types
+ */
+interface GenericPackage {
+    /** Unique package ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Price in USD (string for decimal precision) */
+    price: string;
+    /** Currency code */
+    currency: string;
+    /** Total credits */
+    credits: string;
+    /** Base credits (optional, for packages with bonus) */
+    base_credits?: string;
+    /** Bonus credits (optional) */
+    bonus_credits?: string;
+    /** Bonus percentage (e.g., 20 for +20%) */
+    bonus_percentage?: number;
+    /** Daily purchase limit (0 = unlimited) */
+    day_limit?: number;
+    /** Lifetime purchase limit (0 = unlimited) */
+    lifetime_limit?: number;
+    /** Package type for categorization */
+    package_type?: 'iceBreaker' | 'emergency' | 'firstCharge' | 'custom';
+}
+
+/**
+ * LinkPaymentComponent
+ * Link 支付组件（跳转支付）- payment_type = 1
+ */
+
+declare class LinkPaymentComponent {
+    private paymentInstance;
+    private orderId;
+    private accountToken?;
+    private paymentMethod;
+    private callbackUrl;
+    private linkPayment;
+    constructor(params: {
+        paymentInstance: SeaartPaymentInstance;
+        orderId: string;
+        accountToken?: string;
+        paymentMethod: PaymentMethod;
+        callbackUrl: string;
+    });
+    /**
+     * 创建订单并获取支付链接
+     */
+    createOrder(): Promise<{
+        data: {
+            payment_url: string;
+            transaction_id: string;
+        };
+    }>;
+    /**
+     * 跳转到支付页面（当前窗口）
+     */
+    redirectToPayment(): Promise<void>;
+    /**
+     * 新窗口打开支付页面
+     */
+    openPayment(windowFeatures?: string): Promise<Window | null>;
+}
+
+/**
+ * DropinPaymentComponent
+ * Dropin 支付组件（嵌入式支付）- payment_type = 2
+ */
+
+declare class DropinPaymentComponent {
+    private paymentInstance;
+    private orderId;
+    private accountToken?;
+    private paymentMethod;
+    private containerId;
+    private callbacks;
+    private dropinPayment;
+    private rendered;
+    constructor(params: {
+        paymentInstance: SeaartPaymentInstance;
+        orderId: string;
+        accountToken?: string;
+        paymentMethod: PaymentMethod;
+    } & DropinPaymentOptions);
+    /**
+     * 渲染支付组件到容器
+     */
+    render(): Promise<void>;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}
+
+/**
+ * BindCardPaymentComponent
+ * BindCard 支付组件（已绑定卡片支付）
+ */
+
+declare class BindCardPaymentComponent {
+    private paymentInstance;
+    private orderId;
+    private paymentMethod;
+    private callbacks;
+    private bindCardPayment;
+    constructor(params: {
+        paymentInstance: SeaartPaymentInstance;
+        orderId: string;
+        accountToken?: string;
+        paymentMethod: PaymentMethod;
+    } & BindCardPaymentOptions);
+    /**
+     * 获取用户已绑定的卡列表
+     */
+    getCardList(): Promise<BindCard[]>;
+    /**
+     * 使用已绑定的卡创建订单
+     */
+    createOrder(instrumentId: string): Promise<void>;
+}
+
+/**
+ * OrderPayment
+ * 订单支付实例 - 为每个订单创建独立的支付实例
+ */
+
+declare class OrderPayment {
+    private paymentInstance;
+    private orderId;
+    private accountToken?;
+    constructor(params: {
+        paymentInstance: SeaartPaymentInstance;
+        orderId: string;
+        accountToken?: string;
+    });
+    /**
+     * 获取订单信息
+     */
+    getOrderInfo(): Promise<OrderInfo>;
+    /**
+     * 创建 Link 支付组件（按需加载）
+     * 适用于 payment_type = 1
+     */
+    createLinkPayment(paymentMethod: PaymentMethod, options: LinkPaymentOptions): LinkPaymentComponent;
+    /**
+     * 创建 Dropin 支付组件（按需加载）
+     * 适用于 payment_type = 2
+     */
+    createDropinPayment(paymentMethod: PaymentMethod, options: DropinPaymentOptions): DropinPaymentComponent;
+    /**
+     * 创建 BindCard 支付组件（按需加载）
+     * 适用于 payment_type = 2 且支持绑卡的支付方式
+     */
+    createBindCardPayment(paymentMethod: PaymentMethod, options: BindCardPaymentOptions): BindCardPaymentComponent;
+}
+
+/**
+ * PaymentModal - 原生 JavaScript 支付弹框组件
+ * 提供类似 next-meta 的 BaseModal 体验，但使用纯 JavaScript 实现
+ * 支持 Dropin 支付模式的嵌入式展示
+ */
+interface PaymentModalOptions {
+    /** 弹框标题 */
+    title?: string;
+    /** 是否显示关闭按钮 */
+    showCloseButton?: boolean;
+    /** 点击遮罩层是否关闭 */
+    closeOnOverlayClick?: boolean;
+    /** ESC 键是否关闭 */
+    closeOnEsc?: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 弹框宽度（默认: 480px） */
+    maxWidth?: string;
+}
+declare class PaymentModal {
+    private overlay;
+    private modal;
+    private contentContainer;
+    private isOpen;
+    private isExiting;
+    private options;
+    private escHandler;
+    private savedScrollY;
+    private savedScrollbarWidth;
+    constructor(options?: PaymentModalOptions);
+    /**
+     * 打开弹框
+     */
+    open(): void;
+    /**
+     * 关闭弹框
+     */
+    close(): void;
+    /**
+     * 设置弹框内容
+     */
+    setContent(content: HTMLElement | string): void;
+    /**
+     * 获取内容容器
+     */
+    getContentContainer(): HTMLElement | null;
+    /**
+     * 销毁弹框
+     */
+    private destroy;
+    /**
+     * 创建弹框元素
+     */
+    private createModal;
+    /**
+     * 注入动画样式
+     */
+    private injectStyles;
+    /**
+     * 锁定 body 滚动
+     */
+    private lockBodyScroll;
+    /**
+     * 解锁 body 滚动
+     */
+    private unlockBodyScroll;
+    /**
+     * 检查弹框是否打开
+     */
+    isModalOpen(): boolean;
+}
+
+/**
+ * DropinPaymentModal - Dropin 支付弹框
+ * 封装 DropinPaymentComponent 并在弹框中展示
+ */
+
+interface DropinPaymentModalOptions extends Omit<DropinPaymentOptions, 'containerId'> {
+    /** 弹框标题 */
+    modalTitle?: string;
+    /** 弹框选项 */
+    modalOptions?: Omit<PaymentModalOptions, 'title'>;
+}
+declare class DropinPaymentModal {
+    private paymentInstance;
+    private orderId;
+    private accountToken;
+    private paymentMethod;
+    private options;
+    private modal;
+    private dropinPayment;
+    private containerElement;
+    constructor(paymentInstance: SeaartPaymentInstance, orderId: string, accountToken: string | undefined, paymentMethod: PaymentMethod, options: DropinPaymentModalOptions);
+    /**
+     * 打开弹框并渲染支付组件
+     */
+    open(): Promise<void>;
+    /**
+     * 关闭弹框
+     */
+    close(): void;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * 显示加载状态
+     */
+    private showLoading;
+    /**
+     * 隐藏加载状态
+     */
+    private hideLoading;
+    /**
+     * 检查弹框是否打开
+     */
+    isOpen(): boolean;
+}
+
+/**
+ * SeaartPaymentSDK
+ * 基于 SeaartPaymentComponent 的支付 SDK 封装
+ *
+ * 核心职责：
+ * 1. 动态加载 SeaartPaymentComponent 脚本
+ * 2. 全局初始化（仅一次）
+ * 3. 获取支付方式列表
+ * 4. 创建订单支付实例
+ */
+
+declare class SeaartPaymentSDK {
+    private static instance;
+    private initialized;
+    private config;
+    /**
+     * 私有构造函数（单例模式）
+     */
+    private constructor();
+    /**
+     * 获取 SDK 单例
+     */
+    static getInstance(): SeaartPaymentSDK;
+    /**
+     * 全局初始化（应用启动时调用一次）
+     */
+    init(config: SeaartPaymentSDKConfig): Promise<void>;
+    /**
+     * 获取支付方式列表
+     */
+    getPaymentMethods(params: PaymentMethodsParams): Promise<PaymentMethod[]>;
+    /**
+     * 创建订单支付实例
+     */
+    createOrderPayment(params: {
+        orderId: string;
+        accountToken?: string;
+    }): OrderPayment;
+    /**
+     * 创建 Dropin 支付弹框（快捷方法）
+     * 在弹框中直接展示 Dropin 支付组件
+     */
+    createDropinPaymentModal(params: {
+        orderId: string;
+        accountToken?: string;
+        paymentMethod: PaymentMethod;
+    } & DropinPaymentModalOptions): DropinPaymentModal;
+    /**
+     * 处理支付回调（在回调页面调用）
+     * @param params 回调参数
+     * @param apiHost Payment API 地址
+     * @param authToken 认证 Token
+     */
+    handleCallback(params: {
+        type: 'subscription' | 'creditpack' | 'change_subscription';
+    }, apiHost: string, authToken?: string): Promise<{
+        success: boolean;
+        status: string;
+        data?: any;
+    }>;
+    /**
+     * 确保 SDK 已初始化
+     */
+    private ensureInitialized;
+    /**
+     * 获取当前配置（用于组件访问）
+     */
+    getConfig(): SeaartPaymentSDKConfig | null;
+    /**
+     * 销毁 SDK（测试用）
+     */
+    destroy(): void;
+}
+
+/**
+ * 共享类型定义
+ * Shared types for CreditPackageModal and GenericPackageModal
+ */
+/** 环境类型 */
+type Environment = 'development' | 'production';
+/** 环境配置接口 */
+interface EnvironmentConfig {
+    /** SDK 脚本 URL */
+    scriptUrl: string;
+    /** 客户端 ID */
+    clientId: string;
+    /** 订单 API 地址 */
+    orderApiUrl: string;
+    /** 钱包 API 地址 */
+    walletApiUrl: string;
+    /** CSS 文件 URL */
+    cssUrl: string;
+}
+/**
+ * SDK 配置选项 - 简化版（支持环境变量）
+ * 用户只需提供 environment、countryCode、accountToken 三个核心参数
+ * SDK 会自动根据 environment 选择对应的配置
+ */
+interface PaymentSDKConfig {
+    /** 环境变量（development/production） - SDK 自动选择对应配置 */
+    environment: Environment;
+    /** 国家/地区代码 */
+    countryCode: string;
+    /** 账户 Token（用于用户认证） */
+    accountToken?: string;
+    /** 业务类型：1-一次性，2-订阅（可选，默认为 1） */
+    businessType?: 1 | 2;
+    /** 脚本加载超时（毫秒，默认 10000ms） */
+    scriptTimeout?: number;
+    /** 支付方式类型过滤（可选，默认 'dropin'） */
+    paymentMethodType?: string;
+    /** 自定义脚本 URL（覆盖环境配置） */
+    scriptUrl?: string;
+    /** 自定义客户端 ID（覆盖环境配置） */
+    clientId?: string;
+    /** 自定义订单 API 地址（覆盖环境配置） */
+    orderApiUrl?: string;
+    /** 自定义 CSS URL（覆盖环境配置） */
+    cssUrl?: string;
+}
+
+/**
+ * CreditPackageModal - 积分套餐选择弹框
+ * 展示不同的积分套餐供用户选择
+ */
+
+interface CreditPackageModalOptions {
+    /** SDK 配置（必填 - 用于自动初始化支付 SDK） */
+    sdkConfig: PaymentSDKConfig;
+    /** 语言（默认 'en'） */
+    language?: 'en' | 'zh-CN';
+    /** 弹框标题 */
+    title?: string;
+    /** 弹框标题（中文） */
+    title_cn?: string;
+    /** 副标题 */
+    subtitle?: string;
+    /** 副标题（中文） */
+    subtitle_cn?: string;
+    /**
+     * 支付成功回调 - 弹框内部完成支付后通知使用方
+     * @param orderId 订单ID
+     * @param transactionId 交易ID
+     */
+    onPaymentSuccess?: (orderId: string, transactionId: string) => void;
+    /**
+     * 支付失败回调
+     * @param error 错误信息
+     */
+    onPaymentFailed?: (error: Error) => void;
+    /** 弹框关闭回调 */
+    onClose?: () => void;
+    paymentMethod?: PaymentMethod;
+    accountToken?: string;
+}
+declare class CreditPackageModal {
+    private modal;
+    private options;
+    private language;
+    private resizeHandler;
+    private isInitializingSDK;
+    private sdkInitialized;
+    private readonly SPACING;
+    private readonly COLORS;
+    constructor(options: CreditPackageModalOptions);
+    /**
+     * 打开弹框
+     */
+    open(): Promise<void>;
+    /**
+     * 等待 SDK 初始化完成（支持超时和重试）
+     * @param timeout 超时时间（毫秒），默认 30 秒
+     * @param maxRetries 最大重试次数，默认 1 次
+     * @returns 是否初始化成功
+     */
+    private waitForSDKInitialization;
+    /**
+     * 初始化支付SDK（后台静默执行）
+     */
+    private initializeSDK;
+    /**
+     * 关闭弹框
+     */
+    close(): void;
+    /**
+     * 获取响应式样式配置
+     */
+    private getResponsiveStyles;
+    /**
+     * 渲染弹框内容
+     */
+    private renderContent;
+    /**
+     * 渲染套餐卡片
+     */
+    private renderPackageCard;
+    /**
+     * 格式化数字（添加逗号）
+     */
+    private formatNumber;
+    /**
+     * 获取加载按钮的 HTML（带旋转动画）
+     * @param text 加载文本
+     * @param isPopular 是否为 Popular 套餐（用于调整颜色）
+     */
+    private getLoadingButtonHTML;
+    /**
+     * 添加事件监听
+     */
+    private attachEventListeners;
+    /**
+     * 处理支付流程
+     */
+    private handlePaymentFlow;
+    /**
+     * 打开支付弹框
+     */
+    private openPaymentModal;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * 检查弹框是否打开
+     */
+    isOpen(): boolean;
+}
+
+/**
+ * GenericPackageModal - 通用套餐选择弹框
+ * 支持多种套餐类型（破冰包、告急包、首充包等）
+ * 套餐数据从外部配置传入,无硬编码
+ */
+
+interface GenericPackageModalOptions {
+    /** 套餐数据（必填 - 从外部配置传入） */
+    packages: GenericPackage[];
+    /** SDK 配置（必填 - 用于自动初始化支付 SDK） */
+    sdkConfig: PaymentSDKConfig;
+    /** 语言（默认 'en'） */
+    language?: 'en' | 'zh-CN';
+    /**
+     * 支付成功回调 - 弹框内部完成支付后通知使用方
+     * @param orderId 订单ID
+     * @param transactionId 交易ID
+     * @param pkg 购买的套餐
+     */
+    onPaymentSuccess?: (orderId: string, transactionId: string, pkg: GenericPackage) => void;
+    /**
+     * 支付失败回调
+     * @param error 错误信息
+     * @param pkg 购买失败的套餐
+     */
+    onPaymentFailed?: (error: Error, pkg: GenericPackage) => void;
+    /** 弹框关闭回调 */
+    onClose?: () => void;
+}
+declare class GenericPackageModal {
+    private modal;
+    private options;
+    private language;
+    private resizeHandler;
+    private isInitializingSDK;
+    private sdkInitialized;
+    private paymentMethod?;
+    private accountToken?;
+    constructor(options: GenericPackageModalOptions);
+    /**
+     * 打开弹框
+     */
+    open(): Promise<void>;
+    /**
+     * 等待 SDK 初始化完成（支持超时和重试）
+     * @param timeout 超时时间（毫秒），默认 30 秒
+     * @param maxRetries 最大重试次数，默认 1 次
+     * @returns 是否初始化成功
+     */
+    private waitForSDKInitialization;
+    /**
+     * 初始化支付SDK（后台静默执行）
+     */
+    private initializeSDK;
+    /**
+     * 关闭弹框
+     */
+    close(): void;
+    /**
+     * 渲染弹框内容
+     */
+    private renderContent;
+    /**
+     * 渲染套餐卡片
+     */
+    private renderPackageCard;
+    /**
+     * 格式化数字（添加逗号）
+     */
+    private formatNumber;
+    /**
+     * 获取加载按钮的 HTML（带旋转动画）
+     */
+    private getLoadingButtonHTML;
+    /**
+     * 添加事件监听
+     */
+    private attachEventListeners;
+    /**
+     * 处理支付流程
+     */
+    private handlePaymentFlow;
+    /**
+     * 打开支付弹框
+     */
+    private openPaymentModal;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * 检查弹框是否打开
+     */
+    isOpen(): boolean;
+}
+
+/**
+ * 积分套餐数据
+ */
+interface CreditPackage {
+    id: string;
+    name: string;
+    price: string;
+    currency: string;
+    base_credits: string;
+    bonus_credits: string;
+    credits: string;
+    day_limit: number;
+    is_popular?: boolean;
+}
+declare const CREDIT_PACKAGES: CreditPackage[];
+/**
+ * 创作力量类型和对应的积分消耗
+ */
+interface CreativePowerType {
+    icon: string;
+    name: string;
+    name_cn: string;
+    credits_range: string;
+    description: string;
+    description_cn: string;
+}
+declare const CREATIVE_POWER_TYPES: CreativePowerType[];
+
+/**
+ * 共享配置文件
+ * Shared configuration for CreditPackageModal and GenericPackageModal
+ */
+
+/**
+ * 环境配置映射表
+ * SDK 根据 environment 参数自动选择对应的配置
+ */
+declare const ENVIRONMENT_CONFIGS: Record<Environment, EnvironmentConfig>;
+/**
+ * 响应式断点配置
+ * Responsive breakpoints for grid layout
+ */
+declare const RESPONSIVE_BREAKPOINTS: {
+    readonly mobile: 768;
+    readonly tablet: 1200;
+    readonly laptop: 1400;
+    readonly desktop: number;
+};
+/**
+ * 网格列数配置
+ * Grid columns for different screen sizes
+ */
+declare const GRID_COLUMNS: {
+    readonly mobile: 1;
+    readonly tablet: 2;
+    readonly laptop: 2;
+    readonly desktop: 4;
+};
+/**
+ * SDK 初始化配置
+ */
+declare const SDK_CONFIG: {
+    /** 默认脚本加载超时 (毫秒) */
+    readonly DEFAULT_SCRIPT_TIMEOUT: 10000;
+    /** 默认 SDK 初始化超时 (毫秒) */
+    readonly DEFAULT_INIT_TIMEOUT: 30000;
+    /** 默认最大重试次数 */
+    readonly DEFAULT_MAX_RETRIES: 1;
+    /** 默认业务类型 (1=一次性购买, 2=订阅) */
+    readonly DEFAULT_BUSINESS_TYPE: 1;
+};
+
+/**
+ * UI 反馈工具类
+ * 提供统一的用户界面反馈（错误提示、加载状态等）
+ */
+/**
+ * 显示错误消息
+ * 替代浏览器原生 alert()，提供更好的用户体验
+ *
+ * @param message 错误消息
+ * @param duration 显示时长（毫秒），默认 3000ms
+ */
+declare function showErrorMessage(message: string, duration?: number): void;
+/**
+ * 显示成功消息
+ *
+ * @param message 成功消息
+ * @param duration 显示时长（毫秒），默认 3000ms
+ */
+declare function showSuccessMessage(message: string, duration?: number): void;
+/**
+ * 显示加载指示器
+ *
+ * @param message 加载消息，默认 'Initializing...'
+ * @returns 加载指示器的 HTML 元素（用于后续移除）
+ */
+declare function showLoadingIndicator(message?: string): HTMLElement;
+/**
+ * 移除加载指示器
+ *
+ * @param loader 加载指示器元素（可选）
+ */
+declare function hideLoadingIndicator(loader?: HTMLElement | null): void;
+/**
+ * 显示信息提示
+ *
+ * @param message 信息内容
+ * @param duration 显示时长（毫秒），默认 3000ms
+ */
+declare function showInfoMessage(message: string, duration?: number): void;
+
+/**
+ * PurchaseSuccessModal - 购买成功弹窗
+ * 纯 JavaScript 实现，不依赖 React
+ *
+ * 参考设计: credit-pack-success-modal
+ * - 邮件确认卡片风格
+ * - 精美的动画效果（淡入淡出、缩放）
+ * - 包含成功图标、套餐详情、积分数、支付金额
+ */
+interface PurchaseSuccessData {
+    /** 套餐名称 */
+    packName: string;
+    /** 积分数 */
+    credits: number;
+    /** 金额（例如: "0.49"） */
+    amount: string;
+    /** 货币符号（例如: "$"），默认 "$" */
+    currency?: string;
+    /** 订单ID（可选） */
+    orderId?: string;
+    /** 交易ID（可选） */
+    transactionId?: string;
+}
+interface PurchaseSuccessModalOptions {
+    /** 购买成功数据 */
+    data: PurchaseSuccessData;
+    /** 语言，默认 'en' */
+    language?: 'en' | 'zh-CN';
+    /** 关闭回调 */
+    onClose?: () => void;
+}
+/**
+ * 购买成功弹窗类
+ */
+declare class PurchaseSuccessModal {
+    private overlay;
+    private modal;
+    private options;
+    private isExiting;
+    private scrollY;
+    private boundHandleEscKey;
+    constructor(options: PurchaseSuccessModalOptions);
+    /**
+     * 打开弹窗
+     */
+    open(): void;
+    /**
+     * 关闭弹窗
+     */
+    close(): void;
+    /**
+     * 创建弹窗元素
+     */
+    private createModal;
+    /**
+     * 生成弹窗 HTML
+     */
+    private getModalHTML;
+    /**
+     * 添加 CSS 动画
+     */
+    private addStyles;
+    /**
+     * 添加事件监听
+     */
+    private attachEventListeners;
+    /**
+     * 处理 ESC 键
+     */
+    private handleEscKey;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * HTML 转义工具函数
+     * 防止 XSS 攻击
+     */
+    private escapeHtml;
+    /**
+     * 检查弹窗是否打开
+     */
+    isOpen(): boolean;
+}
+
+/**
+ * Payment Storage
+ * 支付数据存储 - 统一管理 localStorage 操作
+ */
+/**
+ * 交易存储数据结构
+ */
+interface TransactionStorageData {
+    /** 交易 ID */
+    transactionId: string;
+    /** 订单 ID */
+    orderId: string;
+    /** 创建时间（毫秒时间戳） */
+    createdAt: number;
+    /** 过期时间（毫秒时间戳） */
+    expiresAt: number;
+}
+declare class PaymentStorage {
+    private static readonly KEY;
+    /**
+     * 保存交易数据
+     */
+    static saveTransaction(data: {
+        transactionId: string;
+        orderId: string;
+        expiresIn: number;
+    }): void;
+    /**
+     * 获取交易数据
+     */
+    static getTransaction(): TransactionStorageData | null;
+    /**
+     * 清除交易数据
+     */
+    static clearTransaction(): void;
+}
+
+/**
+ * Error Handler
+ * 错误处理器 - 标准化错误和友好提示
+ */
+/**
+ * 支付错误类
+ */
+declare class PaymentError extends Error {
+    code: number;
+    bizCode: number | undefined;
+    constructor(code: number, bizCode: number | undefined, message: string);
+}
+declare class ErrorHandler {
+    /**
+     * 标准化错误
+     */
+    static normalize(error: any): PaymentError;
+    /**
+     * 根据错误码获取友好提示
+     */
+    static getFriendlyMessage(error: PaymentError): string;
+}
+
+/**
+ * Script Loader
+ * 动态加载 SeaartPaymentComponent SDK 脚本
+ */
+interface ScriptLoaderOptions {
+    scriptUrl: string;
+    timeout?: number;
+}
+declare class ScriptLoader {
+    private static loadedScripts;
+    /**
+     * 动态加载 SeaartPaymentComponent SDK
+     */
+    static loadSeaartPaymentComponent(options: ScriptLoaderOptions): Promise<void>;
+    /**
+     * 等待 window.SeaartPaymentComponent 可用
+     */
+    private static waitForSeaartPaymentComponent;
+    /**
+     * 清除已加载的脚本记录（测试用）
+     */
+    static clearLoadedScripts(): void;
+}
+/**
+ * Stylesheet Loader
+ * 动态加载 CSS 样式表
+ */
+declare class StylesheetLoader {
+    /**
+     * 已加载的样式表 URL 缓存
+     */
+    private static loadedStylesheets;
+    /**
+     * 加载支付组件样式表
+     * @param url CSS 文件 URL
+     * @returns Promise<void>
+     */
+    static loadPaymentStylesheet(url: string): Promise<void>;
+    /**
+     * 清除缓存（用于测试）
+     */
+    static clearCache(): void;
+}
+
+/**
+ * Subscription API
+ * 订阅管理 - 查询、变更、重启订阅
+ */
+/**
+ * 当前订阅状态
+ */
+interface CurrentSubscription {
+    subscription_id: string;
+    product_id: string;
+    tier: string;
+    billing_period: 'month' | 'year';
+    status: string;
+    cancel_at_period_end: boolean;
+    current_period_end: number;
+}
+/**
+ * 活跃订阅详情
+ */
+interface ActiveSubscription {
+    subscription_id: string;
+    tier: number;
+    billing_period: 'month' | 'year';
+    price: string;
+    currency: string;
+    current_period_start: number;
+    next_billing_date: number;
+    status: string;
+    cancel_at_period_end: boolean;
+    can_cancel: boolean;
+}
+/**
+ * 统一响应格式
+ */
+interface UnifiedResponse<T = any> {
+    code: number;
+    msg: string;
+    data: T | null;
+}
+/**
+ * 创建订单响应
+ */
+interface CreateOrderResponse {
+    /** 订单 ID */
+    order_id: string;
+    /** 交易 ID */
+    transaction_id: string;
+    /** 价格 */
+    price: string;
+    /** 货币代码 */
+    currency: string;
+    /** 重定向 URL */
+    redirect_url: string;
+    /** SDK 配置 */
+    sdk_config: SdkConfig;
+}
+/**
+ * SDK 配置
+ */
+interface SdkConfig {
+    /** 应用 ID */
+    app_id: string;
+    /** API 域名 */
+    api_host: string;
+    /** 环境 */
+    environment: string;
+}
+/**
+ * 获取当前订阅状态（用于升降级判断）
+ */
+declare function getCurrentSubscription(apiHost: string, authToken?: string, signal?: AbortSignal): Promise<CurrentSubscription | null>;
+/**
+  * 创建订单
+  * @param apiHost 接口域名
+  * @param authToken 认证令牌
+  * @param params 创建订单参数
+  * @param product_id 产品ID
+  * @param purchase_type 购买类型（1=一次性, 2=订阅）
+  * @returns 创建订单响应
+  */
+declare function createOrder(apiHost: string, authToken: string, params: {
+    product_id: string;
+    purchase_type: number | string;
+}): Promise<CreateOrderResponse | null | undefined>;
+/**
+ * 获取活跃订阅详情
+ */
+declare function getActiveSubscription(apiHost: string, authToken?: string): Promise<ActiveSubscription | null>;
+/**
+ * 升降级订阅
+ */
+declare function changeSubscription(apiHost: string, authToken: string | undefined, params: {
+    productId: string;
+    billingPeriod: 'month' | 'year';
+    redirectUrl: string;
+}): Promise<{
+    transaction_id: string;
+    price: string;
+    order_id: string;
+    currency: string;
+}>;
+/**
+ * 重新启动订阅
+ * 用于已取消但仍在有效期内的订阅，重新恢复自动续费
+ */
+declare function restartSubscription(apiHost: string, authToken: string | undefined, params: {
+    subscriptionId: string;
+}): Promise<{
+    success: boolean;
+    message: string;
+    next_billing_date: number;
+}>;
+/**
+ * 积分池类型
+ */
+type CreditPoolType = 'daily' | 'event' | 'monthly' | 'permanent';
+/**
+ * 积分池详情
+ */
+interface CreditPool {
+    /** 积分池类型 */
+    type: CreditPoolType;
+    /** 该池余额（字符串格式，保留精度） */
+    balance: string;
+    /** 过期时间戳（毫秒，0 表示永不过期） */
+    expires_at: number;
+}
+/**
+ * 积分详情响应
+ */
+interface CreditDetailResponse {
+    /** 总余额（字符串格式，保留精度） */
+    total_balance: string;
+    /** 用户等级 */
+    tier?: string;
+    /** 积分池数组（仅包含余额 > 0 的池） */
+    pools: CreditPool[];
+}
+/**
+ * 获取积分详情
+ * @param apiHost 接口域名（如 https://wallet.sg.seaverse.dev）
+ * @param authToken 认证令牌
+ * @returns 积分详情
+ */
+declare function getCreditDetail(apiHost: string, authToken?: string): Promise<CreditDetailResponse | null>;
+
+/**
+ * Order API
+ * 订单管理 - 查询和轮询订单状态
+ */
+/**
+ * 订单状态
+ */
+type OrderStatus = 'pending' | 'paid' | 'failed' | 'expired' | 'refunded';
+/**
+ * 订单状态响应
+ */
+interface OrderStatusResponse {
+    status: OrderStatus;
+}
+/**
+ * 查询订单状态
+ * @param transactionId SDK checkout 返回的 transaction_id
+ * @param apiHost Payment API 地址
+ * @param authToken 认证 Token
+ * @returns 订单状态
+ */
+declare function checkOrderStatus(transactionId: string, apiHost: string, authToken?: string): Promise<OrderStatus>;
+/**
+ * 轮询订单状态直到支付完成或超时
+ * @param transactionId SDK checkout 返回的 transaction_id
+ * @param apiHost Payment API 地址
+ * @param authToken 认证 Token
+ * @param options 轮询配置
+ * @returns 最终订单状态
+ */
+declare function pollOrderStatus(transactionId: string, apiHost: string, authToken: string | undefined, options?: {
+    /** 轮询间隔（毫秒），默认 2000ms */
+    interval?: number;
+    /** 最大轮询次数，默认 30 次（总计 60 秒） */
+    maxAttempts?: number;
+    /** 每次轮询后的回调 */
+    onPoll?: (status: OrderStatus, attempt: number) => void;
+}): Promise<OrderStatus>;
+
 /**
  * @seaverse/payment-sdk
  *
@@ -1077,7 +2450,7 @@ declare const BIZ_CODE: {
 /**
  * SDK version
  */
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.0";
 
-export { API_ENDPOINTS, BIZ_CODE, COMPONENT_LOAD_TIMEOUT, CheckoutAPI, DEFAULT_CHECKOUT_CONFIG, ENV_CONFIG, HTTP_STATUS, PAYMENT_ELEMENT_NAME, PaymentAPIError, PaymentCheckoutClient, PaymentClient, SeaArtPayLoader, VERSION, centsToDollars, createCheckoutPaymentError, delay, dollarsToCents, formatPrice, generateOrderReference, getCurrentUrl, getGlobalLoader, getSDKLocale, isBrowser, isCheckoutPaymentError, resetGlobalLoader, safeJsonParse, withTimeout };
-export type { ApiErrorResponse, ApiResponse, ApiSuccessResponse, BaseCheckoutOptions, BillingPeriod, CheckoutAPIConfig, CheckoutAPIResponse, CheckoutClientConfig, CheckoutClientStatus, CheckoutOptions, CheckoutPaymentError, CheckoutPaymentErrorCode, CheckoutResult, ComponentLoadStatus, CreditAccount, CreditAccountStatus, CreditDetailResponse, CreditDetailSuccessResponse, CreditPoolDetail, CreditPoolType, CreditTransaction, ListTransactionsRequest, LoaderConfig, PaymentClientOptions, PaymentEnvironment, PaymentReadyEventDetail, PaymentResult, PaymentSuccessEventDetail, PaymentUnsuccessEventDetail, PaymentUnsuccessResult, PurchaseType, SDKCheckoutRequest, SDKCheckoutResponse, SDKConfig, SDKLoadStatus, SeaArtPaymentElement, ShowPaymentOptions, SubscribeOptions, SubscriptionParams, SubscriptionPeriod, TransactionListResponse, TransactionStatus, TransactionType };
+export { API_ENDPOINTS, BIZ_CODE, BindCardPaymentComponent, COMPONENT_LOAD_TIMEOUT, CREATIVE_POWER_TYPES, CREDIT_PACKAGES, CheckoutAPI, CreditPackageModal, DEFAULT_CHECKOUT_CONFIG, DropinPaymentComponent, DropinPaymentModal, ENVIRONMENT_CONFIGS, ENV_CONFIG, ErrorHandler, GRID_COLUMNS, GenericPackageModal, HTTP_STATUS, LinkPaymentComponent, OrderPayment, PAYMENT_ELEMENT_NAME, PaymentAPIError, PaymentCheckoutClient, PaymentClient, PaymentError, PaymentModal, PaymentStorage, PurchaseSuccessModal, RESPONSIVE_BREAKPOINTS, SDK_CONFIG, ScriptLoader, SeaArtPayLoader, SeaartPaymentSDK, StylesheetLoader, VERSION, centsToDollars, changeSubscription, checkOrderStatus, createCheckoutPaymentError, createOrder, delay, dollarsToCents, formatPrice, generateOrderReference, getActiveSubscription, getCreditDetail, getCurrentSubscription, getCurrentUrl, getGlobalLoader, getSDKLocale, hideLoadingIndicator, isBrowser, isCheckoutPaymentError, pollOrderStatus, resetGlobalLoader, restartSubscription, safeJsonParse, showErrorMessage, showInfoMessage, showLoadingIndicator, showSuccessMessage, withTimeout };
+export type { ActiveSubscription, ApiErrorResponse, ApiResponse, ApiSuccessResponse, BaseCheckoutOptions, BillingPeriod, BindCard, BindCardCallbacks, BindCardPaymentOptions, CheckoutAPIConfig, CheckoutAPIResponse, CheckoutClientConfig, CheckoutClientStatus, CheckoutOptions, CheckoutPaymentError, CheckoutPaymentErrorCode, CheckoutResult, ComponentLoadStatus, CreateOrderResponse, CreativePowerType, CreditAccount, CreditAccountStatus, CreditDetailResponse$1 as CreditDetailResponse, CreditDetailSuccessResponse, CreditPackage, CreditPackageModalOptions, CreditPoolDetail, CreditPoolType$1 as CreditPoolType, CreditTransaction, CurrentSubscription, DropinCallbacks, DropinPaymentModalOptions, DropinPaymentOptions, Environment, EnvironmentConfig, GenericPackage, GenericPackageModalOptions, LinkPaymentOptions, ListTransactionsRequest, LoaderConfig, OrderInfo, OrderStatus, OrderStatusResponse, PaymentClientOptions, PaymentEnvironment, PaymentMethod, PaymentMethodsParams, PaymentModalOptions, PaymentReadyEventDetail, PaymentResult, PaymentSDKConfig, PaymentSuccessEventDetail, PaymentUnsuccessEventDetail, PaymentUnsuccessResult, PurchaseSuccessData, PurchaseSuccessModalOptions, PurchaseType, SDKCheckoutRequest, SDKCheckoutResponse, SDKConfig, SDKLoadStatus, ScriptLoaderOptions, SeaArtPaymentElement, SeaartBindCardPayment, SeaartDropinPayment, SeaartLinkPayment, SeaartPaymentComponentSDK, SeaartPaymentInstance, SeaartPaymentSDKConfig, ShowPaymentOptions, SubscribeOptions, SubscriptionParams, SubscriptionPeriod, TransactionListResponse, TransactionStatus, TransactionStorageData, TransactionType, UnifiedResponse };