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

package/types.untrimmed.d.ts

@@ -143,25 +143,138 @@ 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> {
 }
 
 /**
- * 给中间页使用的桥接事件类型
- * @internal 内部使用，不暴露到外部
+ * @description 整合了native事件的eventMap，如果你的业务element需要支持native，事件请继承这个类型
  */
-export declare interface AntomMiddlePageEventMap extends AntomBridgeEventMap {
+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> {
     /**
-     * @description 3DS流程完成
+     * @internal 展示半浮层
      */
-    three_ds_end: void;
+    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;
+    };
+}
+
+/**
+ * @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;
 }
 
 /**
- * 给modal和webapp页面messagePort使用的桥接事件类型
+ * @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>;
+}
+
+export declare type AntomLayouts = 'tabs' | 'accordion';
+
+/**
+ * 给中间页使用的桥接事件类型
  * @internal 内部使用，不暴露到外部
  */
-export declare interface AntomModalEventMap extends AntomBridgeEventMap {
+export declare interface AntomMiddlePageEventMap extends AntomBridgeEventMap {
+    /**
+     * @description 3DS流程完成
+     * @deprecated 使用auto_close_modal
+     */
+    three_ds_end: void;
+    /**
+     * @description 正常结束自动关闭事件
+     */
+    auto_close_modal: void;
 }
 
 /**
@@ -192,9 +305,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;
@@ -203,18 +318,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>;
 }
 
 /**
@@ -224,7 +329,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';
@@ -240,6 +431,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>;
@@ -558,7 +754,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;
 
@@ -656,6 +854,15 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
         merged: AppConfig;
         updated: Partial<AppConfig>;
     };
+    /**
+     * @internal 内部事件 不暴露给商户
+     */
+    "OPENSDK@UPDATE_CONFIG_REPLY": {
+        /**
+         * 更新配置时发生的错误，如果error为undefined，则表示没有错误发生
+         */
+        error?: ErrorPayload<string>;
+    } | undefined;
     /**
      * @internal 内部事件 不暴露给商户
      */
@@ -694,6 +901,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 内部事件 不暴露给商户
      */
@@ -721,6 +932,12 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
      * @internal 内部高度变化，同步到sdk更新iframe
      */
     "OPENSDK@HEIGHT_UPDATE": number;
+    /**
+     * @internal 内部销毁元素，同步到sdk销毁元素
+     */
+    "OPENSDK@DESTORY_ELEMENT": {
+        elementKey: string;
+    };
 }
 
 declare interface BaseConfig {
@@ -804,9 +1021,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 外部不能直接调用
@@ -816,7 +1033,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"]>;
     /**
      * 卸载元素
      */
@@ -880,20 +1097,23 @@ 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 {
     appConfig: T;
     elementMode: ElementMode;
 }
@@ -989,6 +1209,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
@@ -1051,6 +1272,13 @@ declare abstract class BaseFactory {
      * @internal
      */
     protected _removeElement(elementType: string, options?: BaseElementAppConfig): void;
+    /**
+     * @description 删除元素实例
+     * @param {string} elementType 类型
+     * @param {BaseElementConfig} options 选项
+     * @internal
+     */
+    protected _removeElementByKey(key: string): void;
     /**
      * @description 获取元素实例
      * @param {string} elementType 类型
@@ -1114,6 +1342,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
@@ -1137,10 +1369,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 = {
@@ -1238,6 +1481,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 卡售卖单元
@@ -1655,7 +1934,7 @@ declare interface CashierSdkActionQueryResult {
     /**
      * @description 物流信息, 包含物流地址和物流费
      */
-    shippingInfo?: ShippingInfo;
+    shippingInfo?: ShippingInfo_2;
     /**
      * @description 用户已绑资产信息
      */
@@ -1688,28 +1967,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
@@ -1735,6 +1992,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 提醒事项
      */
@@ -1751,6 +2013,10 @@ declare interface CodeFormView {
      * @description 码过期时间
      */
     codeExpireTime?: string;
+    /**
+     * @description QR code configuration including renderStyle, centerIcon and cornerIcon
+     */
+    qrcodeConfig?: QrCodeConfig;
 }
 
 /**
@@ -2473,7 +2739,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;
 };
 
 /**
@@ -3283,7 +3549,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';
 
@@ -3374,6 +3640,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 {
@@ -3403,7 +3685,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;
@@ -3454,19 +3745,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;
 }
 
 /**
@@ -3479,7 +3795,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)
@@ -3489,6 +3836,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;
@@ -3553,36 +3935,146 @@ export declare interface ExpressElementEvents extends AntomBridgeEventMap<Expres
     contentHeightChanged: {
         height: number;
     };
+    /** @internal iframe → host：按钮点击（线上 wire event，仅 expressPaymentType） */
+    'OPENSDK@CLICK': {
+        expressPaymentType: string;
+    };
+    /**
+     * @internal host → iframe：click 事件通知商户后立即发送，继续支付流程
+     */
+    'OPENSDK@CLICK_RESOLVE': Record<string, never>;
     /** @internal PayPal 请求商户创建订单 */
-    'paypal:createOrder': {
+    '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;
     };
+    /** @internal AP/GP 用户授权完成，请求 SDK 提交支付 */
+    'OPENSDK@APGP_SUBMIT': {
+        requestId: string;
+        expressPaymentType: string;
+        paymentData: any;
+        billingDetails?: any;
+        shippingAddress?: any;
+    };
+    /**
+     * @internal SDK 提交支付结果
+     * threeDSHandled=true 表示 host 已在主页面发起 3DS redirect 并开始 polling，
+     * iframe 无需再处理；等 'OPENSDK@APGP_3DS_RESULT' 事件即可
+     */
+    'OPENSDK@APGP_SUBMIT_REPLY': {
+        requestId: string;
+        success: boolean;
+        result?: any;
+        error?: string;
+        threeDSHandled?: boolean;
+    };
+    /**
+     * @internal host 3DS polling 结果 → iframe 侧据此触发 confirm / error / cancel
+     */
+    'OPENSDK@APGP_3DS_RESULT': {
+        expressPaymentType: string;
+        paymentStatus: string;
+        paymentData?: any;
+        billingDetails?: any;
+        shippingAddress?: any;
+        errorCode?: string;
+        errorMessage?: string;
+    };
+    /** @internal host DDC 完成后，把真正的 3DS redirect URL 发给 iframe 弹窗 */
+    'OPENSDK@APGP_3DS_REDIRECT': {
+        expressPaymentType: string;
+        redirectUrl: string;
+        method?: string;
+        bodyData?: Record<string, unknown>;
+    };
+    /** @internal Apple Pay 商户验证请求（Safari 路径，iframe 内 ApplePaySession 触发） */
+    'OPENSDK@APPLE_PAY_VALIDATE_MERCHANT': {
+        requestId: string;
+        validationURL: string;
+        merchantIdentifier?: string;
+        displayName?: string;
+        sessionData?: string;
+    };
+    /** @internal Apple Pay 商户验证结果 */
+    'OPENSDK@APPLE_PAY_VALIDATE_MERCHANT_REPLY': {
+        requestId: string;
+        merchantSession?: any;
+        error?: string;
+    };
+    /**
+     * @internal 非 Safari PC：iframe 把 Apple Pay 整条链路委托给 host 处理
+     * host 在自己 document 上拉起 ApplePaySession（apple-pay-modal QR 弹框不会被 iframe 裁切）
+     */
+    'OPENSDK@GET_APPLE_PAY_TOKEN': {
+        requestId: string;
+        expressPaymentType: string;
+    };
+    /**
+     * @internal host 完成 Apple Pay 全流程后回包给 iframe
+     * threeDSHandled=true 表示 host 已做 3DS redirect + polling，iframe 等 'OPENSDK@APGP_3DS_RESULT'
+     */
+    'OPENSDK@GET_APPLE_PAY_TOKEN_REPLY': {
+        requestId: string;
+        success: boolean;
+        result?: any;
+        errorCode?: string;
+        errorMessage?: string;
+        billingDetails?: any;
+        shippingAddress?: any;
+        threeDSHandled?: boolean;
+    };
+    /**
+     * @internal iframe → host：用户点击 Alipay CN 按钮后，委托 host 提交支付、展码/跳转、轮询
+     * host 完成全流程后通过 OPENSDK@ALIPAY_CN_RESULT 回包，iframe 据此触发 confirm / error / cancel
+     */
+    'OPENSDK@ALIPAY_CN_SUBMIT': {
+        requestId: string;
+    };
+    /**
+     * @internal host → iframe：submit 返回 SHOW_CODE 时，把展码数据发回 iframe
+     * iframe 使用 bridge.openModal 拉起 code-view 页面展示二维码
+     */
+    'OPENSDK@ALIPAY_CN_SHOW_CODE': Record<string, unknown>;
+    /**
+     * @internal host → iframe：AlipayCN 全流程最终结果
+     */
+    'OPENSDK@ALIPAY_CN_RESULT': {
+        paymentStatus: 'SUCCESS' | 'FAIL' | 'CANCELLED';
+        paymentData?: any;
+        errorCode?: string;
+        errorMessage?: string;
+    };
+    /**
+     * @internal iframe → host：updateConfig 处理结果回包
+     */
+    'OPENSDK@UPDATE_CONFIG_REPLY': {
+        error?: ErrorPayload<string>;
+    };
 }
 
 declare interface ExpSupportBank {
@@ -3607,6 +4099,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 {
@@ -3624,6 +4134,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;
@@ -3658,6 +4204,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 {
@@ -4232,6 +4784,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;
@@ -4399,6 +4959,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;
@@ -6848,54 +7502,116 @@ declare interface ObsoletePropertiesHyphen<TLength = (string & {}) | 0, TTime =
      *
      * @deprecated
      */
-    "-webkit-box-lines"?: Property.BoxLines | undefined;
+    "-webkit-box-lines"?: Property.BoxLines | undefined;
+    /**
+     * The **`box-ordinal-group`** CSS property assigns the flexbox's child elements to an ordinal group.
+     *
+     * **Syntax**: `<integer>`
+     *
+     * **Initial value**: `1`
+     *
+     * @deprecated
+     */
+    "-webkit-box-ordinal-group"?: Property.BoxOrdinalGroup | undefined;
+    /**
+     * The **`box-orient`** CSS property sets whether an element lays out its contents horizontally or vertically.
+     *
+     * **Syntax**: `horizontal | vertical | inline-axis | block-axis | inherit`
+     *
+     * **Initial value**: `inline-axis`
+     *
+     * @deprecated
+     */
+    "-webkit-box-orient"?: Property.BoxOrient | undefined;
+    /**
+     * The **`-moz-box-pack`** and **`-webkit-box-pack`** CSS properties specify how a `-moz-box` or `-webkit-box` packs its contents in the direction of its layout. The effect of this is only visible if there is extra space in the box.
+     *
+     * **Syntax**: `start | center | end | justify`
+     *
+     * **Initial value**: `start`
+     *
+     * @deprecated
+     */
+    "-webkit-box-pack"?: Property.BoxPack | undefined;
+}
+
+declare type ObsoletePropertiesHyphenFallback<TLength = (string & {}) | 0, TTime = string & {}> = Fallback<ObsoletePropertiesHyphen<TLength, TTime>>;
+
+declare interface OneAccountInfo {
+    /**
+     * @description accountId
+     */
+    oneAccountId?: string;
+    /**
+     * @description 邮箱
+     */
+    email?: string;
+    /**
+     * @description 账号状态
+     */
+    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;
     /**
-     * The **`box-ordinal-group`** CSS property assigns the flexbox's child elements to an ordinal group.
-     *
-     * **Syntax**: `<integer>`
-     *
-     * **Initial value**: `1`
-     *
-     * @deprecated
+     * @description error message
      */
-    "-webkit-box-ordinal-group"?: Property.BoxOrdinalGroup | undefined;
+    errorMessage?: string;
     /**
-     * The **`box-orient`** CSS property sets whether an element lays out its contents horizontally or vertically.
-     *
-     * **Syntax**: `horizontal | vertical | inline-axis | block-axis | inherit`
-     *
-     * **Initial value**: `inline-axis`
-     *
-     * @deprecated
+     * @description extend info
      */
-    "-webkit-box-orient"?: Property.BoxOrient | undefined;
+    extendInfo?: Record<string, string>;
     /**
-     * The **`-moz-box-pack`** and **`-webkit-box-pack`** CSS properties specify how a `-moz-box` or `-webkit-box` packs its contents in the direction of its layout. The effect of this is only visible if there is extra space in the box.
-     *
-     * **Syntax**: `start | center | end | justify`
-     *
-     * **Initial value**: `start`
-     *
-     * @deprecated
+     * @description one account 账户信息
      */
-    "-webkit-box-pack"?: Property.BoxPack | undefined;
-}
-
-declare type ObsoletePropertiesHyphenFallback<TLength = (string & {}) | 0, TTime = string & {}> = Fallback<ObsoletePropertiesHyphen<TLength, TTime>>;
-
-declare interface OneAccountInfo {
+    accountInfo?: OneAccountInfo;
     /**
-     * @description accountId
+     * @description action form 下一步动作
      */
-    oneAccountId?: string;
+    actionForm?: OtpChallengeActionForm;
     /**
-     * @description 邮箱
+     * @description 支付方式列表
      */
-    email?: string;
+    paymentMethods?: PaymentMethodView[];
     /**
-     * @description 账号状态
+     * @description 物流信息
      */
-    accountStatus?: string;
+    shippings?: ShippingInfo_2[];
+    /**
+     * @description 支付金额 （订单金额 + 物流费）
+     */
+    paymentAmount?: MobileMoneyView;
 }
 
 /**
@@ -6916,6 +7632,49 @@ declare interface OpenModalParams extends BaseOpenModalConfig {
     textDirection?: 'ltr' | 'rtl';
 }
 
+declare class OpenSDKError<Code extends string = string> extends Error {
+    code: Code | OpenSDKInternalErrorCodes;
+    name: string;
+    /**
+     * @internal
+     */
+    protected _openSDKErrorFlag: string;
+    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?;
@@ -7061,6 +7820,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 {
@@ -7082,6 +7891,105 @@ 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;
+    private _submitting;
+    constructor(name: string, config: PaymentElementConfig);
+    /**
+     * @internal
+     */
+    setup(): Promise<Partial<PaymentAppConfig> | undefined>;
+    /**
+     * 更新 webapp 配置，对 amount 字段增加校验。
+     * 其他字段透传基类 updateConfig 不做额外拦截。
+     */
+    updateConfig(newConfig: Partial<PaymentAppConfig>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    /**
+     * @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
@@ -7183,6 +8091,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 支付方式余额检查结果信息
  */
@@ -7245,6 +8183,10 @@ declare interface PaymentMethodView {
      * @description icon
      */
     icon?: string;
+    /**
+     * @description adaptive icon for PAYME payment method
+     */
+    adaptiveIcon?: string;
     /**
      * @description icon对应的名称
      */
@@ -7253,6 +8195,10 @@ declare interface PaymentMethodView {
      * @description 支付方式描述
      */
     description?: string;
+    /**
+     * @description 支付方式点击后的描述
+     */
+    descriptionAfterClick?: string;
     /**
      * @description category
      */
@@ -7387,6 +8333,10 @@ declare interface PaymentMethodView {
      * @description 账单地址收集模式
      */
     billingAddressCollectionMode?: string;
+    /**
+     * @description 分期银行信息列表
+     */
+    supportIppBankList?: FrontSupportIppBank[];
 }
 
 declare interface PaymentOption {
@@ -7454,6 +8404,10 @@ declare interface PaymentOption {
      * @description 支付选项Logo信息
      */
     logo?: Logo;
+    /**
+     * @description 支付描述多语言列表。如果入参有locale，且入参的locale有对应语言，则这里只返回locale对应的语言。
+     */
+    description?: Record<string, string>;
     /**
      * @description extendInfo extendInfo information
      */
@@ -7521,6 +8475,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;
 }
 
 /**
@@ -7630,6 +8591,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 金额,以元为单位的金额
@@ -7748,6 +8744,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 {
@@ -9720,6 +10721,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
@@ -9789,8 +10808,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
@@ -10026,7 +11063,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
      */
@@ -10102,6 +11157,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"
@@ -23940,22 +24999,43 @@ 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和CANCELLED无该字段
+     * 查询到的结果码或者错误码, 在SUCCESS无该字段
+     * @deprecated 已废弃请读取error中的code
+     * @internal
      */
     code?: string;
     /**
-     * 查询到的结果消息, 在SUCCESS和CANCELLED无该字段
+     * 查询到的结果消息, 在SUCCESS无该字段
+     * @deprecated 已废弃请读取error中的message
+     * @internal
      */
     message?: string;
+    /**
+     * 查询到的状态
+     */
+    status: 'SUCCESS' | 'CANCELLED' | 'FAIL' | 'PROCESSING';
+    /**
+     * @description 对结果的详细结果码和结果信息，在status为SUCCESS时无该字段
+     */
+    error?: {
+        /**
+         * 查询到的结果码或者错误码
+         */
+        code?: string;
+        /**
+         * 查询到的结果消息
+         */
+        message?: string;
+    };
     /**
      * 是否是用户手动取消3D
      */
@@ -24413,6 +25493,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;
@@ -24757,7 +25847,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;
 };
 
 /**
@@ -24786,7 +25876,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> {
 }
 
 /**