@alipay/ams-checkout 2.0.21 → 2.0.23

package/esm/plugin/component/channel.d.ts

@@ -1,5 +1,5 @@
-import { type EventPayload, type IPaymentSessionMetaData } from '../../types';
 import type { CKPShipping } from '../../core/component/element/type';
+import { type EventPayload, type IPaymentSessionMetaData } from '../../types';
 import { Logger } from '../../util/logger';
 export type IChannelBehavior = {
     usePaymentSessionAsQueryResult: boolean;

package/esm/plugin/component/channel.js

@@ -17,7 +17,7 @@ import { getDoubleFaUrlFromSession } from "../../foundation/utils/web_app_url_ut
 import { getApplePayPaymentSession, submitPayInfo } from "../../service";
 import { EnvironmentEnum } from "../../types";
 import { device, isEmpty } from "../../util";
-import { executeWithTimeout, BEFORE_CONFIRM_TIMEOUT_MS, MERCHANT_CONFIRM_ABORT_CODE, MERCHANT_CONFIRM_TIMEOUT_CODE } from "../../util/beforeConfirm";
+import { BEFORE_CONFIRM_TIMEOUT_MS, executeWithTimeout, MERCHANT_CONFIRM_ABORT_CODE, MERCHANT_CONFIRM_TIMEOUT_CODE } from "../../util/beforeConfirm";
 import { APPLE_PAY_RECURRING_VERSION, APPLE_PAY_VERSION } from "../applepay/interface";
 var APPLEPAYERRORENUM = /*#__PURE__*/function (APPLEPAYERRORENUM) {
   APPLEPAYERRORENUM["APPLE_PAY_MISSING_DATA"] = "APPLE_PAY_MISSING_DATA";
@@ -92,7 +92,16 @@ export var handleGooglePay = function handleGooglePay(data) {
     var script = document.createElement('script');
     script.src = 'https://pay.google.com/gp/p/js/pay.js';
     script.async = true;
-    document.body.appendChild(script);
+
+    // 当判断条件成立时，代表 document.body.appendChild 方法已经被劫持
+    if (document.body.appendChild !== Node.prototype.appendChild) {
+      // 使用原生 appendChild 避免微前端沙箱（如 qiankun）将动态 <script> 劫持为 fetch 加载，
+      // 导致不支持 CORS 的第三方脚本（如 pay.google.com）加载失败
+      Node.prototype.appendChild.call(document.body, script);
+    } else {
+      document.body.appendChild(script);
+    }
+
     // 执行googlePay sdk
     script.onload = function () {
       var paymentsClient = new window.google.payments.api.PaymentsClient({

package/esm/tsdoc-metadata.json

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

package/esm/util/logger.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "",
   "author": "",
   "exports": {

package/types.d.ts

@@ -313,7 +313,7 @@ export declare const AntomSDKErrorCodes: {
     readonly UPDATE_CONFIG_TIMEOUT: "UPDATE_CONFIG_TIMEOUT";
     readonly UPDATE_CONFIG_NOT_READY: "UPDATE_CONFIG_NOT_READY";
     /**
-     * @description 是否需要更换 session 重试
+     * 查询到的结果消息
      */
     readonly INVALID_MODAL_URL: "INVALID_MODAL_URL";
     readonly LOAD_DEBUGGER_FAILED: "LOAD_DEBUGGER_FAILED";
@@ -629,6 +629,8 @@ declare type AxiosHeaderMatcher =
 | RegExp
 | ((this: AxiosHeaders, value: string, name: string) => boolean);
 
+declare type AxiosHeaderParameters = Record<string, string>;
+
 declare type AxiosHeaderParser = (this: AxiosHeaders, value: AxiosHeaderValue, header: string) => any;
 
 declare class AxiosHeaders {
@@ -644,6 +646,7 @@ declare class AxiosHeaders {
     set(headers?: RawAxiosHeaders | AxiosHeaders | string, rewrite?: boolean): AxiosHeaders;
     set(headers?: Iterable<[string, AxiosHeaderValue]>, rewrite?: boolean): AxiosHeaders;
 
+    get(headerName: string, parser: typeof AxiosHeaders.parseParameters): AxiosHeaderParameters;
     get(headerName: string, parser: RegExp): RegExpExecArray | null;
     get(headerName: string, matcher?: true | AxiosHeaderParser): AxiosHeaderValue;
 
@@ -665,6 +668,8 @@ declare class AxiosHeaders {
 
     static from(thing?: AxiosHeaders | RawAxiosHeaders | string): AxiosHeaders;
 
+    static parseParameters(value: AxiosHeaderValue): AxiosHeaderParameters;
+
     static accessor(header: string | string[]): AxiosHeaders;
 
     static concat(
@@ -767,6 +772,7 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
     /* Excluded from this release type: "OPENSDK@CLOSE_MODAL" */
     /* Excluded from this release type: "OPENSDK@REDIRECT" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_PORT" */
+    /* Excluded from this release type: "OPENSDK@MODAL_TRANSFER_READY" */
     /* 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" */
@@ -905,6 +911,10 @@ declare abstract class BaseElementsFactory extends BaseFactory {
 declare abstract class BaseFactory {
     /* Excluded from this release type: config */
     /* Excluded from this release type: isInit */
+    /**
+     * Indicates whether this factory instance has been destroyed.
+     */
+    isDestroyed: boolean;
     /**
      * @description 当前版本号
      * 用于日志上报
@@ -916,6 +926,7 @@ declare abstract class BaseFactory {
     /* Excluded from this release type: globalBridgeForModal */
     /* Excluded from this release type: openModalHandle */
     /* Excluded from this release type: elementClasses */
+    /* Excluded from this release type: modalIsReady */
     /**
      * @param config 配置
      */
@@ -3161,10 +3172,8 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
      */
     paymentMethods?: string[];
     /* Excluded from this release type: setupError */
-    /**
-     * Locale for internationalization, passed from entry params (loadAntom), default to en_US
-     */
-    locale?: string;
+    /* Excluded from this release type: locale */
+    /* Excluded from this release type: _paypalSdkEnvironment */
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -3252,9 +3261,7 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _paypalOverlay;
     constructor(name: string, config: ExpressElementConfig);
     /**
-     * 重写 on：
-     * 1. 对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
-     * 2. 对 onRedirect 事件同步注册到 _localHandlers（SDK host 主动推送时商户能收到）
+     * 重写 on：对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
      */
     on(event: string, handler: (...args: any[]) => void): void;
     /**
@@ -3275,6 +3282,8 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
             code: string;
             message: string;
         };
+        /** 用户是否手动关闭 3D 弹窗（透传 webapp COMPLETE_PAYMENT_RESULT.userCanceled3D） */
+        userCanceled3D?: boolean;
     }>;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
@@ -3373,6 +3382,14 @@ export declare interface ExpressElementEvents extends AntomBridgeWithNativeEvent
     };
 }
 
+declare type ExpressPaymentMethod = (typeof SUPPORTED_EXPRESS_METHODS)[number];
+
+declare type ExpressSetupError = ErrorPayload & {
+    expressPaymentType?: ExpressPaymentMethod;
+    /** 服务端返回的 errorMessage 已完成国际化，可直接对客展示 */
+    mulityLanguageMapping?: boolean;
+};
+
 declare interface ExpSupportBank {
     /**
      * @description 银行名称
@@ -6672,11 +6689,14 @@ declare interface OneAccountQueryResult {
  */
 declare type OpenModalHandle = {
     destroy: () => void;
-    onLoadedSuccess: (onLoadSuccess: () => void) => void;
+    /**
+     * @deprecated 移除，内部监听ready事件
+     */
+    onLoadedSuccess?: (onLoadSuccess: () => void) => void;
     getContentWindow: () => Window | null;
 };
 
-declare interface OpenModalParams extends BaseOpenModalConfig {
+declare interface OpenModalParams extends Omit<BaseOpenModalConfig, 'hideCloseWhenLoaded'> {
     mode: 'desktop' | 'mobile';
     loadingConfig?: {
         theme?: 'light' | 'dark';
@@ -6891,6 +6911,7 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
      */
     sessionData?: string;
     /* Excluded from this release type: merchantDomain */
+    doMain?: string;
     /* Excluded from this release type: renderData */
     /* Excluded from this release type: connectAccount */
     /* Excluded from this release type: sessionMetaData */
@@ -6899,6 +6920,15 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
     /* Excluded from this release type: _requestConfig */
     /* Excluded from this release type: logMetaData */
     /* Excluded from this release type: heightOfVisible */
+    /**
+     * Amount & Currency
+     *
+     * Only effective via `updateConfig({ amount })` at runtime.
+     */
+    amount?: {
+        currency: string;
+        value: string;
+    };
 }
 
 /**
@@ -6916,8 +6946,13 @@ export declare type PaymentAppearance = PickAppearance<{
  */
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
+    private _paymentInProgress;
     constructor(name: string, config: PaymentElementConfig);
     /* Excluded from this release type: setup */
+    /**
+     * @description Update payment element configuration with amount validation
+     */
+    updateConfig(newConfig: Pick<PaymentAppConfig, 'amount'>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /* Excluded from this release type: submit */
     protected focus(): void;
     protected blur(): void;
@@ -23780,6 +23815,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 接口错误时的链路追踪 id，用于定位排查根因（非错误状态无该字段）
+         */
+        traceId?: string;
         /**
          * @description 是否需要更换 session 重试
          */
@@ -23901,6 +23940,8 @@ declare interface SubscriptionPricePlan {
     pricePlanAmountView?: PaymentView;
 }
 
+declare const SUPPORTED_EXPRESS_METHODS: readonly ["paypal", "applePay", "googlePay", "alipay"];
+
 declare type SvgAttributes =
 | "[-khtml-opacity]"
 | "[-moz-opacity]"
@@ -24252,6 +24293,34 @@ export declare const themeColorMap: Record<AntomTheme, {
     backgroundColor: string;
 }>;
 
+/** Configuration options for rendering a toast notification. */
+export declare interface ToastParams {
+    /** Text displayed in the toast. */
+    message: string;
+    /** Placement of the toast container within the viewport. */
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+    /** Toast background color in any valid CSS color format. */
+    backgroundColor?: string;
+    /** Toast text color in any valid CSS color format. */
+    color?: string;
+    /** Toast padding in any valid CSS length format. */
+    padding?: string;
+    /** Toast border radius in any valid CSS length format. */
+    borderRadius?: string;
+    /** Toast font size in any valid CSS length format. */
+    fontSize?: string;
+    /** Stacking order of the toast container. */
+    zIndex?: number;
+    /** Toast width in any valid CSS length format. */
+    width?: string;
+    /** Time in milliseconds before the toast starts to disappear. */
+    duration?: number;
+    /** Preset status icon displayed above the message. */
+    icon?: 'SUCCESS' | 'FAIL';
+    /** Whether the status icon uses a spinning animation. */
+    spin?: boolean;
+}
+
 /**
  * @description 交易信息
  */

package/types.untrimmed.d.ts

@@ -306,7 +306,6 @@ export declare class AntomSDK extends BaseElementsFactory {
      */
     protected openModal(payload: AntomOpenModalConfig): Promise<{
         destroy: () => void;
-        onLoadedSuccess: (onLoadSuccess: () => void) => void;
         getContentWindow: () => Window;
     }>;
     elements(): Elements;
@@ -406,7 +405,7 @@ export declare const AntomSDKErrorCodes: {
     readonly UPDATE_CONFIG_TIMEOUT: "UPDATE_CONFIG_TIMEOUT";
     readonly UPDATE_CONFIG_NOT_READY: "UPDATE_CONFIG_NOT_READY";
     /**
-     * @description 是否需要更换 session 重试
+     * 查询到的结果消息
      */
     readonly INVALID_MODAL_URL: "INVALID_MODAL_URL";
     readonly LOAD_DEBUGGER_FAILED: "LOAD_DEBUGGER_FAILED";
@@ -722,6 +721,8 @@ declare type AxiosHeaderMatcher =
 | RegExp
 | ((this: AxiosHeaders, value: string, name: string) => boolean);
 
+declare type AxiosHeaderParameters = Record<string, string>;
+
 declare type AxiosHeaderParser = (this: AxiosHeaders, value: AxiosHeaderValue, header: string) => any;
 
 declare class AxiosHeaders {
@@ -737,6 +738,7 @@ declare class AxiosHeaders {
     set(headers?: RawAxiosHeaders | AxiosHeaders | string, rewrite?: boolean): AxiosHeaders;
     set(headers?: Iterable<[string, AxiosHeaderValue]>, rewrite?: boolean): AxiosHeaders;
 
+    get(headerName: string, parser: typeof AxiosHeaders.parseParameters): AxiosHeaderParameters;
     get(headerName: string, parser: RegExp): RegExpExecArray | null;
     get(headerName: string, matcher?: true | AxiosHeaderParser): AxiosHeaderValue;
 
@@ -758,6 +760,8 @@ declare class AxiosHeaders {
 
     static from(thing?: AxiosHeaders | RawAxiosHeaders | string): AxiosHeaders;
 
+    static parseParameters(value: AxiosHeaderValue): AxiosHeaderParameters;
+
     static accessor(header: string | string[]): AxiosHeaders;
 
     static concat(
@@ -898,6 +902,10 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
      * @internal 内部事件 不暴露给商户
      */
     "OPENSDK@TRANSFER_MODAL_PORT": string;
+    /**
+     * @internal 内部事件 不暴露给商户
+     */
+    "OPENSDK@MODAL_TRANSFER_READY": void;
     /**
      * @internal 内部事件 不暴露给商户
      */
@@ -1190,6 +1198,10 @@ declare abstract class BaseFactory {
      * @internal
      */
     private isInit;
+    /**
+     * Indicates whether this factory instance has been destroyed.
+     */
+    isDestroyed: boolean;
     /**
      * @description 当前版本号
      * 用于日志上报
@@ -1224,6 +1236,11 @@ declare abstract class BaseFactory {
      * @internal
      */
     protected elementClasses: Record<string, iBaseElementClass | undefined>;
+    /**
+     * @description modal是否已准备好
+     * @internal
+     */
+    private modalIsReady;
     /**
      * @param config 配置
      */
@@ -3576,11 +3593,13 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
     /**
      * @internal setup 阶段的错误信息，传给 iframe 侧处理
      */
-    setupError?: ErrorPayload;
+    setupError?: ExpressSetupError;
     /**
-     * Locale for internationalization, passed from entry params (loadAntom), default to en_US
+     * @internal Locale is injected from loadAntom and defaults to en_US.
      */
     locale?: string;
+    /** @internal PayPal v6 core script environment injected from the element env. */
+    _paypalSdkEnvironment?: 'sandbox' | 'prod';
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -3670,9 +3689,7 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _paypalOverlay;
     constructor(name: string, config: ExpressElementConfig);
     /**
-     * 重写 on：
-     * 1. 对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
-     * 2. 对 onRedirect 事件同步注册到 _localHandlers（SDK host 主动推送时商户能收到）
+     * 重写 on：对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
      */
     on(event: string, handler: (...args: any[]) => void): void;
     /**
@@ -3693,6 +3710,8 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
             code: string;
             message: string;
         };
+        /** 用户是否手动关闭 3D 弹窗（透传 webapp COMPLETE_PAYMENT_RESULT.userCanceled3D） */
+        userCanceled3D?: boolean;
     }>;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
@@ -3791,6 +3810,14 @@ export declare interface ExpressElementEvents extends AntomBridgeWithNativeEvent
     };
 }
 
+declare type ExpressPaymentMethod = (typeof SUPPORTED_EXPRESS_METHODS)[number];
+
+declare type ExpressSetupError = ErrorPayload & {
+    expressPaymentType?: ExpressPaymentMethod;
+    /** 服务端返回的 errorMessage 已完成国际化，可直接对客展示 */
+    mulityLanguageMapping?: boolean;
+};
+
 declare interface ExpSupportBank {
     /**
      * @description 银行名称
@@ -7090,11 +7117,14 @@ declare interface OneAccountQueryResult {
  */
 declare type OpenModalHandle = {
     destroy: () => void;
-    onLoadedSuccess: (onLoadSuccess: () => void) => void;
+    /**
+     * @deprecated 移除，内部监听ready事件
+     */
+    onLoadedSuccess?: (onLoadSuccess: () => void) => void;
     getContentWindow: () => Window | null;
 };
 
-declare interface OpenModalParams extends BaseOpenModalConfig {
+declare interface OpenModalParams extends Omit<BaseOpenModalConfig, 'hideCloseWhenLoaded'> {
     mode: 'desktop' | 'mobile';
     loadingConfig?: {
         theme?: 'light' | 'dark';
@@ -7315,6 +7345,7 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
      * @internal sdk所在hostname
      */
     merchantDomain?: string;
+    doMain?: string;
     /**
      * @internal 渲染数据
      */
@@ -7353,6 +7384,15 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
      * @internal 内部使用，无需用户传递，高度信息
      */
     heightOfVisible?: number;
+    /**
+     * Amount & Currency
+     *
+     * Only effective via `updateConfig({ amount })` at runtime.
+     */
+    amount?: {
+        currency: string;
+        value: string;
+    };
 }
 
 /**
@@ -7370,11 +7410,16 @@ export declare type PaymentAppearance = PickAppearance<{
  */
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
+    private _paymentInProgress;
     constructor(name: string, config: PaymentElementConfig);
     /**
      * @internal
      */
     setup(): Promise<Partial<PaymentAppConfig> | undefined>;
+    /**
+     * @description Update payment element configuration with amount validation
+     */
+    updateConfig(newConfig: Pick<PaymentAppConfig, 'amount'>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /**
      * @internal
      */
@@ -24250,6 +24295,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 接口错误时的链路追踪 id，用于定位排查根因（非错误状态无该字段）
+         */
+        traceId?: string;
         /**
          * @description 是否需要更换 session 重试
          */
@@ -24371,6 +24420,8 @@ declare interface SubscriptionPricePlan {
     pricePlanAmountView?: PaymentView;
 }
 
+declare const SUPPORTED_EXPRESS_METHODS: readonly ["paypal", "applePay", "googlePay", "alipay"];
+
 declare type SvgAttributes =
 | "[-khtml-opacity]"
 | "[-moz-opacity]"
@@ -24722,6 +24773,34 @@ export declare const themeColorMap: Record<AntomTheme, {
     backgroundColor: string;
 }>;
 
+/** Configuration options for rendering a toast notification. */
+export declare interface ToastParams {
+    /** Text displayed in the toast. */
+    message: string;
+    /** Placement of the toast container within the viewport. */
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+    /** Toast background color in any valid CSS color format. */
+    backgroundColor?: string;
+    /** Toast text color in any valid CSS color format. */
+    color?: string;
+    /** Toast padding in any valid CSS length format. */
+    padding?: string;
+    /** Toast border radius in any valid CSS length format. */
+    borderRadius?: string;
+    /** Toast font size in any valid CSS length format. */
+    fontSize?: string;
+    /** Stacking order of the toast container. */
+    zIndex?: number;
+    /** Toast width in any valid CSS length format. */
+    width?: string;
+    /** Time in milliseconds before the toast starts to disappear. */
+    duration?: number;
+    /** Preset status icon displayed above the message. */
+    icon?: 'SUCCESS' | 'FAIL';
+    /** Whether the status icon uses a spinning animation. */
+    spin?: boolean;
+}
+
 /**
  * @description 交易信息
  */