@alipay/ams-checkout 0.0.1779094014-dev.2 → 0.0.1779094014-dev.21

package/types.d.ts

@@ -143,12 +143,63 @@ 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> {
 }
 
-/* Excluded from this release type: AntomMiddlePageEventMap */
+/**
+ * @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 */
+}
+
+/**
+ * @description Antom的错误基类，直接使用则无错误码校验。
+ */
+declare class AntomError<T extends string = string> extends OpenSDKError<T> {
+    name: string;
+    response?: AntomErrorResponse;
+    static isError(error: unknown): error is AntomError;
+    /**
+     * @description 统一转换error为AntomError
+     */
+    static unificationError(error: unknown, source?: ErrorSource): AntomError;
+}
+
+/**
+ * @description success为false的response
+ */
+declare interface AntomErrorResponse {
+    traceId?: string;
+    errorMessage?: string;
+    errorCode?: string;
+    resultMessage?: string;
+    errorContext?: {
+        errorStack?: {
+            errorName?: string;
+            errorMessage?: string;
+        }[];
+    };
+    success?: false;
+    errorStatus?: 'F' | 'U';
+    extendInfo?: Record<string, any>;
+}
 
-/* Excluded from this release type: AntomModalEventMap */
+export declare type AntomLayouts = 'tabs' | 'accordion';
+
+/* Excluded from this release type: AntomMiddlePageEventMap */
 
 /* Excluded from this release type: AntomOpenModalConfig */
 
@@ -165,9 +216,11 @@ export declare class AntomSDK extends BaseElementsFactory {
     updateConfig(config: Partial<BaseFactoryConfig>): void;
     /* 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;
@@ -176,18 +229,8 @@ export declare class AntomSDK extends BaseElementsFactory {
      * @throws {AntomSDKError} 当无法找到有效的主元素时抛出错误
      */
     private extractMainElement;
-    confirmCardSetup(options: ConfirmCardSetupOptions): Promise<SubmitResult | {
-        code: string;
-        message: string;
-        status: string;
-        userCancel3D: boolean;
-    }>;
-    confirmPayment(options: ConfirmPaymentOptions): Promise<SubmitResult | {
-        code: string;
-        message: string;
-        userCancel3D: boolean;
-        status: string;
-    }>;
+    confirmCardSetup(options: ConfirmCardSetupOptions): Promise<SubmitResult>;
+    confirmPayment(options: ConfirmPaymentOptions): Promise<SubmitResult>;
 }
 
 /**
@@ -197,7 +240,93 @@ export declare interface AntomSDKConfig extends Omit<BaseFactoryConfig, 'version
     version?: string;
 }
 
-export declare type AntomTheme = "default" | "agateGreen" | "night" | "nostalgicGray" | "gamingPurple" | "cherryBlossomPink" | "light";
+export declare class AntomSDKError extends AntomError<AntomSDKErrorCodes> {
+    name: string;
+}
+
+export declare const AntomSDKErrorCodes: {
+    /**
+     * @description 找不到主元素
+     */
+    readonly NOT_FIND_MAINELEMENT: "NOT_FIND_MAINELEMENT";
+    /**
+     * @description sessionData无效
+     */
+    readonly SESSION_DATA_INVALID: "SESSION_DATA_INVALID";
+    /**
+     * @description WebApp 初始化超时
+     */
+    readonly SDK_LAUNCH_PAYMENT_APP_ERROR: "SDK_LAUNCH_PAYMENT_APP_ERROR";
+    /**
+     * @description 参数非法，缺少必填参数或参数值不合法
+     */
+    readonly PARAM_INVALID: "PARAM_INVALID";
+    /**
+     * @description channelClientId 查询接口超时
+     */
+    readonly CHANNEL_CLIENT_ID_QUERY_TIMEOUT: "CHANNEL_CLIENT_ID_QUERY_TIMEOUT";
+    /**
+     * @description channelClientId 查询返回 success=true 但缺少 channelClientId
+     */
+    readonly CHANNEL_CLIENT_ID_MISSING: "CHANNEL_CLIENT_ID_MISSING";
+    /**
+     * @description channelClientId 查询失败（success=false 或其他异常）
+     */
+    readonly CHANNEL_CLIENT_ID_QUERY_FAILED: "CHANNEL_CLIENT_ID_QUERY_FAILED";
+    /**
+     * @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";
+    readonly MOUNT_MISSING_CONTAINER: "MOUNT_MISSING_CONTAINER";
+    readonly MOUNT_IFRAME_LOAD_ERROR: "MOUNT_IFRAME_LOAD_ERROR";
+    readonly MOUNT_NOT_MAINELEMENT_WITH_SINGLE_MODE: "MOUNT_NOT_MAINELEMENT_WITH_SINGLE_MODE";
+    readonly MOUNT_NOT_SUPPORT: "MOUNT_NOT_SUPPORT";
+    readonly MOUNT_INITIAL_FAILED: "MOUNT_INITIAL_FAILED";
+    readonly ELEMENT_INSTANCE_DESTROYED: "ELEMENT_INSTANCE_DESTROYED";
+    readonly ELEMENT_DEFINE_ERROR: "ELEMENT_DEFINE_ERROR";
+    readonly ELEMENT_ALREADY_REGISTERED: "ELEMENT_ALREADY_REGISTERED";
+    readonly CANNOT_CREATE_SAME_ELEMENT_TWICE: "CANNOT_CREATE_SAME_ELEMENT_TWICE";
+    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT";
+    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 INVALID_MODAL_URL: "INVALID_MODAL_URL";
+    readonly LOAD_DEBUGGER_FAILED: "LOAD_DEBUGGER_FAILED";
+    readonly API_MISS_PARAMS: "API_MISS_PARAMS";
+    readonly API_GATEWAY_TIMEOUT: "API_GATEWAY_TIMEOUT";
+    readonly API_SYSTEM_ERROR: "API_SYSTEM_ERROR";
+    readonly API_TIMEOUT: "API_TIMEOUT";
+    readonly API_NOT_LOGIN: "API_NOT_LOGIN";
+    readonly API_GATEWAY_ERROR: "API_GATEWAY_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly NO_PORTS_ERROR: "NO_PORTS_ERROR";
+    readonly INVALID_REDIRECT_URL: "INVALID_REDIRECT_URL";
+};
+
+export declare type AntomSDKErrorCodes = (typeof AntomSDKErrorCodes)[keyof typeof AntomSDKErrorCodes];
+
+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';
 
 declare interface APICallbackOptions {
     requestType: 'fetch' | 'xhr';
@@ -213,6 +342,11 @@ 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>;
@@ -531,7 +665,9 @@ declare class AxiosHeaders {
     ...targets: Array<AxiosHeaders | RawAxiosHeaders | string | undefined | null>
     ): AxiosHeaders;
 
-    toJSON(asStrings?: boolean): RawAxiosHeaders;
+    toJSON(asStrings: true): Record<string, string>;
+    toJSON(asStrings?: false): Record<string, string | string[]>;
+    toJSON(asStrings?: boolean): Record<string, string | string[]>;
 
     static from(thing?: AxiosHeaders | RawAxiosHeaders | string): AxiosHeaders;
 
@@ -617,6 +753,7 @@ 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" */
+    /* Excluded from this release type: "OPENSDK@UPDATE_CONFIG_REPLY" */
     /* Excluded from this release type: "OPENSDK@HANDSHAKE_ACK" */
     /* Excluded from this release type: "OPENSDK@SUBMIT" */
     /* Excluded from this release type: "OPENSDK@SUBMIT_REPLY" */
@@ -626,12 +763,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@DESTORY_ELEMENT" */
 }
 
 declare interface BaseConfig {
@@ -672,15 +811,15 @@ declare abstract class BaseElement<Config extends BaseElementConfig = BaseElemen
     /* 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"]>;
     /**
      * 卸载元素
      */
@@ -713,13 +852,13 @@ 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 {
     appConfig: T;
     elementMode: ElementMode;
 }
@@ -770,6 +909,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 无需手动调用
@@ -801,6 +941,7 @@ declare abstract class BaseFactory {
     /* Excluded from this release type: _createElement */
     /* Excluded from this release type: _addElement */
     /* Excluded from this release type: _removeElement */
+    /* Excluded from this release type: _removeElementByKey */
     /* Excluded from this release type: _getElement */
     /* Excluded from this release type: _getElementSize */
 }
@@ -844,6 +985,10 @@ declare abstract class BaseMainElement<Config extends BaseElementConfig = BaseEl
     /* Excluded from this release type: _submit */
 }
 
+/**
+ * @description 打开模态框的配置项。
+ * 包含显示选项、关闭行为、外观设置及初始化数据。
+ */
 declare interface BaseOpenModalConfig {
     /**
      * 无需手动传递，app的唯一scope
@@ -867,10 +1012,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 = {
@@ -968,6 +1124,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 卡售卖单元
@@ -1385,7 +1547,7 @@ declare interface CashierSdkActionQueryResult {
     /**
      * @description 物流信息, 包含物流地址和物流费
      */
-    shippingInfo?: ShippingInfo;
+    shippingInfo?: ShippingInfo_2;
     /**
      * @description 用户已绑资产信息
      */
@@ -1418,28 +1580,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
@@ -1465,6 +1605,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 提醒事项
      */
@@ -1481,6 +1626,10 @@ declare interface CodeFormView {
      * @description 码过期时间
      */
     codeExpireTime?: string;
+    /**
+     * @description QR code configuration including renderStyle, centerIcon and cornerIcon
+     */
+    qrcodeConfig?: QrCodeConfig;
 }
 
 /**
@@ -2185,7 +2334,7 @@ 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;
 };
 
 /**
@@ -2989,7 +3138,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';
 
@@ -3080,6 +3229,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 {
@@ -3109,7 +3274,16 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
     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).
+     *
+     * `value` must be a positive integer string in **minor currency units** (ISO 4217).
+     * Examples: USD $1.00 → "100", JPY ¥1 → "1", EUR €9.99 → "999"
+     */
     amount?: {
         currency: string;
         value: string;
@@ -3157,19 +3331,44 @@ 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;
+        };
+    };
+    /**
+     * 商户主动拒绝本次支付（如库存不足、价格变动等）。
+     * 调用后 SDK 立即取消支付流程，confirmPayment() 无需调用。
+     */
+    paymentFailed: () => void;
 }
 
 /**
@@ -3182,7 +3381,38 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
      * Store all function-type callbacks locally, not involved in postMessage serialization
      */
     private _callbacks;
+    /** AP/GP 渲染数据（setup 阶段从 sdkQuery 拉取，host 端 Apple Pay handler 需要用） */
+    private _renderData;
+    private _hostSign;
+    /** AlipayCN QR modal destroy function (from openModal utility) */
+    private _alipayCnModalDestroy;
+    /** AlipayCN 轮询定时器 */
+    private _alipayCnPollingTimer;
+    /** Guard flag: false after cancel/timeout so in-flight poll callbacks become no-ops */
+    private _alipayCnPollingActive;
+    /** 支付流程进行中标志（click → confirm/error/cancel 之间） */
+    private _paymentInProgress;
+    /** completePayment 传入的 redirect 参数，用于控制 submit 后是否跳转 */
+    private _redirect;
     constructor(name: string, config: ExpressElementConfig);
+    /**
+     * 重写 on：对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
+     */
+    on(event: string, handler: (...args: any[]) => void): void;
+    updateConfig(newConfig: Pick<ExpressAppConfig, 'amount'>): Promise<ExpressElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    /**
+     * 商户在 confirm 回调内调用，触发实际支付提交。
+     * iframe 收到 OPENSDK@COMPLETE_PAYMENT 后执行 submitPay / polling 等，
+     * 完成后通过 OPENSDK@COMPLETE_PAYMENT_RESULT 回包，Promise resolve。
+     */
+    completePayment(redirect?: 'always' | 'if_required'): Promise<{
+        success: boolean;
+        result?: any;
+        error?: {
+            code: string;
+            message: string;
+        };
+    }>;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     /**
      * Register internal event listeners (iframe communication)
@@ -3192,6 +3422,41 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _showOverlay;
     private _hideOverlay;
     private registerInternalListeners;
+    /**
+     * Open the AlipayCN QR modal via openModal() (host-document-level, not clipped by iframe).
+     * The modal renders the alipaycn-code-view React page which uses the QrCodeOtc/CodeOrText component.
+     * Polling stays here in the host; the modal is destroyed programmatically when a terminal status arrives.
+     */
+    private _handleAlipayCnQrcodeAtHost;
+    private _closeAlipayCnModal;
+    /**
+     * 轮询 inquiryPaymentBySession，每 2s 一次，最多 150 次（5 分钟）
+     * 支付到达终态后关闭 modal，通过 OPENSDK@ALIPAY_CN_RESULT 通知 iframe
+     */
+    private _startAlipayCnPolling;
+    private _stopAlipayCnPolling;
+    /**
+     * host 端跑完整 Apple Pay 流程（对齐原版 ApplePayLaunchSpecificPaymentMethodHandler 内的 ApplePayService）
+     * - 加载 apple-pay-sdk.js（注入到 host document）
+     * - new ApplePaySession(version, request)
+     * - onvalidatemerchant: 直接调 getApplePayPaymentSession（不走 bridge）
+     * - onpaymentauthorized: 调 submitPayInfo 拿到下单结果 → completePayment(SUCCESS/FAILURE)
+     *   并把结果通过 bridge 回包给 iframe（iframe 走 confirm 或 3DS）
+     * - oncancel: 取消事件回包给 iframe
+     */
+    private _handleApplePayAtHost;
+    /**
+     * 从 sessionData 解析 recurringInfo，构造 Apple Pay recurringPaymentRequest。
+     * 订阅数据只在 sessionData.paymentSessionFactor 里，renderData 不含此字段。
+     * 非订阅场景返回 null。
+     */
+    private _buildRecurringPaymentRequest;
+    /**
+     * 3DS redirect 后在 host 侧轮询 inquiryPaymentBySession
+     * 结果出来后通过 OPENSDK@APGP_3DS_RESULT 下发 iframe，iframe 再触发商户事件
+     * 每 2s 轮询，最多 150 次（5 分钟）
+     */
+    private _startThreeDSPolling;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;
@@ -3253,12 +3518,26 @@ export declare interface ExpressElementEvents extends AntomBridgeEventMap<Expres
         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" */
+    /* Excluded from this release type: "OPENSDK@CLICK" */
+    /* Excluded from this release type: "OPENSDK@CLICK_RESOLVE" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_CREATE_ORDER" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_CREATE_ORDER_REPLY" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_SHIPPING_ADDRESS_CHANGE_REPLY" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_SHIPPING_OPTIONS_CHANGE" */
+    /* Excluded from this release type: "OPENSDK@PAYPAL_SHIPPING_OPTIONS_CHANGE_REPLY" */
+    /* Excluded from this release type: "OPENSDK@APGP_SUBMIT" */
+    /* Excluded from this release type: "OPENSDK@APGP_SUBMIT_REPLY" */
+    /* Excluded from this release type: "OPENSDK@APGP_3DS_RESULT" */
+    /* Excluded from this release type: "OPENSDK@APGP_3DS_REDIRECT" */
+    /* Excluded from this release type: "OPENSDK@APPLE_PAY_VALIDATE_MERCHANT" */
+    /* Excluded from this release type: "OPENSDK@APPLE_PAY_VALIDATE_MERCHANT_REPLY" */
+    /* Excluded from this release type: "OPENSDK@GET_APPLE_PAY_TOKEN" */
+    /* Excluded from this release type: "OPENSDK@GET_APPLE_PAY_TOKEN_REPLY" */
+    /* Excluded from this release type: "OPENSDK@ALIPAY_CN_SUBMIT" */
+    /* Excluded from this release type: "OPENSDK@ALIPAY_CN_SHOW_CODE" */
+    /* Excluded from this release type: "OPENSDK@ALIPAY_CN_RESULT" */
+    /* Excluded from this release type: "OPENSDK@UPDATE_CONFIG_REPLY" */
 }
 
 declare interface ExpSupportBank {
@@ -3283,6 +3562,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 {
@@ -3300,6 +3597,42 @@ declare interface FirstPhaseSubscriptionDetail {
     promotionDetails?: PromotionDetail[];
 }
 
+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
+     */
+    id: string;
+    /**
+     * 多语言文案的默认值
+     */
+    dm?: string;
+    /**
+     * 多语言文案的默认值，defaultMessage 和 dm 只需要一个就行
+     * 推荐使用 dm
+     * defaultMessage 是为了兼容中后台原来的开发习惯
+     */
+    defaultMessage?: string;
+};
+
 declare function getMiniPerformance(): Promise<{
     performance: {
         appLaunch: number;
@@ -3334,6 +3667,12 @@ declare interface GetWhiteScreenInfoOptions {
     ignoreNotInViewport?: boolean;
 }
 
+declare type GlobalOptions = {
+    i18n?: SimpleI18n;
+    i18nPrefix: string;
+    getDefaultMessage?: () => string;
+};
+
 declare type Globals = "-moz-initial" | "inherit" | "initial" | "revert" | "revert-layer" | "unset";
 
 declare interface Goods {
@@ -3908,6 +4247,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;
@@ -4075,6 +4422,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;
@@ -6574,6 +7015,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的返回值类型
  */
@@ -6592,6 +7095,46 @@ declare interface OpenModalParams extends BaseOpenModalConfig {
     textDirection?: 'ltr' | 'rtl';
 }
 
+declare class OpenSDKError<Code extends string = string> extends Error {
+    code: Code | OpenSDKInternalErrorCodes;
+    name: string;
+    /* Excluded from this release type: _openSDKErrorFlag */
+    source: ErrorSource;
+    traceId?: string;
+    /**
+     * @description 用于存储原始错误信息的，给内部调试
+     */
+    reason: string;
+    static isError(error: any): error is OpenSDKError;
+    /**
+     * @description 统一转换error为OpenSDKError
+     */
+    static unificationError(error: unknown, source?: ErrorSource): OpenSDKError;
+    static initConfig(config: Partial<GlobalOptions>): void;
+    constructor(_message: string | {
+        message: string;
+        params?: Record<string, any>;
+    }, code: Code | OpenSDKInternalErrorCodes, source: ErrorSource, _traceId?: string, serverAPIWithoutI18n?: boolean);
+    toJSON(): ErrorPayload<Code | OpenSDKInternalErrorCodes>;
+}
+
+declare const OpenSDKInternalErrorCodes: {
+    /**
+     * @description 未知错误
+     */
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    /**
+     * @description 无端口错误，通常发生在模态通信中，SDK期望接收一个MessagePort但未收到
+     */
+    readonly NO_PORTS_ERROR: "NO_PORTS_ERROR";
+    /**
+     * @description 非法的URL
+     */
+    readonly INVALID_REDIRECT_URL: "INVALID_REDIRECT_URL";
+};
+
+declare type OpenSDKInternalErrorCodes = (typeof OpenSDKInternalErrorCodes)[keyof typeof OpenSDKInternalErrorCodes];
+
 declare class OpenSDKTracker {
     private options?;
     private tracker?;
@@ -6737,6 +7280,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 {
@@ -6758,6 +7351,66 @@ 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;
+    private _submitting;
+    constructor(name: string, config: PaymentElementConfig);
+    /* Excluded from this release type: setup */
+    /**
+     * 更新 webapp 配置，对 amount 字段增加校验。
+     * 其他字段透传基类 updateConfig 不做额外拦截。
+     */
+    updateConfig(newConfig: Partial<PaymentAppConfig>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    /* 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
@@ -6859,6 +7512,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 支付方式余额检查结果信息
  */
@@ -6921,6 +7604,10 @@ declare interface PaymentMethodView {
      * @description icon
      */
     icon?: string;
+    /**
+     * @description adaptive icon for PAYME payment method
+     */
+    adaptiveIcon?: string;
     /**
      * @description icon对应的名称
      */
@@ -6929,6 +7616,10 @@ declare interface PaymentMethodView {
      * @description 支付方式描述
      */
     description?: string;
+    /**
+     * @description 支付方式点击后的描述
+     */
+    descriptionAfterClick?: string;
     /**
      * @description category
      */
@@ -7063,6 +7754,10 @@ declare interface PaymentMethodView {
      * @description 账单地址收集模式
      */
     billingAddressCollectionMode?: string;
+    /**
+     * @description 分期银行信息列表
+     */
+    supportIppBankList?: FrontSupportIppBank[];
 }
 
 declare interface PaymentOption {
@@ -7130,6 +7825,10 @@ declare interface PaymentOption {
      * @description 支付选项Logo信息
      */
     logo?: Logo;
+    /**
+     * @description 支付描述多语言列表。如果入参有locale，且入参的locale有对应语言，则这里只返回locale对应的语言。
+     */
+    description?: Record<string, string>;
     /**
      * @description extendInfo extendInfo information
      */
@@ -7197,6 +7896,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;
 }
 
 /**
@@ -7306,6 +8012,41 @@ 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 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 金额,以元为单位的金额
@@ -7424,6 +8165,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 {
@@ -9396,6 +10142,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
@@ -9465,8 +10229,26 @@ 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
@@ -9702,7 +10484,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
      */
@@ -9778,6 +10578,10 @@ export declare interface ShippingResolveOptions {
     }>;
 }
 
+declare type SimpleI18n = {
+    get(id: GetI18nQueryParam, variable?: Record<string, any>, localeCode?: string): string;
+};
+
 declare type SimplePseudos =
 | ":-khtml-any-link"
 | ":-moz-any-link"
@@ -23616,22 +24420,33 @@ 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';
     /**
-     * 查询到的结果码或者错误码, 在SUCCESS和CANCELLED无该字段
-     */
-    code?: string;
-    /**
-     * 查询到的结果消息, 在SUCCESS和CANCELLED无该字段
+     * @description 对结果的详细结果码和结果信息，在status为SUCCESS时无该字段
      */
-    message?: string;
+    error?: {
+        /**
+         * 查询到的结果码或者错误码
+         */
+        code?: string;
+        /**
+         * 查询到的结果消息
+         */
+        message?: string;
+    };
     /**
      * 是否是用户手动取消3D
      */
@@ -24089,6 +24904,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;
@@ -24418,7 +25243,7 @@ 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;
 };
 
 /**
@@ -24441,7 +25266,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> {
 }
 
 /**