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

package/types.untrimmed.d.ts

@@ -143,7 +143,88 @@ 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> {
+    /**
+     * @internal 展示半浮层
+     */
+    showPopup: {
+        mode: string;
+        showAnimation: string;
+    };
+    /**
+     * @internal 隐藏loading
+     */
+    dismissLoading: Record<string, never>;
+    /**
+     * @internal 通知APP 收银台已经ready
+     */
+    webAppReady: {
+        source: string;
+    };
+    /**
+     * @internal 通知app 应用已启动
+     */
+    onLaunch: {
+        success: boolean;
+        source: string;
+        target: string;
+    };
+    /**
+     * @internal 收到客户端返回action query的数据和商户的配置
+     */
+    renderComponent: {
+        sessionResult?: Record<string, unknown>;
+    };
+    /**
+     * @internal 心跳事件
+     */
+    appHeartBeat: {
+        success: boolean;
+    };
+    /**
+     * @internal 客户端 展示toast弹窗
+     */
+    showToast: {
+        icon: string;
+        message: string;
+        source: string;
+    };
+    /**
+     * @internal 客户端eventCallback 事件
+     */
+    onEventCallback: {
+        code: string;
+    };
+    /**
+     * @internal 发送回调码事件
+     */
+    onSubmitPayCallback: CallbackReturnData;
+    /**
+     * @internal 重置收银台
+     */
+    reset: Record<string, never>;
+    /**
+     * @internal 销毁收银台
+     */
+    destroy: Record<string, never>;
+    /**
+     * @internal 关闭收银台
+     */
+    onClose: Record<string, never>;
+    /**
+     * @internal 重定向
+     */
+    onRedirect: {
+        normalUrl: string;
+        isDestroy: boolean;
+        needReset: boolean;
+    };
 }
 
 /**
@@ -178,6 +259,8 @@ declare interface AntomErrorResponse {
     extendInfo?: Record<string, any>;
 }
 
+export declare type AntomLayouts = 'tabs' | 'accordion';
+
 /**
  * 给中间页使用的桥接事件类型
  * @internal 内部使用，不暴露到外部
@@ -185,15 +268,13 @@ declare interface AntomErrorResponse {
 export declare interface AntomMiddlePageEventMap extends AntomBridgeEventMap {
     /**
      * @description 3DS流程完成
+     * @deprecated 使用auto_close_modal
      */
     three_ds_end: void;
-}
-
-/**
- * 给modal和webapp页面messagePort使用的桥接事件类型
- * @internal 内部使用，不暴露到外部
- */
-export declare interface AntomModalEventMap extends AntomBridgeEventMap {
+    /**
+     * @description 正常结束自动关闭事件
+     */
+    auto_close_modal: void;
 }
 
 /**
@@ -214,6 +295,11 @@ export declare class AntomSDK extends BaseElementsFactory {
      * @description 更新配置
      */
     updateConfig(config: Partial<BaseFactoryConfig>): void;
+    /**
+     * @internal
+     * @param payload
+     */
+    protected redirect(payload: BaseBridgeEventMap['OPENSDK@REDIRECT']): void | Promise<void>;
     /**
      * @internal
      * 这个方法为内部调用方法
@@ -224,9 +310,11 @@ export declare class AntomSDK extends BaseElementsFactory {
         getContentWindow: () => Window;
     }>;
     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;
@@ -283,6 +371,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";
@@ -299,6 +403,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";
@@ -316,6 +422,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;
@@ -330,15 +438,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';
@@ -751,6 +865,16 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
         merged: AppConfig;
         updated: Partial<AppConfig>;
     };
+    /**
+     * 更新配置时的回复事件，包含可能发生的错误信息。
+     * 如果 error 为 undefined，则表示没有错误发生。
+     */
+    "OPENSDK@UPDATE_CONFIG_REPLY": {
+        /**
+         * 更新配置时发生的错误，如果error为undefined，则表示没有错误发生
+         */
+        error?: ErrorPayload<string>;
+    } | undefined;
     /**
      * @internal 内部事件 不暴露给商户
      */
@@ -789,6 +913,10 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
      * @internal 内部事件 不暴露给商户
      */
     "OPENSDK@TRANSFER_MODAL_APPEARANCE": Appearance;
+    /**
+     * @internal 内部事件 不暴露给商户
+     */
+    "OPENSDK@TRANSFER_MODAL_INITIALDATA": Record<string, any>;
     /**
      * @internal 内部事件 不暴露给商户
      */
@@ -816,6 +944,12 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
      * @internal 内部高度变化，同步到sdk更新iframe
      */
     "OPENSDK@HEIGHT_UPDATE": number;
+    /**
+     * @internal 内部销毁元素，同步到sdk销毁元素
+     */
+    "OPENSDK@DESTROY_ELEMENT": {
+        elementKey: string;
+    };
 }
 
 declare interface BaseConfig {
@@ -840,6 +974,12 @@ declare interface BaseConfig {
      * @internal 不透出到用户
      */
     version: string;
+    /**
+     * @description iframe 的 color-scheme CSS 属性，用于阻止商户页面的 color-scheme 传播到 iframe
+     * 默认值 'light dark'，确保 iframe 透明背景在商户页面设置 color-scheme: dark 时正常工作
+     * @internal 内部使用，不暴露给商户
+     */
+    colorScheme?: string;
 }
 
 /**
@@ -888,6 +1028,8 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
      * @internal 外部不要访问
      */
     private cachedSend;
+    /** Reuses the pending reply for concurrent submit calls. */
+    private submitPromise?;
     constructor(name: string, config: WithAppURL<Config>);
     /**
      * @internal 外部不能直接调用
@@ -899,9 +1041,9 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
      */
     setup(): Promise<Partial<BaseElementAppConfig> | undefined>;
     /**
-     * @param {string | HTMLElement} containerId 如果给字符串id不要带#号
+     * @param {HTMLElement} container
      */
-    mount(containerId: HTMLElement): Promise<void>;
+    mount(container: HTMLElement): Promise<void>;
     /**
      * @description 内部使用，挂载iframe
      * @internal 外部不能直接调用
@@ -911,7 +1053,7 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
      * 更新webapp配置
      * @param {Partial<BaseElementAppConfig>} newConfig
      */
-    updateConfig(newConfig: Partial<Config['appConfig']>): void;
+    updateConfig(newConfig: Partial<Config['appConfig']>): Promise<EventMap["OPENSDK@UPDATE_CONFIG_REPLY"]>;
     /**
      * 卸载元素
      */
@@ -975,20 +1117,28 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
 }
 
 declare interface BaseElementAppConfig {
+    /**
+     * @internal 不透出给商户，统一从loadAntom获取
+     */
     locale?: string;
     /**
-     * @internal 不透出给商户
+     * @internal 不透出给商户，统一从loadAntom获取
      */
     env?: 'sandbox' | 'prod';
     /**
-     * @description 商户的唯一标识
+     * @description 商户的唯一标识，用于监控
      * @internal 不透出到用户
      */
     merchantId?: string;
     [key: string]: any;
 }
 
-declare interface BaseElementConfig<T extends BaseElementAppConfig = Record<string, any>> extends BaseConfig {
+declare interface BaseElementConfig<T extends BaseElementAppConfig = BaseElementAppConfig> extends BaseConfig {
+    /**
+     * @description Session id forwarded to the iframe as the track_id query parameter.
+     * @internal Internal element config only.
+     */
+    trackId?: string;
     appConfig: T;
     elementMode: ElementMode;
 }
@@ -1084,6 +1234,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>;
     /**
      * @description 子类必须实现此方法，返回工厂可用的元素类列表
      * @internal
@@ -1209,6 +1360,10 @@ declare abstract class BaseMainElement<Config extends BaseElementConfig = BaseEl
     _submit(data?: EventMap['OPENSDK@SUBMIT'] | undefined): Promise<EventMap['OPENSDK@SUBMIT_REPLY']>;
 }
 
+/**
+ * @description 打开模态框的配置项。
+ * 包含显示选项、关闭行为、外观设置及初始化数据。
+ */
 declare interface BaseOpenModalConfig {
     /**
      * 无需手动传递，app的唯一scope
@@ -1232,10 +1387,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 = {
@@ -1333,6 +1499,42 @@ declare interface C2PProps {
     merchantTransactionId?: string;
 }
 
+/**
+ * @description native回调错误信息格式
+ * @internal
+ */
+export declare interface CallbackErrorInfo {
+    code: string;
+    message?: string;
+    needChangeSessionForRetry?: boolean;
+    traceId?: string;
+    context?: string;
+}
+
+/**
+ * @description native回调返回数据
+ * @internal
+ */
+export declare interface CallbackReturnData {
+    status?: string;
+    userCanceled3D?: boolean;
+    isExposed?: boolean;
+    error?: CallbackErrorInfo;
+    session?: {
+        nextAction?: CallbackSessionNextAction;
+    };
+}
+
+/**
+ * @description native回调会话下一步操作，包含了回调的url
+ * @internal
+ */
+export declare interface CallbackSessionNextAction {
+    normalUrl?: string;
+    schemeUrl?: string;
+    applinkUrl?: string;
+}
+
 declare interface CardIssuerAuthentication {
     /**
      * @description 卡售卖单元
@@ -1750,7 +1952,7 @@ declare interface CashierSdkActionQueryResult {
     /**
      * @description 物流信息, 包含物流地址和物流费
      */
-    shippingInfo?: ShippingInfo;
+    shippingInfo?: ShippingInfo_2;
     /**
      * @description 用户已绑资产信息
      */
@@ -1783,28 +1985,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
@@ -1830,6 +2010,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 提醒事项
      */
@@ -1846,6 +2031,10 @@ declare interface CodeFormView {
      * @description 码过期时间
      */
     codeExpireTime?: string;
+    /**
+     * @description QR code configuration including renderStyle, centerIcon and cornerIcon
+     */
+    qrcodeConfig?: QrCodeConfig;
 }
 
 /**
@@ -2402,10 +2591,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>;
 }
 
 /**
@@ -2477,6 +2670,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>.
@@ -2521,6 +2721,17 @@ declare interface CustomerFxInfo {
     useMarketPrice?: boolean;
 }
 
+/**
+ * 自定义字体源 — 通过 @font-face 加载自托管字体
+ */
+declare interface CustomFontSource {
+    family: string;
+    src: string;
+    weight?: string;
+    style?: string;
+    unicodeRange?: string;
+}
+
 /**
  * CustomizedPerformanceKey 是给业务使用的自定义指标，共 20 个，页面之间互相独立
  */
@@ -2530,7 +2741,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
      */
@@ -2568,7 +2779,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[];
 };
 
 /**
@@ -2660,6 +2872,10 @@ export declare interface CVVSubmitParams {
      * 重定向策略
      */
     redirect?: 'always' | 'if_required';
+    /**
+     * 集成用户自定义信息（如 cardHolderName）
+     */
+    params?: Record<string, unknown>;
 }
 
 declare interface DanaSofCouponInfo {
@@ -3378,7 +3594,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';
 
@@ -3469,6 +3685,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 {
@@ -3493,12 +3725,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;
@@ -3507,20 +3745,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 */
@@ -3541,6 +3779,15 @@ 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;
+    /** @internal SDK host 侧商户域名，供 Apple Pay merchant validation 使用 */
+    merchantDomain?: string;
+    /** @internal Elements2 历史协议字段，含义同 merchantDomain */
+    doMain?: string;
 }
 
 /** cancel 事件负载 */
@@ -3549,24 +3796,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;
@@ -3574,15 +3851,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;
@@ -3600,84 +3906,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;
     };
-    /** @internal iframe 内容高度变化 */
     contentHeightChanged: {
         height: number;
     };
-    /** @internal PayPal 请求商户创建订单 */
-    'paypal:createOrder': {
+    'OPENSDK@CLICK': {
+        expressPaymentType: string;
+    };
+    'OPENSDK@CLICK_RESOLVE': Record<string, never>;
+    'OPENSDK@PAYPAL_CREATE_ORDER': {
         requestId: string;
     };
-    /** @internal PayPal createOrder 响应 */
-    'paypal:createOrder:reply': {
+    'OPENSDK@PAYPAL_CREATE_ORDER_REPLY': {
         requestId: string;
         sessionData?: string;
         error?: string;
     };
-    /** @internal PayPal 用户变更收货地址 */
-    'paypal:onShippingAddressChange': {
+    'OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE': {
         requestId: string;
         shippingData: any;
     };
-    /** @internal PayPal 收货地址变更响应 */
-    'paypal:onShippingAddressChange:reply': {
+    'OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE_REPLY': {
         requestId: string;
         error?: string;
     };
-    /** @internal PayPal 用户变更配送方式 */
-    'paypal:onShippingOptionsChange': {
+    'OPENSDK@PAYPAL_SHIPPING_OPTIONS_CHANGE': {
         requestId: string;
         shippingData: any;
     };
-    /** @internal PayPal 配送方式变更响应 */
-    'paypal:onShippingOptionsChange:reply': {
+    '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 {
@@ -3702,6 +4007,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 {
@@ -3719,6 +4042,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
@@ -4350,6 +4694,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;
@@ -4517,6 +4869,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;
@@ -7016,6 +7462,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的返回值类型
  */
@@ -7222,6 +7730,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 {
@@ -7243,6 +7801,99 @@ declare interface PayByLinkInfo {
     linkVersion?: number;
 }
 
+/**
+ * @description Payment element app config type
+ */
+export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearance>, BaseElementAppConfig {
+    /**
+     * @description sessionData，无法通过updateConfig更新
+     */
+    sessionData?: string;
+    /**
+     * @internal sdk所在hostname
+     */
+    merchantDomain?: string;
+    /**
+     * @internal 渲染数据
+     */
+    renderData?: CashierSdkActionQueryResult;
+    /**
+     * @internal connect时有这个数据
+     */
+    connectAccount?: OneAccountQueryResult;
+    /**
+     * @internal sessionData解析后的数据
+     */
+    sessionMetaData?: IPaymentSessionMetaData;
+    /**
+     * @internal 渲染数据错误信息
+     */
+    renderDataError?: ErrorPayload;
+    /**
+     * @internal sdk 版本号
+     */
+    sdkVersion?: string;
+    /**
+     * @internal 内部联调使用，生产环境传递无效
+     */
+    _requestConfig?: Partial<Omit<RequestOptions, 'scope' | 'tracker'>>;
+    /**
+     * @internal 内部使用，无需用户传递，用于log日志原数据
+     */
+    logMetaData?: {
+        paymentMethodCategoryType?: PaymentSessionConfig['paymentMethodCategoryType'];
+        productSceneVersion?: PaymentSessionConfig['productSceneVersion'];
+        trackId: string;
+        merchantId?: string;
+        paymentMethodType?: string;
+    };
+    /**
+     * @internal 内部使用，无需用户传递，高度信息
+     */
+    heightOfVisible?: number;
+}
+
+/**
+ * @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);
+    /**
+     * @internal
+     */
+    setup(): Promise<Partial<PaymentAppConfig> | undefined>;
+    /**
+     * @internal
+     */
+    submit(data?: PaymentSubmitParams): Promise<PaymentSubmitResult>;
+    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
@@ -7344,6 +7995,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 支付方式余额检查结果信息
  */
@@ -7406,6 +8087,10 @@ declare interface PaymentMethodView {
      * @description icon
      */
     icon?: string;
+    /**
+     * @description adaptive icon for PAYME payment method
+     */
+    adaptiveIcon?: string;
     /**
      * @description icon对应的名称
      */
@@ -7414,6 +8099,10 @@ declare interface PaymentMethodView {
      * @description 支付方式描述
      */
     description?: string;
+    /**
+     * @description 支付方式点击后的描述
+     */
+    descriptionAfterClick?: string;
     /**
      * @description category
      */
@@ -7548,6 +8237,10 @@ declare interface PaymentMethodView {
      * @description 账单地址收集模式
      */
     billingAddressCollectionMode?: string;
+    /**
+     * @description 分期银行信息列表
+     */
+    supportIppBankList?: FrontSupportIppBank[];
 }
 
 declare interface PaymentOption {
@@ -7615,6 +8308,10 @@ declare interface PaymentOption {
      * @description 支付选项Logo信息
      */
     logo?: Logo;
+    /**
+     * @description 支付描述多语言列表。如果入参有locale，且入参的locale有对应语言，则这里只返回locale对应的语言。
+     */
+    description?: Record<string, string>;
     /**
      * @description extendInfo extendInfo information
      */
@@ -7682,6 +8379,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;
 }
 
 /**
@@ -7791,6 +8495,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 金额,以元为单位的金额
@@ -7909,6 +8652,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 {
@@ -9881,6 +10629,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
@@ -9950,13 +10716,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 = {
@@ -10187,7 +10971,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
      */
@@ -24105,14 +24907,14 @@ 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 = {
-    /**
-     * 查询到的状态
-     */
-    status: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
     /**
      * 查询到的结果码或者错误码, 在SUCCESS无该字段
      * @deprecated 已废弃请读取error中的code
@@ -24125,6 +24927,10 @@ export declare type SubmitResult = {
      * @internal
      */
     message?: string;
+    /**
+     * 查询到的状态
+     */
+    status: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
     /**
      * @description 对结果的详细结果码和结果信息，在status为SUCCESS时无该字段
      */
@@ -24137,6 +24943,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 是否需要更换 session 重试
+         */
+        needChangeSessionForRetry?: boolean;
     };
     /**
      * 是否是用户手动取消3D
@@ -24595,6 +25405,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;
@@ -24939,7 +25759,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[];
 };
 
 /**
@@ -24968,7 +25789,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> {
 }
 
 /**