@alipay/ams-checkout 0.0.1748327361-dev.0 → 0.0.1748918972-dev.1

package/esm/foundation/service/container/index.js

@@ -11,7 +11,7 @@ import { isEmpty } from "../../../util";
 import { addInlineLoading, createInlineBaseElement } from "../../../component/component.inline.style";
 import { addPopupLoading, createBaseElement } from "../../../component/component.popup.style";
 import { insertStyleSheet } from "../../../component/popupWindow.style";
-import { COMPONENT_CLOSE_BLOCK_ID, COMPONENT_CLOSE_MASK_BLOCK_ID, COMPONENT_CONTAINER_ID, ERRORMESSAGE, EVENT, LOADING_ID, MOCKUP_ID, TIMEOUT_WEB_APP_HEART_BEAT, TIME_DELAY_SEND_HEART_BEAT } from "../../../constant";
+import { COMPONENT_CLOSE_BLOCK_ID, COMPONENT_CLOSE_MASK_BLOCK_ID, COMPONENT_CONTAINER_ID, ERRORMESSAGE, EVENT, LOADING_ID, MOCKUP_ID, TIMEOUT_WEB_APP_HEART_BEAT, TIME_DELAY_SEND_HEART_BEAT, closeImg, closeImgLight } from "../../../constant";
 import { DisplayTypeEnum, ProductSceneEnum } from "../../../types";
 import { ServiceProvider } from "../index";
 import { PopupManager } from "./popup";
@@ -35,6 +35,8 @@ export var ContainerService = /*#__PURE__*/function () {
     _defineProperty(this, "displayInfo", void 0);
     _defineProperty(this, "webApp", void 0);
     _defineProperty(this, "_webAppHeartBeatTimeoutFn", void 0);
+    _defineProperty(this, "clientHeight", void 0);
+    _defineProperty(this, "boundFocusResizeChange", void 0);
     // if this variable is true, SDK will invoke listener instead of showing loading
     _defineProperty(this, "customizedLoadingListener", void 0);
   }
@@ -46,6 +48,7 @@ export var ContainerService = /*#__PURE__*/function () {
     value: function init(initOptions, instanceId, sdkMetaData) {
       this.instanceId = instanceId;
       this.sdkMetaData = sdkMetaData;
+      this.clientHeight = Math.max(window.innerHeight, window.visualViewport.height);
       this.eventCenter = ServiceProvider.getInstance(instanceId).getService('EventCenter');
       this.logService = ServiceProvider.getInstance(instanceId).getService('Log');
       this.popupManager = new PopupManager();
@@ -55,6 +58,8 @@ export var ContainerService = /*#__PURE__*/function () {
         this.addCapabilityToEventCenter();
       }
       this.addCapabilityToApiBusManager();
+      // bind会返回一个新的方法，init时记录上这个focus，不然window.addEventListener时this指向会变成window
+      this.boundFocusResizeChange = this.focusResizeChange.bind(this);
     }
   }, {
     key: "update",
@@ -156,6 +161,22 @@ export var ContainerService = /*#__PURE__*/function () {
         container === null || container === void 0 || container.classList.add("".concat(COMPONENT_CONTAINER_ID, "-hidden-").concat(this.displayInfo.platform));
       }
     }
+  }, {
+    key: "handleAccountFocus",
+    value: function handleAccountFocus(focus) {
+      var _window$visualViewpor, _window;
+      // 失焦时v2会走默认的sizeChange还原高度，这里仅移除监听
+      (_window$visualViewpor = window.visualViewport) === null || _window$visualViewpor === void 0 || _window$visualViewpor.removeEventListener('resize', this.boundFocusResizeChange);
+      (_window = window) === null || _window === void 0 || _window.removeEventListener('resize', this.boundFocusResizeChange);
+      // 只有聚焦才监听，失焦后移除，避免影响别的场景
+      if (focus) {
+        var _window$visualViewpor2;
+        // 监听页面visualViewport的高度变化，适用于主流机型更精准获取当前页面高度
+        (_window$visualViewpor2 = window.visualViewport) === null || _window$visualViewpor2 === void 0 || _window$visualViewpor2.addEventListener('resize', this.boundFocusResizeChange);
+        // 兼容visualViewport处理不到的场景，一般存在于老版本浏览器
+        window.addEventListener('resize', this.boundFocusResizeChange);
+      }
+    }
   }, {
     key: "addCapabilityToEventCenter",
     value: function addCapabilityToEventCenter() {
@@ -174,19 +195,7 @@ export var ContainerService = /*#__PURE__*/function () {
         });
       });
       this.eventCenter.listen(EVENT.popupWindow.name, function (data) {
-        var _this$displayInfo2;
-        if (data.paymentElementOldModel) return;
-        insertStyleSheet();
-        _this.popupManager.popup(_objectSpread({
-          platform: (_this$displayInfo2 = _this.displayInfo) === null || _this$displayInfo2 === void 0 ? void 0 : _this$displayInfo2.platform
-        }, data)).then(function () {
-          _this.eventCenter.addIFrame(_this.popupManager.popupApp);
-        }).catch(function (error) {
-          _this.logService.logError({
-            title: (error === null || error === void 0 ? void 0 : error.title) || 'sdk_error_create_pop_up'
-          }, error);
-          _this.eventCenter.emit(EVENT.error.name, ERRORMESSAGE.CREATECOMPONENT_ERROR.LOAD_APP_TIMEOUT);
-        });
+        _this.handlePopupWindow(data);
       });
       this.eventCenter.listen(EVENT.popWindow.name, function () {
         _this.popupManager.pop();
@@ -194,7 +203,8 @@ export var ContainerService = /*#__PURE__*/function () {
       this.eventCenter.listen(EVENT.sizeChanged.name, function (data) {
         _this.handleSizeChanged(_objectSpread({}, data));
       });
-      this.eventCenter.listen(EVENT.showCloseButton.name, function () {
+      this.eventCenter.listen(EVENT.showCloseButton.name, function (data) {
+        _this.handleCloseButtonTheme(data.style);
         _this.changeCloseBtnVisibility(true);
       });
       this.eventCenter.listen(EVENT.hideCloseButton.name, function () {
@@ -206,6 +216,22 @@ export var ContainerService = /*#__PURE__*/function () {
       this.eventCenter.listen(EVENT.appHeartBeat.name, function () {
         _this.handleAppHeartBeat();
       });
+      /**
+       * 目前仅用于ESP V2的 web sdk
+       * 原因： 在账户输入页和OTP页面的h5场景下键盘弹起页面会有问题，iframe有固定高度，键盘弹起时应用层不会触发大小变化
+       *   account账号输入页需要在sdk监听键盘弹起后高度变化并修改iframe及iframe外层容器，account需要按钮置底的放在键盘上面，必须修改高度而不是让容器定位
+       *   otp页面需要在聚焦时给iframe及外层容器设置fixed定位，让页面不被弹起
+       * 目的： esp页面输入框聚焦/失焦后给sdk发送消息
+       */
+      this.eventCenter.listen(EVENT.inputFocus.name, function (data) {
+        // 账号输入页需要修改iframe高度
+        if (data.source === 'ESP_V2' && data.type === 'account') {
+          _this.handleAccountFocus(data.focus);
+          // otp页面需要定位元素
+        } else if (data.source === 'ESP_V2' && data.type === 'otp') {
+          _this.focusScrollFixed(data.focus);
+        }
+      });
     }
   }, {
     key: "addCapabilityToApiBusManager",
@@ -228,9 +254,9 @@ export var ContainerService = /*#__PURE__*/function () {
   }, {
     key: "handleSizeChanged",
     value: function handleSizeChanged(data) {
-      var _this$displayInfo3 = this.displayInfo,
-        appendAliasContainerId = _this$displayInfo3.appendAliasContainerId,
-        selector = _this$displayInfo3.selector;
+      var _this$displayInfo2 = this.displayInfo,
+        appendAliasContainerId = _this$displayInfo2.appendAliasContainerId,
+        selector = _this$displayInfo2.selector;
       var cashierId = appendAliasContainerId ? "".concat(COMPONENT_CONTAINER_ID, "-").concat((selector === null || selector === void 0 ? void 0 : selector.indexOf('#')) === -1 ? selector : selector.slice(1)) : COMPONENT_CONTAINER_ID;
       if (!this.webApp || !this.displayInfo) {
         return;
@@ -266,6 +292,50 @@ export var ContainerService = /*#__PURE__*/function () {
         this.webApp.style.height = "".concat(data.height, "px");
       }
     }
+
+    // 目前仅用于esp账号输入页聚焦
+  }, {
+    key: "focusResizeChange",
+    value: function focusResizeChange() {
+      var _window2;
+      // 计算出当前iframe应有的高度，需要和顶部留有距离
+      var webPageHeightRatio = 0.9;
+      var browserPageHeightFocusRatio = 0.9;
+      // sdk层才能拿到当前键盘弹起后页面的高度
+      var height = ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.visualViewport) === null || _window2 === void 0 ? void 0 : _window2.height) || window.innerHeight;
+      height = height * webPageHeightRatio;
+      height = height * browserPageHeightFocusRatio;
+      // 调用handleSizeChanged修改iframe高度
+      this.handleSizeChanged({
+        width: 0,
+        height: height
+      });
+    }
+
+    // 目前仅用于esp otp页面账号聚焦
+  }, {
+    key: "focusScrollFixed",
+    value: function focusScrollFixed(focus) {
+      // 获取iframe dom元素
+      var _this$displayInfo3 = this.displayInfo,
+        appendAliasContainerId = _this$displayInfo3.appendAliasContainerId,
+        selector = _this$displayInfo3.selector;
+      var cashierId = appendAliasContainerId ? "".concat(COMPONENT_CONTAINER_ID, "-").concat((selector === null || selector === void 0 ? void 0 : selector.indexOf('#')) === -1 ? selector : selector.slice(1)) : COMPONENT_CONTAINER_ID;
+      if (!this.webApp || !this.displayInfo) {
+        return;
+      }
+      var cashier = document.getElementById(cashierId);
+      if (!cashier) return;
+      // 输入框聚焦时修改定位信息和top距离
+      if (focus) {
+        cashier.style.setProperty('position', 'fixed', 'important');
+        cashier.style.setProperty('top', "".concat(this.clientHeight - cashier.clientHeight, "px"), 'important');
+      } else {
+        // 失焦时移除定位信息
+        cashier.style.removeProperty('position');
+        cashier.style.removeProperty('top');
+      }
+    }
   }, {
     key: "handleAppHeartBeat",
     value: function handleAppHeartBeat() {
@@ -323,6 +393,58 @@ export var ContainerService = /*#__PURE__*/function () {
         closeBlock === null || closeBlock === void 0 || closeBlock.classList.add("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-hidden"));
       }
     }
+  }, {
+    key: "handleCloseButtonTheme",
+    value: function handleCloseButtonTheme(style) {
+      if (!style) return;
+      var closeBlock = document.getElementById(COMPONENT_CLOSE_BLOCK_ID);
+      var closeButtonImg = closeBlock === null || closeBlock === void 0 ? void 0 : closeBlock.querySelector('img');
+      var maskCloseBlock = document.getElementById(COMPONENT_CLOSE_MASK_BLOCK_ID);
+      if (style === 'light') {
+        closeButtonImg === null || closeButtonImg === void 0 || closeButtonImg.setAttribute('src', closeImgLight);
+        closeBlock === null || closeBlock === void 0 || closeBlock.classList.add("".concat(COMPONENT_CLOSE_BLOCK_ID, "-light"));
+        maskCloseBlock === null || maskCloseBlock === void 0 || maskCloseBlock.classList.add("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-light"));
+      } else {
+        closeButtonImg === null || closeButtonImg === void 0 || closeButtonImg.setAttribute('src', closeImg);
+        closeBlock === null || closeBlock === void 0 || closeBlock.classList.remove("".concat(COMPONENT_CLOSE_BLOCK_ID, "-light"));
+        maskCloseBlock === null || maskCloseBlock === void 0 || maskCloseBlock.classList.remove("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-light"));
+      }
+    }
+
+    // SDK主动打开弹框
+  }, {
+    key: "handlePopupWindow",
+    value: function handlePopupWindow(data) {
+      var _this$displayInfo4,
+        _this3 = this;
+      if (data.paymentElementOldModel) return;
+      insertStyleSheet();
+      this.popupManager.popup(_objectSpread({
+        platform: (_this$displayInfo4 = this.displayInfo) === null || _this$displayInfo4 === void 0 ? void 0 : _this$displayInfo4.platform,
+        showCloseOnLoading: data.showCloseOnLoading,
+        onCloseOnLoading: function onCloseOnLoading() {
+          return _this3.handlePopWindow(data);
+        }
+      }, data)).then(function () {
+        _this3.eventCenter.addIFrame(_this3.popupManager.popupApp);
+      }).catch(function (error) {
+        _this3.logService.logError({
+          title: (error === null || error === void 0 ? void 0 : error.title) || 'sdk_error_create_pop_up'
+        }, error);
+        _this3.eventCenter.emit(EVENT.error.name, ERRORMESSAGE.CREATECOMPONENT_ERROR.LOAD_APP_TIMEOUT);
+      });
+    }
+
+    // SDK主动关闭弹框
+  }, {
+    key: "handlePopWindow",
+    value: function handlePopWindow(data) {
+      this.popupManager.pop();
+      this.eventCenter.dispatchToApp({
+        event: EVENT.popWindow.name,
+        data: data
+      });
+    }
   }, {
     key: "getWebApp",
     value: function getWebApp() {

package/esm/foundation/service/container/popup.d.ts

@@ -1,4 +1,12 @@
 import { PlatformEnum } from '../../../types';
+export type IPopUpParams = {
+    url: string;
+    widthPadding: number;
+    heightPadding: number;
+    platform: PlatformEnum;
+    showCloseOnLoading: boolean;
+    onCloseOnLoading: () => void;
+};
 /**
  * @author 谦彧 <zhangmian.zm@alipay.com>
  * @date 2024/9/22
@@ -7,11 +15,6 @@ export declare class PopupManager {
     private popupUrlQuery;
     popupApp: HTMLIFrameElement;
     setPopupUrlQuery(queryParams: string): void;
-    popup(data: {
-        url: string;
-        widthPadding: number;
-        heightPadding: number;
-        platform: PlatformEnum;
-    }): Promise<void>;
+    popup(data: IPopUpParams): Promise<void>;
     pop(): void;
 }

package/esm/foundation/service/container/popup.js

@@ -53,7 +53,9 @@ export var PopupManager = /*#__PURE__*/function () {
                 widthPadding: data === null || data === void 0 ? void 0 : data.widthPadding,
                 device: data === null || data === void 0 ? void 0 : data.platform,
                 url: pageUrl,
-                loadingConfig: undefined
+                loadingConfig: undefined,
+                showCloseOnLoading: data.showCloseOnLoading,
+                onCloseOnLoading: data.onCloseOnLoading
               });
             case 11:
               this.popupApp = _context.sent;

package/esm/foundation/utils/preload_helper.d.ts

@@ -4,10 +4,10 @@ export default class PreloadHelper {
     static isWebAppPreloaded: boolean;
     static isSecuritySDKPreloaded: boolean;
     private static securitySdkMap;
-    static preloadWebApp(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment?: string): void;
+    static preloadWebApp(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment?: string, useV2?: boolean): void;
     static preloadSecuritySDK(product: ProductSceneEnum, securityRegion?: string): void;
     static getSecuritySdk(scene: any): Security;
-    static buildWebAppPreloadUrl(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment: string): {
+    static buildWebAppPreloadUrl(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment: string, useV2?: boolean): {
         preloadUrl: string;
         containerId: string;
     };

package/esm/foundation/utils/preload_helper.js

@@ -8,7 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { sdkVersion } from "../../config";
 import { createPreloadIframe } from "../service/container/utils";
 import { ProductSceneEnum } from "../../types";
-import { getWebAppUrl } from "../utils/web_app_url_utils";
+import { getWebAppUrl, getWebAppV2Url } from "../utils/web_app_url_utils";
 import { ProductInfoCacheUtil } from "../utils/payment_product_utils";
 import { getWebAppVersion } from "./payment_context_utils";
 import { getSecurityConfigStorageKey, getSecurityHost, getSecurityScene, Security } from "../../util/security";
@@ -22,12 +22,13 @@ var PreloadHelper = /*#__PURE__*/function () {
     key: "preloadWebApp",
     value: function preloadWebApp(productScene, paymentMethodCategoryType) {
       var environment = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'prod';
+      var useV2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       try {
         if (this.isWebAppPreloaded) {
           console.log('[web-sdk] web app already preloaded');
           return;
         }
-        var _this$buildWebAppPrel = this.buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment),
+        var _this$buildWebAppPrel = this.buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment, useV2),
           preloadUrl = _this$buildWebAppPrel.preloadUrl,
           containerId = _this$buildWebAppPrel.containerId;
         var preloadIframe = createPreloadIframe(containerId);
@@ -89,6 +90,7 @@ var PreloadHelper = /*#__PURE__*/function () {
   }, {
     key: "buildWebAppPreloadUrl",
     value: function buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment) {
+      var useV2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       var productSceneVersion = productScene === ProductSceneEnum.EASY_PAY ? '2.0' : '1.0';
       var previousProductInfo = ProductInfoCacheUtil.getPreviousProductInfo(productScene);
       if (previousProductInfo) {
@@ -101,14 +103,16 @@ var PreloadHelper = /*#__PURE__*/function () {
         webAppVersion: ''
       };
       sdkMetaData.webAppVersion = getWebAppVersion(sdkMetaData);
-      var preloadUrl = getWebAppUrl({
+      var preloadUrlParams = {
         environment: environment,
         sdkMetaData: sdkMetaData,
         paymentMethodCategoryType: paymentMethodCategoryType,
         isPreload: true,
+        productScene: productScene,
         productSceneVersion: productSceneVersion,
         query: undefined
-      });
+      };
+      var preloadUrl = useV2 ? getWebAppV2Url(preloadUrlParams) : getWebAppUrl(preloadUrlParams);
       return {
         preloadUrl: preloadUrl,
         containerId: containerId

package/esm/foundation/utils/redirect_utils.js

@@ -69,26 +69,42 @@ export var redirect = function redirect(payload, instanceId) {
         successCallback(payload, type, evokeAppBy.url, serviceProvider);
       }
     });
+    var callApplinkUrl = function callApplinkUrl() {
+      try {
+        callAppLib.open({
+          link: payload.applinkUrl,
+          fallback: function fallback() {
+            failCallback(payload, RedirectType.ApplinkUrl, payload.applinkUrl, serviceProvider);
+            // Applink evoke failed, try to use scheme url
+            callSchemeUrl();
+          }
+        });
+      } catch (error) {
+        failCallback(payload, RedirectType.ApplinkUrl, payload.applinkUrl, serviceProvider);
+        // Applink evoke failed, try to use scheme url
+        callSchemeUrl();
+      }
+    };
     var callSchemeUrl = function callSchemeUrl() {
-      callAppLib.open({
-        scheme: payload.schemeUrl,
-        fallback: function fallback() {
-          failCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
-          if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
-          successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
-          window.location.href = payload.url;
-        }
-      });
+      try {
+        callAppLib.open({
+          scheme: payload.schemeUrl,
+          fallback: function fallback() {
+            failCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
+            if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+            successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+            window.location.href = payload.url;
+          }
+        });
+      } catch (error) {
+        failCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
+        if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+        successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+        window.location.href = payload.url;
+      }
     };
     if (payload.applinkUrl) {
-      callAppLib.open({
-        link: payload.applinkUrl,
-        fallback: function fallback() {
-          failCallback(payload, RedirectType.ApplinkUrl, payload.applinkUrl, serviceProvider);
-          // Applink evoke failed, try to use scheme url
-          callSchemeUrl();
-        }
-      });
+      callApplinkUrl();
     } else if (payload.schemeUrl) {
       callSchemeUrl();
     }
@@ -116,7 +132,7 @@ var successCallback = function successCallback(payload, type, url, serviceProvid
 };
 var failCallback = function failCallback(payload, type, url, serviceProvider) {
   serviceProvider.getService('EventCenter').emit(EVENT.eventCallback.name, {
-    code: eventCodeEnum.SDK_CALL_URL_ERROR,
+    code: eventCodeEnum.SDK_LAUNCH_PAYMENT_APP_ERROR,
     message: "Failed to open app,applinkUrl: ".concat(payload === null || payload === void 0 ? void 0 : payload.applinkUrl, " schemeUrl: ").concat(payload === null || payload === void 0 ? void 0 : payload.schemeUrl, " normalUrl: ").concat(payload === null || payload === void 0 ? void 0 : payload.url)
   });
   serviceProvider.getService('Log').logInfo({

package/esm/foundation/utils/web_app_url_utils.d.ts

@@ -1,5 +1,6 @@
-import { DisplayTypeEnum, PaymentMethodCategoryTypeEnum } from '../../types';
+import { DisplayTypeEnum, PaymentMethodCategoryTypeEnum, ProductSceneEnum, IPaymentSessionMetaData } from '../../types';
 import { SDKMetaData } from '../index';
+import { ESP_PAGE_NAME } from "../../constant/easysafepay";
 /**
  * Tell the SDK which version of the Web App to load.
  * Sent by server inside paymentSession.
@@ -16,6 +17,16 @@ export interface WebAppMatchConfig {
     mid?: string;
     greyscale?: string;
 }
+/**
+ * Tell the SDK which Web App URL to load.
+ * Sent by server inside paymentSession.
+ */
+export interface WebAppUrlMatchConfig {
+    minSDKVersion: string;
+    url: string;
+    doubleFa: string;
+    mids?: string[];
+}
 export interface QueryParams {
     displayType: DisplayTypeEnum;
     locale: string;
@@ -27,20 +38,79 @@ export interface QueryParams {
 export declare const getWebAppUrlInfo: (params: {
     environment: string;
     sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
     productSceneVersion: string;
     paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
     isPreload?: boolean;
     query: QueryParams;
+    v2Url?: string;
 }) => {
     path: string;
     locationSearch: string;
 };
+export declare const getWebAppV2Url: (params: {
+    environment: string;
+    sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
+    productSceneVersion: string;
+    paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
+    isPreload?: boolean;
+    query: QueryParams;
+    mid?: string;
+    extendInfo?: string;
+}) => string;
 export declare const getWebAppUrl: (params: {
     environment: string;
     sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
     productSceneVersion: string;
     paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
     isPreload?: boolean;
     query: QueryParams;
+    v2Url?: string;
 }) => string;
 export declare const parseWebAppMatchConfig: (extendInfo: string) => WebAppMatchConfig[];
+export declare const parseWebAppUrlMatchConfig: (extendInfo: string) => WebAppUrlMatchConfig[];
+/**
+ * Save the current checkout URL to localStorage for the specified product scene.
+ *
+ * @param productScene - The product scene for which the checkout URL should be saved.
+ */
+export declare const saveLocalCheckoutUrl: (productScene: ProductSceneEnum, url: string) => void;
+/**
+ * 获取从外部动态下发的V2AppUrl.
+ *
+ * @param config - sessionData解析来的checkoutInfo列表.
+ */
+export declare const getMatchedWebAppV2Url: (productScene: ProductSceneEnum, mid: string, configs: WebAppUrlMatchConfig[], env: string) => string;
+/**
+ * 获取ESP从sessionData.checkoutInfo内动态下发的Url.
+ */
+export declare const matchEasySafePayV2Url: (params: {
+    configs: WebAppUrlMatchConfig[];
+    mid: string;
+    env: string;
+    pageName: ESP_PAGE_NAME;
+}) => string;
+/**
+ * Retrieve the saved checkout URL from localStorage for the specified product scene.
+ * If no url is found, a default checkout url string is returned.
+ *
+ * @param productScene - The product scene for which the checkout URL should be retrieved.
+ */
+export declare const getLocalCheckoutUrl: (productScene: ProductSceneEnum, environment: string) => string;
+/**
+ * Provide default checkout URL for the specified product scene.
+ * Return URL for 'EASY_PAY' product scene, while for other product scenes, it returns an empty string as they are not currently in use
+ *
+ * @param productScene - The product scene for which the default checkout URL should be provided.
+ */
+export declare const defaultCheckoutUrl: (productScene: ProductSceneEnum, environment?: string) => string;
+/**
+ * V2应用EasySafePay 热更新兜底URL构建规则
+ * 1. 兜底URL版本与sdk版本保持一致
+ * 2. DEV环境下html新增版本前缀
+**/
+export declare const getDefaultEasySafePayPageUrl: (pageName: ESP_PAGE_NAME, env: string) => string;
+/**通过sessionData获取doubleFa,于createComponent时传递给WEB应用*/
+export declare const getDoubleFaUrlFromSession: (paymentSessionObj: IPaymentSessionMetaData, env?: string) => string;