@alipay/ams-checkout 2.0.28 → 2.0.30

package/esm/modern/util/upgrade.d.ts

@@ -0,0 +1,39 @@
+export declare function isWebPlatform(platform?: string): boolean;
+export interface UpgradeItem {
+    productScene?: string;
+    v: string;
+    appVersion: string;
+    platform?: string;
+    mid?: string;
+    greyscale?: string;
+}
+export interface UpgradeSdkInfo {
+    productScene?: string;
+    sdkVersion: string;
+    appVersion?: string;
+    greyscale?: number;
+    mid?: string;
+}
+export declare function findUpgradeVersion(upgradeItems: UpgradeItem[], sdkInfo: UpgradeSdkInfo): string;
+export declare const getGrascaleId: (key?: string) => string;
+export declare function getGrayscaleValue(seed?: string): number;
+export declare function isGreyscaleMatch(item: UpgradeItem, randomGreyscale: number): boolean;
+/**
+ * 查询匹配到的版本
+ * @param _extendInfo
+ * @param param1
+ * @returns
+ */
+export declare const getMatchAppVersion: (_extendInfo: string, sdkInfo: UpgradeSdkInfo) => string;
+/**
+ * 获取保存的加载版本
+ * @param versionKey
+ * @returns
+ */
+export declare const getLastAppVersion: (versionKey: string) => string;
+/**
+ * 保存指定场景的加载版本供下次使用
+ * @param versionKey
+ * @returns
+ */
+export declare const setLastAppVersion: (versionKey: string, appVersion: string) => boolean;

package/esm/modern/util/versionCompare.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 返回值0标识一样大，1表示v1大，-1表示v2大
+ * @param v1
+ * @param v2
+ */
+export declare function compareVersion(v1: string, v2: string): 0 | 1 | -1;
+/**
+ * 判断version版本是否在range参数版本的范围内
+ * @param version
+ * @param range
+ * @returns
+ */
+export declare function isVersionInStringRange(version: string, range: string): boolean;
+export declare function isVersionInRange(currentVersion: any, minVersion: any, maxVersion: any): boolean;
+export declare function matchVersion(config: any, currentVersion: any): boolean;

package/esm/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.59.1"
+      "packageVersion": "7.59.4"
     }
   ]
 }

package/esm/types/index.d.ts

@@ -807,6 +807,12 @@ export interface IPaymentMethod {
     category?: string;
     paymentElements?: IPaymentElement[];
     paymentMethodId?: string;
+    /** Token 支付模式；缺失或 null 表示不支持 */
+    supportTokenizedMode?: 'EASYSAFEPAY' | 'TOKENIZEDPAY' | null;
+    /** Token 状态 */
+    paymentMethodIdStatus?: 'ACTIVE' | 'INACTIVE' | null;
+    /** 脱敏后的渠道账号 */
+    userLoginId?: string;
     paymentMethodDetail?: {
         last4?: string;
         requireIssuerAuthentication?: string;

package/esm/util/logger.js

@@ -296,6 +296,6 @@ export var LogConfig = {
   version: 'iteration/20231021',
   mdata: {
     firstLogTime: Date.now(),
-    sdkVersion: "2.0.28"
+    sdkVersion: "2.0.30"
   }
 };

package/esm/util/timezone.d.ts

@@ -0,0 +1 @@
+export declare const getIdengineTimezone: () => string;

package/esm/util/timezone.js

@@ -0,0 +1,8 @@
+export var getIdengineTimezone = function getIdengineTimezone() {
+  var offsetMinutes = -new Date().getTimezoneOffset();
+  var sign = offsetMinutes >= 0 ? '+' : '-';
+  var absoluteMinutes = Math.abs(offsetMinutes);
+  var hours = Math.floor(absoluteMinutes / 60);
+  var minutes = absoluteMinutes % 60;
+  return "UTC".concat(sign).concat(hours).concat(minutes ? ":".concat(String(minutes).padStart(2, '0')) : '');
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "2.0.28",
+  "version": "2.0.30",
   "description": "",
   "author": "",
   "exports": {
@@ -89,6 +89,7 @@
     ]
   },
   "dependencies": {
+    "@antintl/opensdk-preload": "^1.0.0",
     "axios": "^1.3.4",
     "proxy-polyfill": "^0.3.2",
     "uuid": "^9.0.0"

package/types.d.ts

@@ -203,14 +203,23 @@ export declare type AntomLayouts = 'tabs' | 'accordion';
 
 /* Excluded from this release type: AntomOpenModalConfig */
 
+export declare interface AntomPreloadConfig {
+    /** Elements2 types the merchant expects to create after loading the SDK. */
+    elements: AntomPreloadElement[];
+}
+
+export declare type AntomPreloadElement = 'payment' | 'express' | 'vaulting' | 'CVV';
+
 /**
  * @description The Antom main class, all uses are based on this class instance
  */
 export declare class AntomSDK extends BaseElementsFactory {
     static version: string;
     private stopModalMessageMonitor;
+    private readonly apiTracker;
     constructor(config?: AntomSDKConfig);
     protected canUseElements(): Array<ElementListItemType>;
+    init(): Promise<this>;
     /**
      * @description 更新配置
      */
@@ -223,17 +232,34 @@ export declare class AntomSDK extends BaseElementsFactory {
     createElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
     createElement(elementType: 'CVV', options: CVVAppConfig): CVVElement;
     createElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
+    createElement(elementType: 'expressVaulting', options?: ExpressVaultingAppConfig): ExpressVaultingElement;
     getElement(elementType: 'payment', options?: PaymentAppConfig): PaymentElement;
     getElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
     getElement(elementType: 'CVV', options?: CVVAppConfig): CVVElement;
     getElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
+    getElement(elementType: 'expressVaulting', options?: ExpressVaultingAppConfig): ExpressVaultingElement;
     /**
      * 从 elements 容器或直接传入的 MainElement 中提取指定类型的主元素
      * @throws {AntomSDKError} 当无法找到有效的主元素时抛出错误
      */
     private extractMainElement;
     confirmCardSetup(options: ConfirmCardSetupOptions): Promise<SubmitResult>;
+    private runConfirmCardSetup;
     confirmPayment(options: ConfirmPaymentOptions): Promise<SubmitResult>;
+    private runConfirmPayment;
+    /**
+     * 触发 Express Vaulting element 的 PayPal 绑卡提交流程。
+     *
+     * iframe 收到 OPENSDK@CONFIRM_VAULTING 后执行 submitPay + 单次 inquiry 兜底，
+     * 完成后通过 OPENSDK@CONFIRM_VAULTING_RESULT 回包，Promise resolve。
+     *
+     * @param options.elements 已挂载的 ExpressVaultingElement 或包含它的 Elements 实例
+     * @param options.redirect 跳转策略，默认 'always'，透传给 iframe
+     */
+    confirmVaulting(options: {
+        elements: BaseMainElement | BaseElements;
+        redirect?: 'always' | 'if_required';
+    }): Promise<ExpressVaultingResult>;
 }
 
 /**
@@ -328,8 +354,8 @@ export declare const AntomSDKErrorCodes: {
     readonly ELEMENT_DEFINE_ERROR: "ELEMENT_DEFINE_ERROR";
     readonly ELEMENT_ALREADY_REGISTERED: "ELEMENT_ALREADY_REGISTERED";
     readonly CANNOT_CREATE_SAME_ELEMENT_TWICE: "CANNOT_CREATE_SAME_ELEMENT_TWICE";
-    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT"; /** @deprecated 传入 elements 时无需重复传递，且不会覆盖 Element 的会话。 */
-    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT"; /** 无 UI 模式必填，仅用于创建内部 CVVElement。 */
+    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT";
+    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT";
     readonly NOT_SUPPORT_ELEMENT: "NOT_SUPPORT_ELEMENT";
     readonly NOT_SUPPORT_SUBMIT: "NOT_SUPPORT_SUBMIT";
     readonly UPDATE_CONFIG_TIMEOUT: "UPDATE_CONFIG_TIMEOUT";
@@ -2312,6 +2338,7 @@ export declare interface CVVAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: renderData */
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
+    /* Excluded from this release type: preloadTelemetryContext */
     /**
      * @description 语言配置
      */
@@ -2334,10 +2361,17 @@ export declare type CVVAppearanceProps = {
 export declare class CVVElement extends BaseMainElement<CVVElementConfig, CVVElementEvents> {
     static elementType: string;
     private readonly sessionData;
+    private readonly elementTracker;
+    private _mountInProgress;
+    private _destroyInProgress;
     constructor(name: string, config: CVVElementConfig);
     /* Excluded from this release type: setup */
     /* Excluded from this release type: updateConfig */
     /* Excluded from this release type: submit */
+    mount(container: HTMLElement): Promise<void>;
+    on<T extends keyof CVVElementEvents>(event: T, handler: (payload: CVVElementEvents[T]) => void): void;
+    unmount(): void;
+    destroy(): void;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;
@@ -3078,8 +3112,12 @@ declare interface ElementPluginChangeStates {
 declare type ElementPluginNameEnum = 'SET_STATE' | 'PASSIVE_SET_STATE';
 
 declare class Elements extends BaseElements {
+    private readonly apiTracker;
     protected canUseElements(): Array<ElementListItemType>;
     constructor(config: BaseElementsConfig);
+    init(): Promise<this>;
+    updateConfig(config: Partial<BaseElementsConfig>): void;
+    destroy(): void;
     createElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
     createElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
     getElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
@@ -3257,6 +3295,7 @@ export declare interface ExpressAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: setupError */
     /* Excluded from this release type: locale */
     /* Excluded from this release type: _paypalSdkEnvironment */
+    /* Excluded from this release type: preloadTelemetryContext */
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -3288,6 +3327,17 @@ export declare interface ExpressClickEvent {
     expressPaymentType: string;
 }
 
+declare type ExpressCompletePaymentResult = {
+    success: boolean;
+    result?: any;
+    error?: {
+        code: string;
+        message: string;
+    };
+    userCanceled3D?: boolean;
+    status?: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
+};
+
 /** confirm 事件负载（统一终态，替代 approve） */
 export declare interface ExpressConfirmData {
     expressPaymentType: string;
@@ -3334,6 +3384,10 @@ export declare interface ExpressConfirmData {
  */
 export declare class ExpressElement extends BaseMainElement<ExpressElementConfig, ExpressElementEvents> {
     static elementType: string;
+    private readonly elementTracker;
+    private _mountInProgress;
+    private _destroyInProgress;
+    private _registeringInternalListeners;
     /**
      * Store all function-type callbacks locally, not involved in postMessage serialization
      */
@@ -3352,6 +3406,12 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _localHandlers;
     /** 支付流程进行中标志（click → confirm/error/cancel 之间） */
     private _paymentInProgress;
+    /**
+     * confirm 窗口超时标志：iframe 在 20s onTimeout 发 error(MERCHANT_CONFIRM_TIMEOUT) 时置位，
+     * completePayment 入口据此立即返失败（不发 COMPLETE_PAYMENT，不进 5min 兜底）。
+     * 每新一轮 confirm 事件到达时复位（见 on() 重写）。
+     */
+    private _confirmWindowTimedOut;
     /**
      * 是否已收到 iframe 业务层 ready 事件（app.tsx sendReady）。
      * 注意：与 host `status='ready'`（由 HANDSHAKE_ACK 触发，bridge.js:450 同步回发，与 amount 解析无关）不同。
@@ -3374,6 +3434,7 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
      */
     private _emit;
     updateConfig(newConfig: ExpressAppConfig): Promise<ExpressElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    private runUpdateConfig;
     private updateConfigTransaction;
     private updateAmountConfigWithSanitizedDebug;
     private getAmountValidationReason;
@@ -3389,19 +3450,13 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
      * iframe 收到 OPENSDK@COMPLETE_PAYMENT 后执行 submitPay / polling 等，
      * 完成后通过 OPENSDK@COMPLETE_PAYMENT_RESULT 回包，Promise resolve。
      */
-    completePayment(redirect?: 'always' | 'if_required'): Promise<{
-        success: boolean;
-        result?: any;
-        error?: {
-            code: string;
-            message: string;
-        };
-        /** 用户是否手动关闭 3D 弹窗（透传 webapp COMPLETE_PAYMENT_RESULT.userCanceled3D） */
-        userCanceled3D?: boolean;
-        status?: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
-    }>;
+    completePayment(redirect?: 'always' | 'if_required'): Promise<ExpressCompletePaymentResult>;
+    private runCompletePayment;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
+    mount(container: HTMLElement): Promise<void>;
+    unmount(): void;
+    destroy(): void;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;
@@ -3510,6 +3565,184 @@ declare type ExpressSetupError = ErrorPayload & {
     mulityLanguageMapping?: boolean;
 };
 
+/**
+ * @public
+ * @description Express Vaulting element app config type
+ */
+export declare interface ExpressVaultingAppConfig extends BaseElementAppConfig {
+    /**
+     * @description payment sessionData，无法通过 updateConfig 更新
+     */
+    sessionData?: string;
+    /**
+     * @description 开通的支付方式列表，本期固定为 ['PAYPAL_DIRECTDEBIT']
+     */
+    paymentMethods?: string[];
+    /** PayPal 按钮配置 */
+    paypal?: ExpressVaultingPayPalConfig;
+    /** PayPal 按钮文案类型 */
+    buttonType?: {
+        paypal?: 'paypal' | 'checkout' | 'buynow' | 'pay';
+    };
+    /** 按钮统一高度（px） */
+    buttonHeight?: number;
+    /** PayPal 按钮主题色 */
+    buttonTheme?: {
+        paypal?: 'gold' | 'blue' | 'silver' | 'white' | 'black';
+    };
+}
+
+/**
+ * @public
+ * @description cancel 事件负载
+ */
+export declare interface ExpressVaultingCancelEvent {
+    paymentMethodType: ExpressVaultingMethod;
+    data?: unknown;
+}
+
+/**
+ * @public
+ * @description click 事件负载
+ */
+export declare interface ExpressVaultingClickEvent {
+    paymentMethodType: ExpressVaultingMethod;
+}
+
+/**
+ * @public
+ * @description confirm 事件负载（PayPal onApprove 成功后触发，商户可在回调中调 confirmVaulting）
+ */
+export declare interface ExpressVaultingConfirmEvent {
+    paymentMethodType: ExpressVaultingMethod;
+    payerInfo?: ExpressVaultingPayerInfo;
+}
+
+/**
+ * @public
+ * @description Express Vaulting element - PayPal 绑卡 Element
+ *
+ * Host 侧只保留 Element 生命周期与 bridge 连接；PayPal 按钮渲染、Braintree SDK
+ * 加载、submit/inquiry 都由 express_vaulting webapp 承接。
+ *
+ * setup 阶段调 sdkActionQuery 拿 paypalClientToken，握手时下发给 iframe（系分
+ * 4.1 节 BR-007：client token 必须来自握手，iframe 不自调 sdkActionQuery）。
+ */
+export declare class ExpressVaultingElement extends BaseMainElement<ExpressVaultingElementConfig, ExpressVaultingElementEvents> {
+    static elementType: string;
+    /**
+     * Host-side fullscreen overlay shown while the PayPal popup is open.
+     *
+     * PayPal Braintree vault flow renders its own popup + backdrop inside the
+     * iframe body, so without a host overlay the backdrop only masks the tiny
+     * button area. Mirrors ExpressElement: show on `click`, hide on
+     * `confirm` / `cancel` / `error`.
+     */
+    private _paypalOverlay;
+    constructor(name: string, config: ExpressVaultingElementConfig);
+    /* Excluded from this release type: setup */
+    /* Excluded from this release type: registerInternalListeners */
+    protected focus(): void;
+    protected blur(): void;
+    protected clear(): void;
+    /* Excluded from this release type: _confirmVaulting */
+}
+
+/**
+ * @public
+ * @description Express Vaulting element config type
+ */
+export declare interface ExpressVaultingElementConfig extends BaseElementConfig<ExpressVaultingAppConfig> {
+}
+
+/**
+ * @public
+ * @description Express Vaulting element 事件类型
+ */
+export declare interface ExpressVaultingElementEvents extends AntomBridgeWithNativeEventMap<ExpressVaultingAppConfig> {
+    ready: ExpressVaultingReadyEvent;
+    click: ExpressVaultingClickEvent;
+    confirm: ExpressVaultingConfirmEvent;
+    cancel: ExpressVaultingCancelEvent;
+    error: ExpressVaultingErrorEvent;
+    'OPENSDK@CONFIRM_VAULTING': {
+        requestId: string;
+        redirect?: 'always' | 'if_required';
+    };
+    'OPENSDK@CONFIRM_VAULTING_RESULT': {
+        requestId: string;
+        result: ExpressVaultingResult;
+    };
+}
+
+/**
+ * @public
+ * @description error 事件负载
+ */
+export declare interface ExpressVaultingErrorEvent extends ErrorPayload<string> {
+    paymentMethodType: ExpressVaultingMethod;
+}
+
+/**
+ * Supported express vaulting payment methods. All bridge event payloads carry
+ * `paymentMethodType` — use this enum instead of硬编码 strings so adding a
+ * new wallet only needs one entry here. Must match the iframe-side enum in
+ * elements2/express_vaulting/interface.ts.
+ */
+declare enum ExpressVaultingMethod {
+    PAYPAL_DIRECTDEBIT = "PAYPAL_DIRECTDEBIT"
+}
+
+/**
+ * @public
+ * @description Braintree tokenizePayment 返回的 payer 信息，随 confirm 事件透传给商户
+ */
+export declare interface ExpressVaultingPayerInfo {
+    payerId?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    countryCode?: string;
+    phone?: string;
+}
+
+/**
+ * MERCHANT_CONFIRM_TIMEOUT is owned by the iframe side (mirrors express_element:
+ * iframe starts a 20s timer on the `confirm` event and sends
+ * `error(MERCHANT_CONFIRM_TIMEOUT)` if the merchant never calls confirmVaulting).
+ * See elements2/express_vaulting/app.tsx + tools/error.ts.
+ */
+/**
+ * @public
+ * @description PayPal 按钮配置
+ */
+export declare interface ExpressVaultingPayPalConfig {
+    /** 按钮形状 */
+    buttonShape?: 'pill' | 'rect' | 'sharp';
+}
+
+/**
+ * @public
+ * @description ready 事件负载
+ */
+export declare interface ExpressVaultingReadyEvent {
+    availablePaymentMethods: Partial<Record<ExpressVaultingMethod, boolean>>;
+}
+
+/**
+ * @public
+ * @description confirmVaulting 返回结果
+ */
+export declare interface ExpressVaultingResult {
+    status: 'SUCCESS' | 'PROCESSING' | 'FAIL' | 'CANCELLED';
+    paymentMethodId?: string;
+    payerId?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+
 declare interface ExpSupportBank {
     /**
      * @description 银行名称
@@ -4569,6 +4802,8 @@ export declare interface LoadAntomConfig extends Omit<BaseFactoryConfig, 'tracke
      * @description 环境配置，默认为prod
      */
     env?: 'sandbox' | 'prod';
+    /** Starts best-effort Elements2 resource preload without delaying loadAntom. */
+    preload?: AntomPreloadConfig;
 }
 
 /**
@@ -7144,6 +7379,7 @@ export declare interface PaymentAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
     /* Excluded from this release type: logMetaData */
+    /* Excluded from this release type: preloadTelemetryContext */
     /* Excluded from this release type: heightOfVisible */
     /**
      * Amount & Currency
@@ -7178,14 +7414,23 @@ export declare type PaymentAppearanceProps = {
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
     private _paymentInProgress;
+    private readonly paymentTracker;
+    private _mountStartedAt;
+    private _mountInProgress;
+    private _mountPhase;
+    private _destroyInProgress;
     private readonly walletLogger;
     constructor(name: string, config: PaymentElementConfig);
     /* Excluded from this release type: setup */
+    mount(container: HTMLElement): Promise<void>;
     /**
      * @description Update payment element configuration with amount validation and appearance Rules support
      */
     updateConfig(newConfig: Partial<PaymentAppConfig>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /* Excluded from this release type: submit */
+    on<T extends keyof PaymentElementEvents>(event: T, handler: (payload: PaymentElementEvents[T]) => void): void;
+    unmount(): void;
+    destroy(): void;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;
@@ -7215,6 +7460,11 @@ export declare interface PaymentElementEvents extends AntomBridgeWithNativeEvent
     'OPENSDK@GET_GOOGLE_PAY_TOKEN': GetGooglePayTokenRequest;
     /** host 完成 Google Pay token 获取后回包给 webapp */
     'OPENSDK@GET_GOOGLE_PAY_TOKEN_REPLY': GetGooglePayTokenReply;
+    /** WebApp notifies the host when the selected payment method changes. */
+    paymentMethodChanged: {
+        type: string;
+        name?: string;
+    };
 }
 
 declare interface PaymentElementView {
@@ -7564,6 +7814,33 @@ declare interface PaymentMethodView {
      * @description 分期银行信息列表
      */
     supportIppBankList?: FrontSupportIppBank[];
+    /**
+     * @description consult 是否打标该支付方式支持代扣(tokenPay)。
+     *
+     * <p>来源 iexpprod {@code PaymentOption.supportTokenPay}(Boolean, 默认 false), 仅当 iexpfront 显式传
+     * {@code PaymentFactor.markSupportTokenPay=true} 时 iexpprod 才会打标。 sdkQuery 内部流转字段。
+     */
+    supportTokenPay?: boolean;
+    /**
+     * @description tokenized 模式, 取值 EASYSAFEPAY / TOKENIZEDPAY；null 或缺失表示不支持。
+     *
+     * <p>sdkQuery 响应下发, submitPayByPaymentSession 由 SDK 原值回传; 服务端不信任前端回传值, 必须与会话上下文比对。
+     */
+    supportTokenizedMode?: 'EASYSAFEPAY' | 'TOKENIZEDPAY' | null;
+    /**
+     * @description 用户是否选择开启 token 支付(首次支付/授权场景的入口标识)。
+     *
+     * <p>submitPayByPaymentSession 请求入参, 由前端上报。
+     */
+    enableTokenPay?: boolean;
+    /**
+     * @description token(accessToken) 状态, 取值 ACTIVE / INACTIVE, 对齐 iexpprod facade {@code
+     * AlipayAccessTokenStatusEnum}。
+     *
+     * <p>sdkQuery 响应下发, 取 {@code PaymentMethodTokenDetail.alipayAccessTokenStatus}; 首次支付(无
+     * tokenDetail)不下发。
+     */
+    paymentMethodIdStatus?: 'ACTIVE' | 'INACTIVE' | null;
 }
 
 declare interface PaymentOption {
@@ -7687,6 +7964,14 @@ declare interface PaymentOption {
      * @description 支付支持的交互方式
      */
     interactionTypes?: string[];
+    /**
+     * @description 支付方式是否支持代扣(token pay)
+     * <p>
+     * 仅当请求侧 PaymentFactor.markSupportTokenPay=true 时才可能被置为 true;
+     * 默认 false, 未打标时与现状完全一致, 向后兼容。
+     * @default false
+     */
+    supportTokenPay?: boolean;
 }
 
 declare interface PaymentQuoteInfo {
@@ -7978,6 +8263,8 @@ declare interface PollingSetting {
     pollingTimes?: string;
 }
 
+/* Excluded from this release type: PreloadTelemetryContext */
+
 declare interface PromotionDetail {
     /**
      * @description promotion amount for mobile view
@@ -24644,6 +24931,7 @@ export declare interface VaultingAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: renderDataError */
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
+    /* Excluded from this release type: preloadTelemetryContext */
 }
 
 export declare type VaultingAppearance = PickAntomAppearance<VaultingAppearanceProps>;
@@ -24661,6 +24949,9 @@ export declare type VaultingAppearanceProps = {
  */
 export declare class VaultingElement extends BaseMainElement<VaultingElementConfig, VaultingElementEvents> {
     static elementType: string;
+    private readonly elementTracker;
+    private _mountInProgress;
+    private _destroyInProgress;
     constructor(name: string, config: VaultingElementConfig);
     /* Excluded from this release type: setup */
     /**
@@ -24670,6 +24961,10 @@ export declare class VaultingElement extends BaseMainElement<VaultingElementConf
      */
     updateConfig(newConfig: Partial<VaultingAppConfig>): Promise<VaultingElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /* Excluded from this release type: submit */
+    mount(container: HTMLElement): Promise<void>;
+    on<T extends keyof VaultingElementEvents>(event: T, handler: (payload: VaultingElementEvents[T]) => void): void;
+    unmount(): void;
+    destroy(): void;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;