@alipay/ams-checkout 0.0.1776167402-dev.0 → 0.0.1776167402-dev.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "0.0.1776167402-dev.0",
+  "version": "0.0.1776167402-dev.2",
   "description": "",
   "author": "",
   "exports": {

package/types.d.ts

@@ -368,19 +368,6 @@ declare interface ApplePayProps {
     paymentRequest?: ApplePaymentModel;
 }
 
-/**
- * @public
- * @description onApprove callback parameter
- */
-export declare interface ApproveData {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Raw data returned by payment method */
-    data?: Record<string, any>;
-    /** Shipping address (if collectShippingAddress is true) */
-    shippingAddress?: Record<string, any>;
-}
-
 /**
  * @description googlePay risk check
  */
@@ -1545,6 +1532,28 @@ 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
@@ -3219,8 +3228,8 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
         currency: string;
         value: string;
     };
-    /** PayPal payment configuration */
-    paypalConfig?: PayPalConfig;
+    /** PayPal 配置 */
+    paypal?: PayPalConfig;
     /**
      * Button text type (following Stripe Express Checkout Element design)
      * Each payment method can independently set the button display text
@@ -3249,21 +3258,29 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
      * @example ['paypal']
      */
     paymentMethods?: string[];
-    /** Lifecycle callbacks */
-    hooks?: ExpressHooks;
 }
 
-/**
- * @public
- * @description onCancel callback parameter
- */
-export declare interface ExpressCancelInfo {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Raw data returned by payment method (PayPal SDK return content, fully passed through) */
+/** cancel 事件负载 */
+export declare interface ExpressCancelEvent {
+    expressPaymentType: string;
     data?: any;
 }
 
+/** click 事件负载 */
+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;
+}
+
 /**
  * @public
  * @description Express element - express checkout element, supports PayPal / Apple Pay / Google Pay
@@ -3302,62 +3319,55 @@ export declare interface ExpressElementConfig extends BaseElementConfig<ExpressA
  */
 export declare interface ExpressElementEvents extends AntomBridgeEventMap<ExpressAppConfig> {
     /**
-     * @description Element ready event
+     * @description Element ready event — 上报可用支付方式
      */
-    ready: ExpressReadyInfo;
+    ready: {
+        availablePaymentMethods: Record<string, boolean>;
+    };
     /**
-     * @description Payment authorization success event
+     * @description 用户点击按钮 — 商户必须调用 event.resolve() 后 sheet 才弹出
+     * 对 PayPal: resolve 为 no-op（PayPal 自行弹出 popup）
      */
-    approve: ApproveData;
+    click: ExpressClickEvent;
     /**
-     * @description Payment error event
+     * @description 统一支付完成事件（替代 approve）
+     * 用户授权完成后触发，通过 expressPaymentType 区分钱包类型
      */
-    paymentError: ExpressErrorData;
+    confirm: ExpressConfirmData;
     /**
-     * @description User cancelled payment event
+     * @description 支付错误事件（扩展基类 ErrorPayload，新增 expressPaymentType）
      */
-    cancel: ExpressCancelInfo;
+    error: ErrorPayload & {
+        expressPaymentType: string;
+    };
     /**
-     * @description Payment button click event
+     * @description 用户取消支付
      */
-    click: void;
-}
-
-/**
- * @public
- * @description onError callback parameter
- */
-export declare interface ExpressErrorData {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Error code */
-    code: string;
-    /** Error message */
-    message: string;
-}
-
-/**
- * @public
- * @description Express Element lifecycle hooks
- */
-export declare interface ExpressHooks {
-    /** Element initialization ready callback */
-    onReady?: (info: ExpressReadyInfo) => void;
-    /** Payment authorization success callback */
-    onApprove?: (data: ApproveData) => void;
-    /** Payment error callback */
-    onError?: (error: ExpressErrorData) => void;
-    /** User cancelled payment callback */
-    onCancel?: (info: ExpressCancelInfo) => void;
-}
-
-/**
- * @public
- * @description onReady callback parameter
- */
-export declare interface ExpressReadyInfo {
-    /** List of currently available payment methods */
-    availablePaymentMethods: string[];
+    cancel: ExpressCancelEvent;
+    /**
+     * @description 用户在 sheet 内变更收货地址（AP/GP only，PayPal 不触发）
+     */
+    shippingaddresschange: {
+        expressPaymentType: string;
+        address: any;
+        resolve: (options: ShippingResolveOptions) => void;
+        reject: (reason: string) => void;
+    };
+    /**
+     * @description 用户在 sheet 内变更配送方式（AP/GP only，PayPal 不触发）
+     */
+    shippingratechange: {
+        expressPaymentType: string;
+        shippingRate: any;
+        resolve: (options: RateResolveOptions) => void;
+    };
+    /* Excluded from this release type: contentHeightChanged */
+    /* Excluded from this release type: "paypal:createOrder" */
+    /* Excluded from this release type: "paypal:createOrder:reply" */
+    /* Excluded from this release type: "paypal:onShippingAddressChange" */
+    /* Excluded from this release type: "paypal:onShippingAddressChange:reply" */
+    /* Excluded from this release type: "paypal:onShippingOptionsChange" */
+    /* Excluded from this release type: "paypal:onShippingOptionsChange:reply" */
 }
 
 declare interface ExpSupportBank {
@@ -9601,6 +9611,14 @@ declare interface RateInfo {
     rate?: Rate;
 }
 
+/** shippingratechange 事件 resolve 参数 */
+export declare interface RateResolveOptions {
+    lineItems?: Array<{
+        name: string;
+        amount: string;
+    }>;
+}
+
 declare interface RawAxiosHeaders {
     [key: string]: AxiosHeaderValue;
 }
@@ -9919,6 +9937,19 @@ declare interface ShippingInfo {
     deliveryEstimate?: DeliveryEstimate;
 }
 
+/** shippingaddresschange 事件 resolve 参数 */
+export declare interface ShippingResolveOptions {
+    shippingRates?: Array<{
+        id: string;
+        displayName: string;
+        amount: string;
+    }>;
+    lineItems?: Array<{
+        name: string;
+        amount: string;
+    }>;
+}
+
 declare type SimpleI18n = {
     get(id: GetI18nQueryParam, variable?: Record<string, any>, localeCode?: string): string;
 };

package/types.untrimmed.d.ts

@@ -395,19 +395,6 @@ declare interface ApplePayProps {
     paymentRequest?: ApplePaymentModel;
 }
 
-/**
- * @public
- * @description onApprove callback parameter
- */
-export declare interface ApproveData {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Raw data returned by payment method */
-    data?: Record<string, any>;
-    /** Shipping address (if collectShippingAddress is true) */
-    shippingAddress?: Record<string, any>;
-}
-
 /**
  * @description googlePay risk check
  */
@@ -1812,6 +1799,28 @@ 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
@@ -3510,8 +3519,8 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
         currency: string;
         value: string;
     };
-    /** PayPal payment configuration */
-    paypalConfig?: PayPalConfig;
+    /** PayPal 配置 */
+    paypal?: PayPalConfig;
     /**
      * Button text type (following Stripe Express Checkout Element design)
      * Each payment method can independently set the button display text
@@ -3540,21 +3549,29 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
      * @example ['paypal']
      */
     paymentMethods?: string[];
-    /** Lifecycle callbacks */
-    hooks?: ExpressHooks;
 }
 
-/**
- * @public
- * @description onCancel callback parameter
- */
-export declare interface ExpressCancelInfo {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Raw data returned by payment method (PayPal SDK return content, fully passed through) */
+/** cancel 事件负载 */
+export declare interface ExpressCancelEvent {
+    expressPaymentType: string;
     data?: any;
 }
 
+/** click 事件负载 */
+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;
+}
+
 /**
  * @public
  * @description Express element - express checkout element, supports PayPal / Apple Pay / Google Pay
@@ -3593,62 +3610,82 @@ export declare interface ExpressElementConfig extends BaseElementConfig<ExpressA
  */
 export declare interface ExpressElementEvents extends AntomBridgeEventMap<ExpressAppConfig> {
     /**
-     * @description Element ready event
+     * @description Element ready event — 上报可用支付方式
      */
-    ready: ExpressReadyInfo;
+    ready: {
+        availablePaymentMethods: Record<string, boolean>;
+    };
     /**
-     * @description Payment authorization success event
+     * @description 用户点击按钮 — 商户必须调用 event.resolve() 后 sheet 才弹出
+     * 对 PayPal: resolve 为 no-op（PayPal 自行弹出 popup）
      */
-    approve: ApproveData;
+    click: ExpressClickEvent;
     /**
-     * @description Payment error event
+     * @description 统一支付完成事件（替代 approve）
+     * 用户授权完成后触发，通过 expressPaymentType 区分钱包类型
      */
-    paymentError: ExpressErrorData;
+    confirm: ExpressConfirmData;
     /**
-     * @description User cancelled payment event
+     * @description 支付错误事件（扩展基类 ErrorPayload，新增 expressPaymentType）
      */
-    cancel: ExpressCancelInfo;
+    error: ErrorPayload & {
+        expressPaymentType: string;
+    };
     /**
-     * @description Payment button click event
+     * @description 用户取消支付
      */
-    click: void;
-}
-
-/**
- * @public
- * @description onError callback parameter
- */
-export declare interface ExpressErrorData {
-    /** Payment method identifier */
-    paymentMethod: string;
-    /** Error code */
-    code: string;
-    /** Error message */
-    message: string;
-}
-
-/**
- * @public
- * @description Express Element lifecycle hooks
- */
-export declare interface ExpressHooks {
-    /** Element initialization ready callback */
-    onReady?: (info: ExpressReadyInfo) => void;
-    /** Payment authorization success callback */
-    onApprove?: (data: ApproveData) => void;
-    /** Payment error callback */
-    onError?: (error: ExpressErrorData) => void;
-    /** User cancelled payment callback */
-    onCancel?: (info: ExpressCancelInfo) => void;
-}
-
-/**
- * @public
- * @description onReady callback parameter
- */
-export declare interface ExpressReadyInfo {
-    /** List of currently available payment methods */
-    availablePaymentMethods: string[];
+    cancel: ExpressCancelEvent;
+    /**
+     * @description 用户在 sheet 内变更收货地址（AP/GP only，PayPal 不触发）
+     */
+    shippingaddresschange: {
+        expressPaymentType: string;
+        address: any;
+        resolve: (options: ShippingResolveOptions) => void;
+        reject: (reason: string) => void;
+    };
+    /**
+     * @description 用户在 sheet 内变更配送方式（AP/GP only，PayPal 不触发）
+     */
+    shippingratechange: {
+        expressPaymentType: string;
+        shippingRate: any;
+        resolve: (options: RateResolveOptions) => void;
+    };
+    /** @internal iframe 内容高度变化 */
+    contentHeightChanged: {
+        height: number;
+    };
+    /** @internal PayPal 请求商户创建订单 */
+    'paypal:createOrder': {
+        requestId: string;
+    };
+    /** @internal PayPal createOrder 响应 */
+    'paypal:createOrder:reply': {
+        requestId: string;
+        sessionData?: string;
+        error?: string;
+    };
+    /** @internal PayPal 用户变更收货地址 */
+    'paypal:onShippingAddressChange': {
+        requestId: string;
+        shippingData: any;
+    };
+    /** @internal PayPal 收货地址变更响应 */
+    'paypal:onShippingAddressChange:reply': {
+        requestId: string;
+        error?: string;
+    };
+    /** @internal PayPal 用户变更配送方式 */
+    'paypal:onShippingOptionsChange': {
+        requestId: string;
+        shippingData: any;
+    };
+    /** @internal PayPal 配送方式变更响应 */
+    'paypal:onShippingOptionsChange:reply': {
+        requestId: string;
+        error?: string;
+    };
 }
 
 declare interface ExpSupportBank {
@@ -9895,6 +9932,14 @@ declare interface RateInfo {
     rate?: Rate;
 }
 
+/** shippingratechange 事件 resolve 参数 */
+export declare interface RateResolveOptions {
+    lineItems?: Array<{
+        name: string;
+        amount: string;
+    }>;
+}
+
 declare interface RawAxiosHeaders {
     [key: string]: AxiosHeaderValue;
 }
@@ -10213,6 +10258,19 @@ declare interface ShippingInfo {
     deliveryEstimate?: DeliveryEstimate;
 }
 
+/** shippingaddresschange 事件 resolve 参数 */
+export declare interface ShippingResolveOptions {
+    shippingRates?: Array<{
+        id: string;
+        displayName: string;
+        amount: string;
+    }>;
+    lineItems?: Array<{
+        name: string;
+        amount: string;
+    }>;
+}
+
 declare type SimpleI18n = {
     get(id: GetI18nQueryParam, variable?: Record<string, any>, localeCode?: string): string;
 };