@alipay/ams-checkout 0.0.1783663570-dev.4 → 0.0.1783663570-dev.6

package/types.d.ts

@@ -143,7 +143,26 @@ declare interface AmountLimitInfo {
 /**
  * AntomBridge事件类型，包含了SDK与webapp通信的所有事件类型
  */
-export declare interface AntomBridgeEventMap<AppConfig extends Record<string, any> = Record<string, any>, SubmitParams extends Record<string, any> = Record<string, any>> extends BaseBridgeEventMap<AppConfig, SubmitResult, SubmitParams, string, OpenModalParams> {
+export declare interface AntomBridgeEventMap<AppConfig extends Record<string, any> = Record<string, any>, SubmitParams extends Record<string, any> = Record<string, any>, SR extends SubmitResult = SubmitResult> extends BaseBridgeEventMap<AppConfig, SR, SubmitParams, string, AntomOpenModalConfig> {
+}
+
+/**
+ * @description 整合了native事件的eventMap，如果你的业务element需要支持native，事件请继承这个类型
+ */
+export declare interface AntomBridgeWithNativeEventMap<AppConfig extends Record<string, any> = Record<string, any>, SubmitParams extends Record<string, any> = Record<string, any>, SR extends SubmitResult = SubmitResult> extends AntomBridgeEventMap<AppConfig, SubmitParams, SR> {
+    /* Excluded from this release type: showPopup */
+    /* Excluded from this release type: dismissLoading */
+    /* Excluded from this release type: webAppReady */
+    /* Excluded from this release type: onLaunch */
+    /* Excluded from this release type: renderComponent */
+    /* Excluded from this release type: appHeartBeat */
+    /* Excluded from this release type: showToast */
+    /* Excluded from this release type: onEventCallback */
+    /* Excluded from this release type: onSubmitPayCallback */
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: destroy */
+    /* Excluded from this release type: onClose */
+    /* Excluded from this release type: onRedirect */
 }
 
 /**
@@ -178,9 +197,9 @@ declare interface AntomErrorResponse {
     extendInfo?: Record<string, any>;
 }
 
-/* Excluded from this release type: AntomMiddlePageEventMap */
+export declare type AntomLayouts = 'tabs' | 'accordion';
 
-/* Excluded from this release type: AntomModalEventMap */
+/* Excluded from this release type: AntomMiddlePageEventMap */
 
 /* Excluded from this release type: AntomOpenModalConfig */
 
@@ -195,11 +214,14 @@ export declare class AntomSDK extends BaseElementsFactory {
      * @description 更新配置
      */
     updateConfig(config: Partial<BaseFactoryConfig>): void;
+    /* Excluded from this release type: redirect */
     /* Excluded from this release type: openModal */
     elements(): Elements;
+    createElement(elementType: 'payment', options?: PaymentAppConfig): PaymentElement;
     createElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
     createElement(elementType: 'CVV', options?: CVVAppConfig): CVVElement;
     createElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
+    getElement(elementType: 'payment', options?: PaymentAppConfig): PaymentElement;
     getElement(elementType: 'vaulting', options?: VaultingAppConfig): VaultingElement;
     getElement(elementType: 'CVV', options?: CVVAppConfig): CVVElement;
     getElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
@@ -256,6 +278,22 @@ export declare const AntomSDKErrorCodes: {
      * @description channelClientId 查询失败（请求异常，如网络错误、服务器错误等）
      */
     readonly CHANNEL_CLIENT_ID_QUERY_ERROR: "CHANNEL_CLIENT_ID_QUERY_ERROR";
+    /**
+     * @description checkout 页面未加载成功，不允许 updateConfig
+     */
+    readonly CHECKOUT_NOT_READY: "CHECKOUT_NOT_READY";
+    /**
+     * @description 支付进行中，不允许更新金额
+     */
+    readonly PAYMENT_IN_PROGRESS: "PAYMENT_IN_PROGRESS";
+    /**
+     * @description 金额不能为空
+     */
+    readonly AMOUNT_VALUE_EMPTY: "AMOUNT_VALUE_EMPTY";
+    /**
+     * @description 金额格式非法（仅允许整数和小数）
+     */
+    readonly AMOUNT_VALUE_INVALID: "AMOUNT_VALUE_INVALID";
     readonly GENERATE_ELEMENT_KEY_FAILED: "GENERATE_ELEMENT_KEY_FAILED";
     readonly ELEMENT_INIT_FAILED: "ELEMENT_INIT_FAILED";
     readonly MOUNT_TIMEOUT: "MOUNT_TIMEOUT";
@@ -272,6 +310,8 @@ export declare const AntomSDKErrorCodes: {
     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";
+    readonly UPDATE_CONFIG_NOT_READY: "UPDATE_CONFIG_NOT_READY";
     readonly INVALID_MODAL_URL: "INVALID_MODAL_URL";
     readonly LOAD_DEBUGGER_FAILED: "LOAD_DEBUGGER_FAILED";
     readonly API_MISS_PARAMS: "API_MISS_PARAMS";
@@ -289,6 +329,8 @@ export declare type AntomSDKErrorCodes = (typeof AntomSDKErrorCodes)[keyof typeo
 
 export declare type AntomTheme = 'default' | 'agateGreen' | 'night' | 'nostalgicGray' | 'gamingPurple' | 'cherryBlossomPink' | 'light';
 
+export declare type AntomVariables = 'content-primary' | 'content-secondary' | 'content-tertiary' | 'content-quaternary' | 'background-primary' | 'background-secondary' | 'background-disable' | 'background-transparency' | 'border-primary' | 'border-secondary' | 'border-disable' | 'action-normal' | 'action-hover' | 'action-disable' | 'action-secondary' | 'state-failure' | 'state-warning' | 'state-success' | 'state-info' | 'state-marketing' | 'state-conventional' | 'radius-backup' | 'radius-module' | 'radius-component' | 'radius-button' | 'wrapper-padding' | 'stroke-default' | 'stroke-active' | 'fontFamily';
+
 declare interface APICallbackOptions {
     requestType: 'fetch' | 'xhr';
     time: number;
@@ -303,15 +345,21 @@ declare interface APICallbackOptions {
     errorMsg?: string;
 }
 
+/**
+ * @description SDK UI组件的外观配置。
+ * 控制主题、CSS变量、布局规则及显示设置。
+ * @template Props - 自定义外观属性类型，默认为 DefaultAppearanceProps。
+ */
 declare interface Appearance<Props extends Partial<DefaultAppearanceProps> = DefaultAppearanceProps> {
     theme?: Props['theme'];
     variables?: PartialSpeKey<Props['variables'], string>;
     rules?: PartialSpeKey<Props['rules'], CSS_2.Properties<string, number>>;
     displaySetting?: PartialSpeKey<Props['displaySetting'], boolean>;
     layout?: Props['layout'];
+    fonts?: FontSource[];
 }
 
-declare type AppearanceSetting = {
+export declare type AppearanceSetting = {
     displaySetting: Record<'showCardBrandIcon', boolean>;
     theme: 'light' | 'dark';
     layout: 'accordion' | 'tabs';
@@ -712,6 +760,16 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
     /* Excluded from this release type: "OPENSDK@HANDSHAKE" */
     /* Excluded from this release type: "OPENSDK@READY_HANDSHAKE" */
     /* Excluded from this release type: "OPENSDK@UPDATE_CONFIG" */
+    /**
+     * 更新配置时的回复事件，包含可能发生的错误信息。
+     * 如果 error 为 undefined，则表示没有错误发生。
+     */
+    "OPENSDK@UPDATE_CONFIG_REPLY": {
+        /**
+         * 更新配置时发生的错误，如果error为undefined，则表示没有错误发生
+         */
+        error?: ErrorPayload<string>;
+    } | undefined;
     /* Excluded from this release type: "OPENSDK@HANDSHAKE_ACK" */
     /* Excluded from this release type: "OPENSDK@SUBMIT" */
     /* Excluded from this release type: "OPENSDK@SUBMIT_REPLY" */
@@ -721,12 +779,14 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
     /* Excluded from this release type: "OPENSDK@REDIRECT" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_PORT" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_APPEARANCE" */
+    /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_INITIALDATA" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_APP_PORT" */
     /* Excluded from this release type: "OPENSDK@ERROR" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_RECEIVE_PORT" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_SEND_PORT" */
     /* Excluded from this release type: "OPENSDK@MESSAGE" */
     /* Excluded from this release type: "OPENSDK@HEIGHT_UPDATE" */
+    /* Excluded from this release type: "OPENSDK@DESTROY_ELEMENT" */
 }
 
 declare interface BaseConfig {
@@ -747,6 +807,7 @@ declare interface BaseConfig {
      */
     locale?: string;
     /* Excluded from this release type: version */
+    /* Excluded from this release type: colorScheme */
 }
 
 /**
@@ -763,19 +824,21 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
     /* Excluded from this release type: iframe */
     status: 'initialized' | 'mounting' | 'mounted' | 'ready' | 'destroyed' | 'unmounted';
     /* Excluded from this release type: cachedSend */
+    /** Reuses the pending reply for concurrent submit calls. */
+    private submitPromise?;
     constructor(name: string, config: WithAppURL<Config>);
     /* Excluded from this release type: submit */
     /* Excluded from this release type: setup */
     /**
-     * @param {string | HTMLElement} containerId 如果给字符串id不要带#号
+     * @param {HTMLElement} container
      */
-    mount(containerId: HTMLElement): Promise<void>;
+    mount(container: HTMLElement): Promise<void>;
     /* Excluded from this release type: _mount */
     /**
      * 更新webapp配置
      * @param {Partial<BaseElementAppConfig>} newConfig
      */
-    updateConfig(newConfig: Partial<Config['appConfig']>): void;
+    updateConfig(newConfig: Partial<Config['appConfig']>): Promise<EventMap["OPENSDK@UPDATE_CONFIG_REPLY"]>;
     /**
      * 卸载元素
      */
@@ -808,13 +871,14 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
 }
 
 declare interface BaseElementAppConfig {
-    locale?: string;
+    /* Excluded from this release type: locale */
     /* Excluded from this release type: env */
     /* Excluded from this release type: merchantId */
     [key: string]: any;
 }
 
-declare interface BaseElementConfig<T extends BaseElementAppConfig = Record<string, any>> extends BaseConfig {
+declare interface BaseElementConfig<T extends BaseElementAppConfig = BaseElementAppConfig> extends BaseConfig {
+    /* Excluded from this release type: trackId */
     appConfig: T;
     elementMode: ElementMode;
 }
@@ -865,6 +929,7 @@ declare abstract class BaseFactory {
      */
     constructor(config: BaseFactoryConfig);
     protected openModal(payload: BaseBridgeEventMap['OPENSDK@OPEN_MODAL']): Promise<OpenModalHandle>;
+    protected redirect(payload: BaseBridgeEventMap['OPENSDK@REDIRECT']): void | Promise<void>;
     /* Excluded from this release type: canUseElements */
     /**
      * @description 无需手动调用
@@ -939,6 +1004,10 @@ declare abstract class BaseMainElement<Config extends BaseElementConfig = BaseEl
     /* Excluded from this release type: _submit */
 }
 
+/**
+ * @description 打开模态框的配置项。
+ * 包含显示选项、关闭行为、外观设置及初始化数据。
+ */
 declare interface BaseOpenModalConfig {
     /**
      * 无需手动传递，app的唯一scope
@@ -962,10 +1031,21 @@ declare interface BaseOpenModalConfig {
     onClose?: () => void;
     url: string;
     /**
-     * 关闭时，是否需要app页面二次确认，默认为false，即直接关闭
+     * @description 关闭时，是否需要告知webapp页面来进行关闭 链路为 modalApp 告知-> webapp 关闭-> sdk，默认为false，即直接在modal中进行关闭 modalApp 关闭-> sdk，
      */
     closeConfirm?: boolean;
+    /**
+     * @description 需要同步的外观配置
+     */
     appearance?: Appearance;
+    /**
+     * @description 需要传递的初始化数据
+     */
+    initialData?: Record<string, any>;
+    /**
+     * @description 无需手动传递, 模态框的唯一标识
+     */
+    modalId?: string;
 }
 
 declare type BehaviorConfig = {
@@ -1063,6 +1143,12 @@ declare interface C2PProps {
     merchantTransactionId?: string;
 }
 
+/* Excluded from this release type: CallbackErrorInfo */
+
+/* Excluded from this release type: CallbackReturnData */
+
+/* Excluded from this release type: CallbackSessionNextAction */
+
 declare interface CardIssuerAuthentication {
     /**
      * @description 卡售卖单元
@@ -1480,7 +1566,7 @@ declare interface CashierSdkActionQueryResult {
     /**
      * @description 物流信息, 包含物流地址和物流费
      */
-    shippingInfo?: ShippingInfo;
+    shippingInfo?: ShippingInfo_2;
     /**
      * @description 用户已绑资产信息
      */
@@ -1513,28 +1599,6 @@ declare interface ChargeInfo {
     chargeActualAmountView?: PaymentView;
 }
 
-/** click 事件 resolve 参数 */
-export declare interface ClickResolveOptions {
-    amount?: {
-        currency: string;
-        value: string;
-    };
-    shippingAddressRequired?: boolean;
-    allowedShippingCountries?: string[];
-    shippingRates?: Array<{
-        id: string;
-        displayName: string;
-        amount: string;
-    }>;
-    lineItems?: Array<{
-        name: string;
-        amount: string;
-    }>;
-    business?: {
-        name: string;
-    };
-}
-
 declare interface CodeFormView {
     /**
      * @description title
@@ -1560,6 +1624,11 @@ declare interface CodeFormView {
      * @description label
      */
     label?: string;
+    /**
+     * @description Payment guidance information (CKP scenario) The frontend only displays the payment guide button
+     * when appLinkUrlForWeb is populated
+     */
+    paymentGuideInfo?: PaymentGuideInfo;
     /**
      * @description 提醒事项
      */
@@ -1576,6 +1645,10 @@ declare interface CodeFormView {
      * @description 码过期时间
      */
     codeExpireTime?: string;
+    /**
+     * @description QR code configuration including renderStyle, centerIcon and cornerIcon
+     */
+    qrcodeConfig?: QrCodeConfig;
 }
 
 /**
@@ -2132,10 +2205,14 @@ export declare interface ConfirmCardSetupOptions {
 export declare interface ConfirmPaymentOptions extends Omit<ConfirmCardSetupOptions, 'elements'> {
     sessionData: string;
     /**
-     * @description 传入已挂载的 CVVElement 或 Elements 实例，不传则使用无 UI 自动提交模式
+     * @description 传入已挂载的 CVVElement / PaymentElement / Elements 实例，不传则使用无 UI 自动提交模式
      */
     elements?: BaseMainElement | BaseElements;
     appearance?: CVVAppearance;
+    /**
+     * @description 集成用户自定义信息（如 cardHolderName）
+     */
+    params?: Record<string, unknown>;
 }
 
 /**
@@ -2207,6 +2284,13 @@ declare namespace CSS_2 {
     }
 }
 
+/**
+ * CSS 字体源 — 通过 <link> 标签加载外部 CSS（如 Google Fonts）
+ */
+declare interface CssFontSource {
+    cssSrc: string;
+}
+
 declare interface CurrencyInfo {
     /**
      * @description Getter method for property <tt>currencyCode</tt>.
@@ -2251,6 +2335,17 @@ declare interface CustomerFxInfo {
     useMarketPrice?: boolean;
 }
 
+/**
+ * 自定义字体源 — 通过 @font-face 加载自托管字体
+ */
+declare interface CustomFontSource {
+    family: string;
+    src: string;
+    weight?: string;
+    style?: string;
+    unicodeRange?: string;
+}
+
 /**
  * CustomizedPerformanceKey 是给业务使用的自定义指标，共 20 个，页面之间互相独立
  */
@@ -2260,7 +2355,7 @@ declare type CustomizedPerformanceKey = 'm1' | 'm2' | 'm3' | 'm4' | 'm5' | 'm6'
  * @public
  * @description CVV element app config type
  */
-export declare interface CVVAppConfig extends BaseAppearance<CVVAppearance> {
+export declare interface CVVAppConfig extends BaseAppearance<CVVAppearance>, BaseElementAppConfig {
     /**
      * @description sessionData
      */
@@ -2280,7 +2375,8 @@ export declare type CVVAppearance = PickAppearance<CVVAppearanceProps>;
 
 export declare type CVVAppearanceProps = {
     theme: AntomTheme;
-    variables: 'content-primary' | 'content-tertiary' | 'background-primary' | 'background-disable' | 'background-transparency' | 'border-primary' | 'border-disable' | 'action-normal' | 'action-hover' | 'radius-component' | 'content-secondary' | 'background-secondary';
+    variables: AntomVariables;
+    fonts?: FontSource[];
 };
 
 /**
@@ -2366,6 +2462,10 @@ export declare interface CVVSubmitParams {
      * 重定向策略
      */
     redirect?: 'always' | 'if_required';
+    /**
+     * 集成用户自定义信息（如 cardHolderName）
+     */
+    params?: Record<string, unknown>;
 }
 
 declare interface DanaSofCouponInfo {
@@ -3084,7 +3184,7 @@ declare class Elements extends BaseElements {
     getElement(elementType: 'express', options?: ExpressAppConfig): ExpressElement;
 }
 
-declare type ElementTypeEnum = 'TEXT' | 'DIGIT_6' | 'DIGIT_18' | 'DIGIT_32' | 'DIGIT_11' | 'DIGIT_4' | 'DIGIT_10' | 'CHECKBOX' | 'SELECT' | 'SWITCH' | 'PASSWORD_2' | 'DATE_PICKER' | 'CHECKLIST' | 'ADDRESS' | 'DROPBOX' | 'DIGIT_13' | 'GRIDLIST' | 'TENOR_SELECT_KR' | 'STORELIST' | 'GRIDBANKLIST' | 'SUB_QR_CODE' | 'GRIDBANKTOP' | 'PHONE_TEXT_AREA_CODE';
+declare type ElementTypeEnum = 'TEXT' | 'DIGIT_6' | 'DIGIT_18' | 'DIGIT_32' | 'DIGIT_11' | 'DIGIT_4' | 'DIGIT_10' | 'CHECKBOX' | 'SELECT' | 'SWITCH' | 'PASSWORD_2' | 'DATE_PICKER' | 'CHECKLIST' | 'ADDRESS' | 'DROPBOX' | 'DIGIT_13' | 'GRIDLIST' | 'TENOR_SELECT_KR' | 'STORELIST' | 'GRIDBANKLIST' | 'SUB_QR_CODE' | 'GRIDBANKTOP' | 'PHONE_TEXT_AREA_CODE' | 'SUPPORTIPPBANKLIST';
 
 declare type Env = 'local' | 'dev' | 'sit' | 'pre' | 'prod';
 
@@ -3175,6 +3275,22 @@ declare interface ExpCardPlan {
      * @description 每个月分期利息
      */
     monthlyInterest?: ComIpayIexpprodServiceFacadeCommonAmount;
+    /**
+     * @description 分期有效期开始时间
+     */
+    validStartTime?: string;
+    /**
+     * @description 分期有效期结束时间
+     */
+    validEndTime?: string;
+    /**
+     * @description 支持的银行信息
+     *
+     * 包含该分期计划支持的银行详细信息，包括银行简称、logo等。
+     * 该字段从 installmentBanks 数据中通过 bankShortName 关联而来，
+     * 若分期计划无银行限制或未匹配到银行信息，该字段可能为null。@see ExpSupportIppBank
+     */
+    supportedBank?: ExpSupportIppBank;
 }
 
 declare interface ExpInstallmentInfo {
@@ -3199,12 +3315,18 @@ declare interface ExpPaymentOptionDetail {
  * @public
  * @description Express element app config type
  */
-export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetting> {
+export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetting>, BaseElementAppConfig {
     /** payment SessionData */
     sessionData?: string;
     /** Business division (country/region) */
     businessDivision?: string;
-    /** Amount & Currency */
+    /**
+     * Amount & Currency
+     *
+     * Only effective via `updateConfig({ amount })` at runtime.
+     * Passing amount at creation time is ignored; the initial amount
+     * comes from the server-side sdkQuery result (renderData.paymentAmount).
+     */
     amount?: {
         currency: string;
         value: string;
@@ -3213,20 +3335,20 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
     paypal?: PayPalConfig;
     /**
      * Button text type (following Stripe Express Checkout Element design)
-     * Each payment method can independently set the button display text
-     * Reserved index signature for future payment method integration
+     * Each payment method can independently set the button display text.
      */
     buttonType?: {
         /** PayPal: paypal | checkout | buynow | pay */
         paypal?: 'paypal' | 'checkout' | 'buynow' | 'pay';
         [method: string]: string | undefined;
     };
-    /** Unified height for all buttons (px) */
+    /**
+     * Unified height for all buttons (px)
+     */
     buttonHeight?: number;
     /**
      * Button color theme (following Stripe Express Checkout Element design)
-     * Each payment method can independently set the theme color
-     * Reserved index signature for future payment method integration
+     * Each payment method can independently set the theme color.
      */
     buttonTheme?: {
         /** PayPal: gold | blue | silver | white | black */
@@ -3244,6 +3366,13 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
      * Locale for internationalization, passed from entry params (loadAntom), default to en_US
      */
     locale?: string;
+    /**
+     * 是否运行在 Native App 的 WebView 中。
+     * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
+     */
+    isNativeAppWebview?: boolean;
+    /* Excluded from this release type: merchantDomain */
+    /* Excluded from this release type: doMain */
 }
 
 /** cancel 事件负载 */
@@ -3252,24 +3381,54 @@ export declare interface ExpressCancelEvent {
     data?: any;
 }
 
-/** click 事件负载 */
+/** click 事件负载（纯通知，商户可用于埋点，SDK 不等待响应） */
 export declare interface ExpressClickEvent {
     expressPaymentType: string;
-    resolve: (options: ClickResolveOptions) => void;
 }
 
 /** confirm 事件负载（统一终态，替代 approve） */
 export declare interface ExpressConfirmData {
     expressPaymentType: string;
-    paymentData: any;
-    billingDetails?: any;
-    shippingAddress?: any;
-    sessionData?: string;
+    billingDetails?: {
+        name?: string;
+        email?: string;
+        phone?: string;
+        address?: {
+            line1?: string;
+            line2?: string;
+            city?: string;
+            state?: string;
+            postalCode?: string;
+            country?: string;
+        };
+    };
+    shippingAddress?: {
+        name?: string;
+        phone?: string;
+        address?: {
+            line1?: string;
+            line2?: string;
+            city?: string;
+            state?: string;
+            postalCode?: string;
+            country?: string;
+        };
+    };
+    /** 支付方式返回的原始支付数据（如 alipayCn、applePay 等） */
+    paymentData?: unknown;
+    /**
+     * 商户主动拒绝本次支付（如库存不足、价格变动等）。
+     * 调用后 SDK 立即取消支付流程，confirmPayment() 无需调用。
+     */
+    paymentFailed: () => void;
 }
 
 /**
  * @public
  * @description Express element - express checkout element, supports PayPal / Apple Pay / Google Pay
+ *
+ * Host 侧只保留 Element 生命周期、商户事件包装和 bridge 连接。
+ * AP/GP/AlipayCN 的 submit、2DS/3DS、polling 结果处理都由 express_element webapp 承接。
  */
 export declare class ExpressElement extends BaseMainElement<ExpressElementConfig, ExpressElementEvents> {
     static elementType: string;
@@ -3277,15 +3436,44 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
      * Store all function-type callbacks locally, not involved in postMessage serialization
      */
     private _callbacks;
+    /** setup 阶段的 renderData，仅供非 Safari PC Apple Pay host-token 路径读取 paymentRequest。 */
+    private _renderData;
+    private _hostSign;
+    /**
+     * 本地事件处理器（绕过 bridge 的 host→webapp 方向限制）。
+     * bridge.on 只能监听 iframe 发来的消息；SDK host 主动推送事件给商户时走 _emit → _localHandlers。
+     */
+    private _localHandlers;
+    /** 支付流程进行中标志（click → confirm/error/cancel 之间） */
+    private _paymentInProgress;
+    private _paypalOverlay;
     constructor(name: string, config: ExpressElementConfig);
-    setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     /**
-     * Register internal event listeners (iframe communication)
+     * 重写 on：
+     * 1. 对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
+     * 2. 对 onRedirect 事件同步注册到 _localHandlers（SDK host 主动推送时商户能收到）
+     */
+    on(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * SDK host 主动推送事件给商户（不走 bridge postMessage，直接调用本地注册的 handler）。
+     * 用于 Native WebView 场景下 SDK 需要向商户透传跳转信息等。
+     */
+    private _emit;
+    updateConfig(newConfig: Pick<ExpressAppConfig, 'amount'>): Promise<ExpressElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    /**
+     * 商户在 confirm 回调内调用，触发实际支付提交。
+     * iframe 收到 OPENSDK@COMPLETE_PAYMENT 后执行 submitPay / polling 等，
+     * 完成后通过 OPENSDK@COMPLETE_PAYMENT_RESULT 回包，Promise resolve。
      */
-    /** Overlay DOM node, created on click, removed after payment ends */
-    private _overlay;
-    private _showOverlay;
-    private _hideOverlay;
+    completePayment(redirect?: 'always' | 'if_required'): Promise<{
+        success: boolean;
+        result?: any;
+        error?: {
+            code: string;
+            message: string;
+        };
+    }>;
+    setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
     protected focus(): void;
     protected blur(): void;
@@ -3303,57 +3491,83 @@ export declare interface ExpressElementConfig extends BaseElementConfig<ExpressA
  * @public
  * @description Express element events type
  */
-export declare interface ExpressElementEvents extends AntomBridgeEventMap<ExpressAppConfig> {
-    /**
-     * @description Element ready event — 上报可用支付方式
-     */
+export declare interface ExpressElementEvents extends AntomBridgeWithNativeEventMap<ExpressAppConfig> {
     ready: {
         availablePaymentMethods: Record<string, boolean>;
     };
-    /**
-     * @description 用户点击按钮 — 商户必须调用 event.resolve() 后 sheet 才弹出
-     * 对 PayPal: resolve 为 no-op（PayPal 自行弹出 popup）
-     */
     click: ExpressClickEvent;
-    /**
-     * @description 统一支付完成事件（替代 approve）
-     * 用户授权完成后触发，通过 expressPaymentType 区分钱包类型
-     */
     confirm: ExpressConfirmData;
-    /**
-     * @description 支付错误事件（扩展基类 ErrorPayload，新增 expressPaymentType）
-     */
     error: ErrorPayload & {
         expressPaymentType: string;
     };
-    /**
-     * @description 用户取消支付
-     */
     cancel: ExpressCancelEvent;
-    /**
-     * @description 用户在 sheet 内变更收货地址（AP/GP only，PayPal 不触发）
-     */
     shippingaddresschange: {
         expressPaymentType: string;
         address: any;
         resolve: (options: ShippingResolveOptions) => void;
         reject: (reason: string) => void;
     };
-    /**
-     * @description 用户在 sheet 内变更配送方式（AP/GP only，PayPal 不触发）
-     */
     shippingratechange: {
         expressPaymentType: string;
         shippingRate: any;
         resolve: (options: RateResolveOptions) => void;
     };
-    /* Excluded from this release type: contentHeightChanged */
-    /* Excluded from this release type: "paypal:createOrder" */
-    /* Excluded from this release type: "paypal:createOrder:reply" */
-    /* Excluded from this release type: "paypal:onShippingAddressChange" */
-    /* Excluded from this release type: "paypal:onShippingAddressChange:reply" */
-    /* Excluded from this release type: "paypal:onShippingOptionsChange" */
-    /* Excluded from this release type: "paypal:onShippingOptionsChange:reply" */
+    contentHeightChanged: {
+        height: number;
+    };
+    'OPENSDK@CLICK': {
+        expressPaymentType: string;
+    };
+    'OPENSDK@CLICK_RESOLVE': Record<string, never>;
+    'OPENSDK@PAYPAL_CREATE_ORDER': {
+        requestId: string;
+    };
+    'OPENSDK@PAYPAL_CREATE_ORDER_REPLY': {
+        requestId: string;
+        sessionData?: string;
+        error?: string;
+    };
+    'OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE': {
+        requestId: string;
+        shippingData: any;
+    };
+    'OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE_REPLY': {
+        requestId: string;
+        error?: string;
+    };
+    'OPENSDK@PAYPAL_SHIPPING_OPTIONS_CHANGE': {
+        requestId: string;
+        shippingData: any;
+    };
+    'OPENSDK@PAYPAL_SHIPPING_OPTIONS_CHANGE_REPLY': {
+        requestId: string;
+        error?: string;
+    };
+    'OPENSDK@GET_APPLE_PAY_TOKEN': {
+        requestId: string;
+        expressPaymentType: string;
+    };
+    /** host 完成 Apple Pay token 获取后回包给 iframe，submit/3DS/polling 均由 webapp 完成 */
+    'OPENSDK@GET_APPLE_PAY_TOKEN_REPLY': {
+        requestId: string;
+        success: boolean;
+        result?: any;
+        errorCode?: string;
+        errorMessage?: string;
+        billingDetails?: any;
+        shippingAddress?: any;
+    };
+    'OPENSDK@UPDATE_CONFIG_REPLY': {
+        error?: ErrorPayload<string>;
+    };
+    'OPENSDK@COMPLETE_PAYMENT_REJECT': Record<string, never>;
+    onRedirect: {
+        normalUrl: string;
+        applinkUrl?: string;
+        schemaUrl?: string;
+        isDestroy: boolean;
+        needReset: boolean;
+    };
 }
 
 declare interface ExpSupportBank {
@@ -3378,6 +3592,24 @@ declare interface ExpSupportCardBrand {
     logo?: Logo;
 }
 
+/**
+ * @description 支持的分期银行信息
+ */
+declare interface ExpSupportIppBank {
+    /**
+     * @description bank short name or bank code
+     */
+    bankShortName?: string;
+    /**
+     * @description logo
+     */
+    logo?: Logo;
+    /**
+     * @description bins
+     */
+    bins?: string[];
+}
+
 declare type Fallback<T> = { [P in keyof T]: T[P] | readonly NonNullable<T[P]>[] };
 
 declare interface FirstPhaseSubscriptionDetail {
@@ -3395,6 +3627,27 @@ declare interface FirstPhaseSubscriptionDetail {
     promotionDetails?: PromotionDetail[];
 }
 
+declare type FontSource = CssFontSource | CustomFontSource;
+
+declare interface FrontModulesToBeLoadedInterface {
+    acquirerName: string;
+    scriptUrl: string;
+}
+
+/**
+ * @description 分期银行展示模型
+ */
+declare interface FrontSupportIppBank {
+    /**
+     * @description bank short name or bank code
+     */
+    bankShortName?: string;
+    /**
+     * @description logo
+     */
+    logo?: Logo;
+}
+
 declare type GetI18nQueryParam = string | {
     /**
      * 多语言文案的 key
@@ -4026,6 +4279,14 @@ declare interface HTTPErrorCallbackOptions {
     aborted?: 0 | 1;
 }
 
+declare interface IApplePayContactField {
+    email: string;
+    name: string;
+    phone: string;
+    postalAddress: string;
+    phoneticName: string;
+}
+
 declare interface iBaseElementClass {
     new (name: string, config: BaseElementConfig): BaseElement;
     elementType: string;
@@ -4193,6 +4454,100 @@ declare interface IOptions {
     stayTime?: number;
 }
 
+declare interface IPaymentSessionMetaData {
+    clientId?: string;
+    renderDisplayType?: string;
+    paymentSessionConfig?: PaymentSessionConfig;
+    securityConfig?: SessionSecurityConfig;
+    moneyView?: any;
+    extendInfo?: string;
+    paymentMethodInfoView?: any;
+    paymentView?: any;
+    modernWeb?: boolean;
+    action?: PaymentSessionAction;
+    /**
+     * @description 是一个string，灰度开关，格式为 flag1,flag2,flag3
+     */
+    flowSwitchTags?: string;
+    authUrlInfo?: {
+        appIdentifier?: string;
+        applinkUrl?: string;
+        normalUrl?: string;
+        schemeUrl?: string;
+        authUrl?: string;
+    };
+    paymentSessionFactor?: {
+        externalRiskTimeout?: number;
+        extendInfo?: {
+            merchantCapabilities?: string[];
+            supportedNetworks?: string[];
+            requiredBillingContactFields: IApplePayContactField[];
+            requiredShippingContactFields: IApplePayContactField[];
+        };
+        merchantInfo?: {
+            registeredCountry?: string;
+            partnerId?: string;
+            merchantName?: string;
+        };
+        order?: {
+            orderDescription: string;
+        };
+        paymentAmount?: {
+            value?: string;
+            currency?: string;
+        };
+        paymentMethodInfo?: {
+            paymentMethodType?: string;
+        };
+        paymentMethodViewMetaData?: any;
+        paymentRequestId?: string;
+        supportedLanguages?: any;
+        /**
+         * 当前为苹果分期场景的信息
+         */
+        recurringInfo?: {
+            /**
+             * 代扣协议开始日期 不传为当前系统时间
+             */
+            startDate?: number;
+            /**
+             * 代扣协议结束日期 不传不限制结束时间
+             */
+            endDate?: number;
+            /**
+             * 付款时间间隔单位，支持："year" "month" "day" "hour" "minute" 不传默认month
+             */
+            intervalUnit?: string;
+            /**
+             * 付款时间间隔。比如每过6个月付款一次，intervalCount就是6, 不传默认为1
+             */
+            intervalCount?: number;
+            /**
+             * 分期标题信息
+             */
+            title?: string;
+            /**
+             * 分期管理页面
+             */
+            managementURL?: string;
+            /**
+             * 苹果通知ipay MAPN信息变更的地址
+             */
+            tokenNotificationURL?: string;
+            /**
+             * 分期协议描述
+             */
+            agreementDescription?: string;
+        };
+        frontModulesToBeLoaded?: FrontModulesToBeLoadedInterface[];
+    };
+    connectFactor?: {
+        enableConnect?: boolean;
+    };
+    skipRenderPaymentMethod?: boolean;
+    needAccountConfirmPage?: boolean;
+}
+
 declare interface ISystemInfo {
     readonly pixelRatio: number;
     readonly windowWidth: number;
@@ -6692,6 +7047,68 @@ declare interface OneAccountInfo {
     accountStatus?: string;
 }
 
+/**
+ * @description one account 账户信息查询结果
+ */
+declare interface OneAccountQueryResult {
+    /**
+     * @description 是否业务处理成功
+     */
+    success?: boolean;
+    /**
+     * @description 错误上下文
+     */
+    errorContext?: ErrorContext;
+    /**
+     * @description 返回结果码
+     */
+    resultCode?: string;
+    /**
+     * @description 返回结果信息
+     */
+    resultMessage?: string;
+    /**
+     * @description error actions
+     */
+    errorActions?: Record<string, string>;
+    /**
+     * @description error code
+     */
+    errorCode?: string;
+    /**
+     * @description error status
+     */
+    errorStatus?: string;
+    /**
+     * @description error message
+     */
+    errorMessage?: string;
+    /**
+     * @description extend info
+     */
+    extendInfo?: Record<string, string>;
+    /**
+     * @description one account 账户信息
+     */
+    accountInfo?: OneAccountInfo;
+    /**
+     * @description action form 下一步动作
+     */
+    actionForm?: OtpChallengeActionForm;
+    /**
+     * @description 支付方式列表
+     */
+    paymentMethods?: PaymentMethodView[];
+    /**
+     * @description 物流信息
+     */
+    shippings?: ShippingInfo_2[];
+    /**
+     * @description 支付金额 （订单金额 + 物流费）
+     */
+    paymentAmount?: MobileMoneyView;
+}
+
 /**
  * @description OpenModal的返回值类型
  */
@@ -6895,6 +7312,56 @@ declare interface OSInfo {
     osVer?: string;
 }
 
+declare interface OtpChallengeActionForm {
+    /**
+     * @description action form type
+     */
+    actionFormType?: string;
+    /**
+     * @description type of challenge
+     */
+    challengeType?: string;
+    /**
+     * @description The actual render value
+     */
+    challengeRenderValue?: string;
+    /**
+     * @description Describe the challenge is required by AAC or external party
+     */
+    triggerSource?: string;
+    /**
+     * @description is support retry challenge
+     * @default true
+     */
+    isChallengeRetrySupported?: boolean;
+    /**
+     * @description is fist otp auto triggered
+     * @default false
+     */
+    isChallengeAutoTriggered?: boolean;
+    /**
+     * @description estimated challenge response duration
+     * @default 0
+     */
+    estimatedDuration?: number;
+    /**
+     * @description url - like h5 sdk challenge need to call back url
+     */
+    challengeUrl?: string;
+    /**
+     * @description extend information
+     */
+    extendInfo?: string;
+    /**
+     * @description verify Id
+     */
+    verifyId?: string;
+    /**
+     * @description 重发次数
+     */
+    resendLeftTimes?: number;
+}
+
 declare type PartialSpeKey<T, V> = Partial<T extends infer K extends string ? Record<K, V> : Record<string, V>>;
 
 declare interface PayByLinkInfo {
@@ -6916,6 +7383,60 @@ declare interface PayByLinkInfo {
     linkVersion?: number;
 }
 
+/**
+ * @description Payment element app config type
+ */
+export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearance>, BaseElementAppConfig {
+    /**
+     * @description sessionData，无法通过updateConfig更新
+     */
+    sessionData?: string;
+    /* Excluded from this release type: merchantDomain */
+    /* Excluded from this release type: renderData */
+    /* Excluded from this release type: connectAccount */
+    /* Excluded from this release type: sessionMetaData */
+    /* Excluded from this release type: renderDataError */
+    /* Excluded from this release type: sdkVersion */
+    /* Excluded from this release type: _requestConfig */
+    /* Excluded from this release type: logMetaData */
+    /* Excluded from this release type: heightOfVisible */
+}
+
+/**
+ * @description Payment element appearance type
+ */
+export declare type PaymentAppearance = PickAppearance<{
+    displaySetting: 'showPaymentMethodListWhenSingleOption' | 'showCardBrandIcon' | 'showRadioWhenAccordionLayout' | 'showCardCVV';
+    theme: AntomTheme;
+    variables: AntomVariables;
+    layout: AntomLayouts;
+}>;
+
+/**
+ * @description Payment element
+ */
+export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
+    static elementType: string;
+    constructor(name: string, config: PaymentElementConfig);
+    /* Excluded from this release type: setup */
+    /* Excluded from this release type: submit */
+    protected focus(): void;
+    protected blur(): void;
+    protected clear(): void;
+}
+
+/**
+ * @description Payment element config type
+ */
+declare interface PaymentElementConfig extends BaseElementConfig<PaymentAppConfig> {
+}
+
+/**
+ * @description Payment element events
+ */
+export declare interface PaymentElementEvents extends AntomBridgeWithNativeEventMap<PaymentAppConfig, PaymentSubmitParams, PaymentSubmitResult> {
+}
+
 declare interface PaymentElementView {
     /**
      * @description payment element key
@@ -7017,6 +7538,36 @@ declare interface PaymentEvaluationResult {
     paymentBalanceInfo?: DanaSofPayMethodView[];
 }
 
+/**
+ * @description Payment guidance information (CKP scenario)
+ *
+ * <p>Displays payment guide buttons on the checkout page, including: - Deep link: For launching the
+ * bank application (required) - Copy configuration: Divider text, button labels, etc. (extensible
+ * via Map, dynamically addable)
+ */
+declare interface PaymentGuideInfo {
+    /**
+     * @description The deep link (from iexpprod, used to launch the bank app) The frontend only displays the
+     * payment guide button when this field is populated
+     */
+    appLinkUrlForWeb?: string;
+    /**
+     * @description Copy configuration (from the config center) Stored in a Map to support dynamic extension of
+     * text fields
+     *
+     * <p>Example configuration:
+     *
+     * <pre>
+     * {
+     *   "dividerText": "or pay using",
+     *   "directPayButtonText": "Pay directly with online banking",
+     *   "ctoPButtonText": "Continue to payment"
+     * }
+     * </pre>
+     */
+    copyWriting?: Record<string, any>;
+}
+
 /**
  * @description 支付方式余额检查结果信息
  */
@@ -7079,6 +7630,10 @@ declare interface PaymentMethodView {
      * @description icon
      */
     icon?: string;
+    /**
+     * @description adaptive icon for PAYME payment method
+     */
+    adaptiveIcon?: string;
     /**
      * @description icon对应的名称
      */
@@ -7087,6 +7642,10 @@ declare interface PaymentMethodView {
      * @description 支付方式描述
      */
     description?: string;
+    /**
+     * @description 支付方式点击后的描述
+     */
+    descriptionAfterClick?: string;
     /**
      * @description category
      */
@@ -7221,6 +7780,10 @@ declare interface PaymentMethodView {
      * @description 账单地址收集模式
      */
     billingAddressCollectionMode?: string;
+    /**
+     * @description 分期银行信息列表
+     */
+    supportIppBankList?: FrontSupportIppBank[];
 }
 
 declare interface PaymentOption {
@@ -7288,6 +7851,10 @@ declare interface PaymentOption {
      * @description 支付选项Logo信息
      */
     logo?: Logo;
+    /**
+     * @description 支付描述多语言列表。如果入参有locale，且入参的locale有对应语言，则这里只返回locale对应的语言。
+     */
+    description?: Record<string, string>;
     /**
      * @description extendInfo extendInfo information
      */
@@ -7355,6 +7922,13 @@ declare interface PaymentQuoteInfo {
      * @description payment amount view
      */
     paymentAmountView?: PaymentView;
+    /**
+     * @description Display exchange rate from FX domain Quote, direction-adjusted and formatted to 2 decimal
+     * places. - BID direction: value = 1/price, setScale(2, HALF_UP) - OFFER direction: value =
+     * price, setScale(2, HALF_UP) Used for direct frontend access to exchange rate. Example: 3.16 for
+     * MYR/SGD currency pair
+     */
+    quotePrice?: any;
 }
 
 /**
@@ -7464,6 +8038,45 @@ declare interface PaymentSessionConfig {
     productSceneVersion?: string;
 }
 
+/**
+ * @description The submit params
+ */
+export declare interface PaymentSubmitParams extends SubmitParams {
+    /**
+     * @description 是否由antom sdk自动处理唤端逻辑，默认为true，由sdk自动处理。
+     * 如果antom sdk唤起客户端失败，建议设置为false，商家自行唤端
+     */
+    handleActions?: boolean;
+    /**
+     * @description 收件地址信息
+     */
+    shippingInfo?: ShippingInfo;
+    /**
+     * @description 集成用户自定义信息（如 cardHolderName）
+     */
+    params?: Record<string, unknown>;
+}
+
+/**
+ * @description Payment element submit result
+ */
+export declare interface PaymentSubmitResult extends SubmitResult {
+    paymentSession?: {
+        /**
+         * @description 回调页面的url链接，使用浏览器可直接打开，比如 http://xxx.app.com/xxx
+         */
+        returnUrl: string;
+        /**
+         * @description 回调页面唤起app的url链接，使用浏览器可直接打开，比如 http://xxx.app.com/xxx
+         */
+        returnAppUrl?: string;
+        /**
+         * @description 回调页面唤起app的scheme链接，比如 alipay://xxx
+         */
+        returnAppScheme?: string;
+    };
+}
+
 declare interface PaymentView {
     /**
      * @description 金额,以元为单位的金额
@@ -7582,6 +8195,11 @@ declare interface PeriodRule {
     periodCount?: number;
 }
 
+/**
+ * @description 工具类型，仅从 Appearance 中拾取与 Props 类型匹配的属性。
+ * 返回受 Props 中存在的键约束的部分外观对象。
+ * @template Props - 要从 Appearance 中拾取的自定义外观属性类型。
+ */
 declare type PickAppearance<Props extends Partial<DefaultAppearanceProps>> = Partial<Pick<Appearance<Props>, keyof Props extends infer k extends keyof Partial<Appearance> ? k : keyof Partial<Appearance>>>;
 
 declare interface PluginContext {
@@ -9554,6 +10172,24 @@ TValue extends Array<infer AValue> ? Array<AValue extends infer TUnpacked & {} ?
 
 declare type Pseudos = AdvancedPseudos | SimplePseudos;
 
+/**
+ * @description QR code configuration for code form view
+ */
+declare interface QrCodeConfig {
+    /**
+     * @description QR code render style, e.g. "rounded"
+     */
+    renderStyle?: string;
+    /**
+     * @description QR code center icon, can be URL or Base64 format
+     */
+    centerIcon?: string;
+    /**
+     * @description QR code corner icon, can be URL or Base64 format
+     */
+    cornerIcon?: string;
+}
+
 declare interface Rate {
     /**
      * @description rate label value
@@ -9623,13 +10259,31 @@ declare class ReceivePort {
     }): Promise<Record<string, any> | undefined>;
 }
 
+/**
+ * @description 从webapp重定向到新URL的配置项。
+ * 支持浏览器重定向、app link唤端及schema唤端。
+ */
 declare interface RedirectOption {
+    /**
+     * @description 浏览器重定向到兜底的url，通常在唤端失败时会走这个，或者你不需要唤端，只需要跳转到某个url
+     */
     url: string;
+    /**
+     * @description 唤端到url地址，http或https的地址
+     */
+    appLinkUrl?: string;
+    /**
+     * @description 唤端到schema地址, schema://的地址
+     */
+    schemaUrl?: string;
+    /**
+     * @description 重定向模式，默认为redirect
+     */
     mode?: 'redirect' | 'replace';
     /**
      * @description 是否重定向后销毁实例，默认为true
      */
-    destory?: boolean;
+    destroy?: boolean;
 }
 
 declare type ReportData = {
@@ -9860,7 +10514,25 @@ declare interface SharePayInfo {
     securityText?: string;
 }
 
-declare interface ShippingInfo {
+export declare interface ShippingInfo {
+    shippingName: {
+        firstName: string;
+        lastName: string;
+        middleName?: string;
+        fullName?: string;
+    };
+    shippingPhoneNo: string;
+    shippingAddress: {
+        region: string;
+        address1: string;
+        address2: string;
+        city?: string;
+        state?: string;
+        zipCode: string;
+    };
+}
+
+declare interface ShippingInfo_2 {
     /**
      * @description The unique ID to identify the shipping info
      */
@@ -23778,16 +24450,20 @@ declare interface StandardShorthandPropertiesHyphen<TLength = (string & {}) | 0,
 
 declare type StandardShorthandPropertiesHyphenFallback<TLength = (string & {}) | 0, TTime = string & {}> = Fallback<StandardShorthandPropertiesHyphen<TLength, TTime>>;
 
+export declare type SubmitParams = {
+    redirect?: 'always' | 'if_required';
+};
+
 /**
- * @description 成功时的data数据类型
+ * @description 成功时的数据类型
  */
 export declare type SubmitResult = {
+    /* Excluded from this release type: code */
+    /* Excluded from this release type: message */
     /**
      * 查询到的状态
      */
     status: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
-    /* Excluded from this release type: code */
-    /* Excluded from this release type: message */
     /**
      * @description 对结果的详细结果码和结果信息，在status为SUCCESS时无该字段
      */
@@ -23800,6 +24476,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 是否需要更换 session 重试
+         */
+        needChangeSessionForRetry?: boolean;
     };
     /**
      * 是否是用户手动取消3D
@@ -24258,6 +24938,16 @@ declare interface TerminalTypeAction {
     interactionType?: string;
 }
 
+/**
+ * 主题色映射表 — 将 AntomTheme 映射到 loading 阶段的明暗模式和背景色。
+ * 被 antom.ts（老架构入口）和 modernElementController（新架构入口）共用，
+ * 确保两条路径的弹窗 loading 表现一致。
+ */
+export declare const themeColorMap: Record<AntomTheme, {
+    theme: 'dark' | 'light';
+    backgroundColor: string;
+}>;
+
 declare class Tracker {
     protected requesterCacheWrapper?: RequesterCacheWrapper;
     private initPromise;
@@ -24587,7 +25277,8 @@ export declare type VaultingAppearance = PickAppearance<VaultingAppearanceProps>
 export declare type VaultingAppearanceProps = {
     displaySetting: 'showCardBrandIcon';
     theme: AntomTheme;
-    variables: 'background-secondary' | 'radius-module' | 'wrapper-padding' | 'content-primary' | 'border-primary' | 'action-hover' | 'border-disable' | 'content-tertiary' | 'background-primary' | 'background-disable' | 'radius-component' | 'state-failure' | 'action-normal' | 'content-secondary';
+    variables: AntomVariables;
+    fonts?: FontSource[];
 };
 
 /**
@@ -24610,7 +25301,7 @@ export declare class VaultingElement extends BaseMainElement<VaultingElementConf
 declare interface VaultingElementConfig extends BaseElementConfig<VaultingAppConfig> {
 }
 
-export declare interface VaultingElementEvents extends AntomBridgeEventMap<VaultingAppConfig, VaultingSubmitParams> {
+export declare interface VaultingElementEvents extends AntomBridgeWithNativeEventMap<VaultingAppConfig, VaultingSubmitParams> {
 }
 
 /**