@economist/web-apple-pay 1.10.0 → 2.0.0-beta.1

package/README.md

@@ -121,10 +121,19 @@ Consumers should listen for this event and continue payment orchestration.
 - `configureApplePay(config)`: sets required runtime config (merchant ID and wallet API base URL, with optional debug bypass).
 - `ApplePayButton`: button component class.
   - `whenReady(): Promise<void>` — resolves when the current render lifecycle completes (available or hidden). Resolves immediately if called before the element is connected.
+  - `createIfEnabled(offer, country, entryPoint?)`: returns a configured button or `null`.
+    - `DUAL_OFFER_BANNER` (or omitted): always-on after homepage + Safari/Apple eligibility and offer exclusions — no banners Amplitude experiment / `$exposure`.
+    - `PAYWALL`: experiment-gated via `apple-pay-express-checkout-on-paywalls` (`treatment` or QA URL).
+    - `REGWALL`: inert — always returns `null`.
 - `ApplePayModal`: modal component class.
 - `ensureApplePayLogoSymbol()`: logo symbol injection helper.
+- `APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY`: Amplitude flag key for paywalls experiment gating / `$exposure`.
 - `Offer`: offer contract type used by component props.
 
+### Breaking changes
+
+- `APPLE_PAY_EXPRESS_EXPERIMENT_KEY` (banners experiment flag) is no longer exported. Use `APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY` for paywalls, or drop the import if you only needed the retired banners key.
+
 ## Troubleshooting
 
 ### Button does not appear
@@ -133,7 +142,8 @@ Check:
 
 - `configureApplePay(...)` was called before rendering (with a valid `merchantId` and `walletApiBaseUrl`)
 - device/browser supports Apple Pay (Safari on Apple device required)
-- query string/feature flag gating for your page is satisfied
+- for paywalls: Amplitude treatment (or `?FEATURE_APPLE_PAY_EXPRESS_CHECKOUT`) is satisfied
+- for banners: homepage + Safari/Apple eligibility (and consumer kill switch off)
 - offer variant is not excluded (`bundle`, `insider_print`)
 
 ### Logged-in checkbox copy looks wrong

package/dist/index.js

@@ -1310,7 +1310,6 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
@@ -1354,7 +1353,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -2006,14 +2005,14 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressExperiment,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2021,7 +2020,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2040,27 +2039,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-   * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-   * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
-   *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
-   *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
    * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-   * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2083,28 +2079,33 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
-    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    if (config.enabled === false) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      experimentFlagKey
-    );
-    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
-      void isApplePayAvailable().then((available) => {
-        if (available) {
-          trackApplePayExperimentExposure(
-            experimentValue,
-            getExperimentKeyFromNextData(experimentFlagKey),
-            experimentFlagKey
-          );
-        }
-      });
-    }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;
@@ -2417,7 +2418,6 @@ function defineApplePayElements() {
 }
 export {
   APPLE_PAY_EXCLUDED_VARIANTS,
-  APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_VARIANTS,
   ApplePayButton,

package/dist/src/apple-pay-button.d.ts

@@ -6,27 +6,24 @@ export declare class ApplePayButton extends HTMLElement {
     static readonly tag = "teg-apple-pay-button";
     static define(): void;
     /**
-     * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+     * Creates and configures an ApplePayButton when the entry point allows it.
      *
-     * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-     * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-     * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+     * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+     *   no banners experiment read and no banners `$exposure`.
+     * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+     *   (`treatment` or QA URL param). The host must set up
+     *   `window.experimentIntegration` before calling for this entry point.
+     * - `REGWALL`: inert — always returns null.
      *
-     * The host page is responsible for setting up `window.experimentIntegration`
-     * before calling this method.
-     *
-     * - `treatment` → button created and returned
-     * - `control` / missing / anything else → returns null (button suppressed)
-     *
-     * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-     * gate is also evaluated as a fallback until all host apps have integrated
-     * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-     * fallback will be removed.
+     * **PAYWALL only — transition period:** the legacy
+     * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+     * treatment (and without inflating `$exposure`). For banners, the same URL
+     * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+     * experiment gate.
      *
      * **Eligibility:**
-     * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+     * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
      * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-     * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
      *
      * @param offer - The offer to display in the Apple Pay flow.
      * @param country - The user's country code.

package/dist/src/apple-pay-button.js

@@ -1299,7 +1299,6 @@ var redirectToCheckoutFallback = (params) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
@@ -1343,7 +1342,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1995,14 +1994,14 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressExperiment,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2010,7 +2009,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2029,27 +2028,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-   * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-   * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
-   *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
-   *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
    * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-   * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2072,28 +2068,33 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
-    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    if (config.enabled === false) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      experimentFlagKey
-    );
-    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
-      void isApplePayAvailable().then((available) => {
-        if (available) {
-          trackApplePayExperimentExposure(
-            experimentValue,
-            getExperimentKeyFromNextData(experimentFlagKey),
-            experimentFlagKey
-          );
-        }
-      });
-    }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

package/dist/src/apple-pay-button.stories.js

@@ -1307,7 +1307,6 @@ var redirectToCheckoutFallback = (params) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
@@ -1351,7 +1350,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -2003,14 +2002,14 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressExperiment,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2018,7 +2017,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2037,27 +2036,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-   * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-   * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
-   *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
-   *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
    * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-   * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2080,28 +2076,33 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
-    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    if (config.enabled === false) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      experimentFlagKey
-    );
-    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
-      void isApplePayAvailable().then((available) => {
-        if (available) {
-          trackApplePayExperimentExposure(
-            experimentValue,
-            getExperimentKeyFromNextData(experimentFlagKey),
-            experimentFlagKey
-          );
-        }
-      });
-    }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

package/dist/src/apple-pay-modal.stories.js

@@ -1299,7 +1299,6 @@ var redirectToCheckoutFallback = (params) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
@@ -1343,7 +1342,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1995,14 +1994,14 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressExperiment,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2010,7 +2009,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2029,27 +2028,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-   * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-   * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
-   *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
-   *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
    * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-   * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2072,28 +2068,33 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
-    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    if (config.enabled === false) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      experimentFlagKey
-    );
-    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
-      void isApplePayAvailable().then((available) => {
-        if (available) {
-          trackApplePayExperimentExposure(
-            experimentValue,
-            getExperimentKeyFromNextData(experimentFlagKey),
-            experimentFlagKey
-          );
-        }
-      });
-    }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

package/dist/src/constants.d.ts

@@ -3,35 +3,24 @@ export declare enum ApplePayEntryPoint {
     REGWALL = "article_regwall",
     DUAL_OFFER_BANNER = "dual_offer_banner"
 }
-/**
- * Amplitude experiment key for Apple Pay Express Checkout on homepage banners
- * (dual-offer banner) and article banner regwalls.
- *
- * This package reads the variant for this key internally via
- * `window.experimentIntegration.getVariant()` — set up by the host page
- * before `createIfEnabled` is called.
- *
- * Fail-closed: missing integration, missing key, `control`, or Amplitude fetch
- * failure on the host → button is hidden (unless QA URL param is present).
- *
- * Must match the Feature experiment key in Amplitude and host app constants
- * (Engagement / Insider / Podcasts).
- */
-export declare const APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 /**
  * Amplitude experiment key for Apple Pay Express Checkout on article paywalls
  * (`ApplePayEntryPoint.PAYWALL`, e.g. single-offer-paywall / multi-offer paywall).
  *
- * Same fail-closed / QA-param behaviour as {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}.
+ * Fail-closed when the variant is missing or not `treatment`; the QA URL param
+ * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` can show the button without treatment.
  * Eligibility for this flag ignores homepage and requires Safari/Apple device
  * (plus `isApplePayAvailable` before `$exposure`).
+ *
+ * Must match the Feature experiment key in Amplitude and host app constants
+ * (Engagement / Insider / Podcasts) while those still bridge the experiment.
  */
 export declare const APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 /**
  * Known Amplitude experiment flag keys for Apple Pay Express Checkout.
  * Narrowed so callers cannot pass an arbitrary typo'd string.
  */
-export type ApplePayExperimentFlagKey = typeof APPLE_PAY_EXPRESS_EXPERIMENT_KEY | typeof APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY;
+export type ApplePayExperimentFlagKey = typeof APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY;
 /**
  * Amplitude variant values for the Apple Pay Express Checkout experiment.
  * CONTROL   → button hidden (baseline)

package/dist/src/constants.js

@@ -5,14 +5,12 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"
 };
 export {
-  APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_VARIANTS,
   ApplePayEntryPoint

package/dist/src/index.d.ts

@@ -2,7 +2,7 @@ export { ApplePayButton, APPLE_PAY_EXCLUDED_VARIANTS, } from './apple-pay-button
 export { ApplePayModal } from './apple-pay-modal';
 export { ensureApplePayLogoSymbol } from './apple-pay-logo';
 export { configureApplePay } from './clients/payment-checkout/config';
-export { ApplePayEntryPoint, APPLE_PAY_EXPRESS_EXPERIMENT_KEY, APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY, APPLE_PAY_EXPRESS_VARIANTS, } from './constants';
+export { ApplePayEntryPoint, APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY, APPLE_PAY_EXPRESS_VARIANTS, } from './constants';
 export type { ApplePayExperimentFlagKey } from './constants';
 export type { ApplePayRuntimeConfig } from './clients/payment-checkout/config';
 export type { Offer } from './types/offer.types';

package/dist/src/index.js

@@ -1310,7 +1310,6 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
@@ -1354,7 +1353,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -2006,14 +2005,14 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressExperiment,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2021,7 +2020,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2040,27 +2039,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant`:
-   * - {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY} for `PAYWALL`
-   * - {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY} for `REGWALL` / `DUAL_OFFER_BANNER`
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
-   *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
-   *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
    * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
-   * - `REGWALL`: no host-side placement gate (pre-SMA-3301 article behaviour)
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2083,28 +2079,33 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
-    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    if (config.enabled === false) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      experimentFlagKey
-    );
-    const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
-      void isApplePayAvailable().then((available) => {
-        if (available) {
-          trackApplePayExperimentExposure(
-            experimentValue,
-            getExperimentKeyFromNextData(experimentFlagKey),
-            experimentFlagKey
-          );
-        }
-      });
-    }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;
@@ -2417,7 +2418,6 @@ function defineApplePayElements() {
 }
 export {
   APPLE_PAY_EXCLUDED_VARIANTS,
-  APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY,
   APPLE_PAY_EXPRESS_VARIANTS,
   ApplePayButton,

package/dist/src/utils/applePayExpressEligibility.d.ts

@@ -1,18 +1,20 @@
 /**
- * Host-side eligibility for Apple Pay Express Feature Experiment (SMA-3301).
+ * Host-side placement eligibility for Apple Pay Express.
  *
- * Gates createIfEnabled before getVariant / $exposure so only the intended
- * population participates. Exposure is further gated on isApplePayAvailable()
- * (BYPASS_APPLE_PAY_CHECKS respected). Amplitude audience targeting uses
- * generic user_properties from Engagement.
+ * Used by createIfEnabled after offer exclusions. Enforces placement and
+ * device/browser eligibility (homepage + Safari/Apple for banners;
+ * Safari/Apple only for paywalls). Banner surfaces are always-on after
+ * eligibility; paywalls remain experiment-gated separately. Exposure
+ * (paywalls) is further gated on isApplePayAvailable()
+ * (BYPASS_APPLE_PAY_CHECKS respected).
  */
 export declare const isApplePayExpressHomepage: (pathname?: string) => boolean;
 /**
- * Dual-offer homepage banner: homepage + Safari/iPhone.
- * Anonymous is assumed because the dual-offer banner is only mounted for
+ * Dual-offer / Free Trial homepage banners: homepage + Safari/iPhone.
+ * Anonymous is assumed because these banners are only mounted for
  * anonymous visitors.
  */
-export declare const isEligibleForApplePayExpressExperiment: () => boolean;
+export declare const isEligibleForApplePayExpressBanner: () => boolean;
 /**
  * Article paywalls (`ApplePayEntryPoint.PAYWALL`): Safari/Apple device only.
  * Homepage targeting does not apply — paywalls render on article pages.

package/dist/src/utils/applePayExpressEligibility.js

@@ -7,10 +7,10 @@ var isAppleDeviceOrSafari = () => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 export {
   isApplePayExpressHomepage,
-  isEligibleForApplePayExpressExperiment,
+  isEligibleForApplePayExpressBanner,
   isEligibleForApplePayExpressPaywallExperiment
 };

package/dist/src/utils/expressCheckoutTracking.d.ts

@@ -57,10 +57,10 @@ export type ImpressionMetadata = {
  * experiment_key from Engagement SSR (__NEXT_DATA__) when present for run
  * attribution.
  *
- * @param flagKey - Amplitude flag_key. Defaults to the banners experiment;
- *   paywalls pass {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}.
+ * @param flagKey - Amplitude flag_key (required). Callers must pass an
+ *   explicit key such as {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}.
  */
-export declare const trackApplePayExperimentExposure: (variant: string, experimentKey?: string, flagKey?: ApplePayExperimentFlagKey) => void;
+export declare const trackApplePayExperimentExposure: (variant: string, experimentKey: string | undefined, flagKey: ApplePayExperimentFlagKey) => void;
 /** Wallet button displayed — emits all 5 required analytics dimensions. */
 export declare const trackExpressWalletImpression: (skuId: string, { entryPoint, country }: ImpressionMetadata) => void;
 /** Wallet button clicked */

package/dist/src/utils/expressCheckoutTracking.js

@@ -1,5 +1,4 @@
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"
@@ -42,7 +41,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey, flagKey = APPLE_PAY_EXPRESS_EXPERIMENT_KEY) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@economist/web-apple-pay",
   "description": "Web component package for Apple Pay checkout UI",
-  "version": "1.10.0",
+  "version": "2.0.0-beta.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",