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

package/README.md

@@ -27,7 +27,10 @@ npm install --save @economist/web-apple-pay
 Call `configureApplePay(...)` once during app startup, before rendering Apple Pay UI:
 
 ```ts
-import { configureApplePay, defineApplePayElements } from '@economist/web-apple-pay';
+import {
+  configureApplePay,
+  defineApplePayElements,
+} from '@economist/web-apple-pay';
 
 configureApplePay({
   merchantId: 'merchant.com.economist.your-app',
@@ -85,8 +88,8 @@ to the DOM. This is the supported, stable way to know whether Apple Pay is
 available without touching lifecycle internals.
 
 ```ts
-container.appendChild(btn);   // spec-compliant — browser fires connectedCallback naturally
-await btn.whenReady();        // resolves when rendering is complete
+container.appendChild(btn); // spec-compliant — browser fires connectedCallback naturally
+await btn.whenReady(); // resolves when rendering is complete
 if (btn.style.display !== 'none') {
   // Apple Pay rendered successfully
 } else {
@@ -121,10 +124,20 @@ 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 offer exclusions — no homepage/Safari gate at `createIfEnabled` (device gating via `isApplePayAvailable` on mount); no banners Amplitude experiment / `$exposure`.
+    - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; wallet impression `entry_point` is `free_trial_banner`.
+    - `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
@@ -132,8 +145,9 @@ Consumers should listen for this event and continue payment orchestration.
 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
+- device/browser supports Apple Pay (Safari on Apple device required — enforced by `isApplePayAvailable` on mount)
+- for paywalls: Amplitude treatment (or `?FEATURE_APPLE_PAY_EXPRESS_CHECKOUT`) is satisfied, plus Safari/Apple placement eligibility
+- for banners: consumer kill switch off (no homepage/Safari gate at `createIfEnabled`)
 - offer variant is not excluded (`bundle`, `insider_print`)
 
 ### Logged-in checkbox copy looks wrong

package/dist/index.js

@@ -1308,9 +1308,9 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  ApplePayEntryPoint2["FREE_TRIAL_BANNER"] = "free_trial_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 +1354,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;
@@ -1383,8 +1383,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });
@@ -2005,15 +2008,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => 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: () => true
+    // no experimentFlagKey → always-on after offer exclusions
+  },
+  ["free_trial_banner" /* FREE_TRIAL_BANNER */]: {
+    isEligible: () => true
+    // Dual parity — no experimentFlagKey, no homepage gate here
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2021,7 +2026,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 +2045,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
-   *
-   * 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`
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after offer exclusions —
+   *   no homepage/Safari gate here, no banners experiment read, and no banners
+   *   `$exposure`.
+   * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+   *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+   * - `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.
    *
-   * - `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 there is no
+   * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+   * `isApplePayAvailable()` on mount.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+   *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+   *   later by `isApplePayAvailable()` on mount)
    * - `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 +2090,31 @@ 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;
@@ -2325,7 +2335,10 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (document.querySelector(ApplePayModal.tag)) {
       return;
     }
-    trackExpressWalletClick(this.#offer.sku_id);
+    trackExpressWalletClick(
+      this.#offer.sku_id,
+      this.#entryPoint ? { entryPoint: this.#entryPoint } : void 0
+    );
     ApplePayModal.define();
     const modal = document.createElement(ApplePayModal.tag);
     modal.offer = this.#offer;
@@ -2417,7 +2430,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,29 @@ 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 offer exclusions —
+     *   no homepage/Safari gate here, no banners experiment read, and no banners
+     *   `$exposure`.
+     * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+     *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+     * - `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 there is no
+     * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+     * `isApplePayAvailable()` on mount.
      *
      * **Eligibility:**
-     * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+     * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+     *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+     *   later by `isApplePayAvailable()` on mount)
      * - `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;
@@ -1372,8 +1371,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });
@@ -1994,15 +1996,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => 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: () => true
+    // no experimentFlagKey → always-on after offer exclusions
+  },
+  ["free_trial_banner" /* FREE_TRIAL_BANNER */]: {
+    isEligible: () => true
+    // Dual parity — no experimentFlagKey, no homepage gate here
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2010,7 +2014,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 +2033,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
-   *
-   * 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`
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after offer exclusions —
+   *   no homepage/Safari gate here, no banners experiment read, and no banners
+   *   `$exposure`.
+   * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+   *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+   * - `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.
    *
-   * - `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 there is no
+   * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+   * `isApplePayAvailable()` on mount.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+   *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+   *   later by `isApplePayAvailable()` on mount)
    * - `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 +2078,31 @@ 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;
@@ -2314,7 +2323,10 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (document.querySelector(ApplePayModal.tag)) {
       return;
     }
-    trackExpressWalletClick(this.#offer.sku_id);
+    trackExpressWalletClick(
+      this.#offer.sku_id,
+      this.#entryPoint ? { entryPoint: this.#entryPoint } : void 0
+    );
     ApplePayModal.define();
     const modal = document.createElement(ApplePayModal.tag);
     modal.offer = this.#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;
@@ -1380,8 +1379,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });
@@ -2002,15 +2004,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => 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: () => true
+    // no experimentFlagKey → always-on after offer exclusions
+  },
+  ["free_trial_banner" /* FREE_TRIAL_BANNER */]: {
+    isEligible: () => true
+    // Dual parity — no experimentFlagKey, no homepage gate here
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2018,7 +2022,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 +2041,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
-   *
-   * 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`
-   *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after offer exclusions —
+   *   no homepage/Safari gate here, no banners experiment read, and no banners
+   *   `$exposure`.
+   * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+   *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+   * - `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.
    *
-   * **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 there is no
+   * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+   * `isApplePayAvailable()` on mount.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+   *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+   *   later by `isApplePayAvailable()` on mount)
    * - `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 +2086,31 @@ 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;
@@ -2322,7 +2331,10 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (document.querySelector(ApplePayModal.tag)) {
       return;
     }
-    trackExpressWalletClick(this.#offer.sku_id);
+    trackExpressWalletClick(
+      this.#offer.sku_id,
+      this.#entryPoint ? { entryPoint: this.#entryPoint } : void 0
+    );
     ApplePayModal.define();
     const modal = document.createElement(ApplePayModal.tag);
     modal.offer = this.#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;
@@ -1372,8 +1371,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });
@@ -1994,15 +1996,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => 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: () => true
+    // no experimentFlagKey → always-on after offer exclusions
+  },
+  ["free_trial_banner" /* FREE_TRIAL_BANNER */]: {
+    isEligible: () => true
+    // Dual parity — no experimentFlagKey, no homepage gate here
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2010,7 +2014,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 +2033,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
-   *
-   * 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`
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after offer exclusions —
+   *   no homepage/Safari gate here, no banners experiment read, and no banners
+   *   `$exposure`.
+   * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+   *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+   * - `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.
    *
-   * - `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 there is no
+   * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+   * `isApplePayAvailable()` on mount.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+   *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+   *   later by `isApplePayAvailable()` on mount)
    * - `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 +2078,31 @@ 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;
@@ -2314,7 +2323,10 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (document.querySelector(ApplePayModal.tag)) {
       return;
     }
-    trackExpressWalletClick(this.#offer.sku_id);
+    trackExpressWalletClick(
+      this.#offer.sku_id,
+      this.#entryPoint ? { entryPoint: this.#entryPoint } : void 0
+    );
     ApplePayModal.define();
     const modal = document.createElement(ApplePayModal.tag);
     modal.offer = this.#offer;

package/dist/src/constants.d.ts

@@ -1,37 +1,27 @@
 export declare enum ApplePayEntryPoint {
     PAYWALL = "article_paywall",
     REGWALL = "article_regwall",
-    DUAL_OFFER_BANNER = "dual_offer_banner"
+    DUAL_OFFER_BANNER = "dual_offer_banner",
+    FREE_TRIAL_BANNER = "free_trial_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

@@ -3,16 +3,15 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  ApplePayEntryPoint2["FREE_TRIAL_BANNER"] = "free_trial_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

@@ -1308,9 +1308,9 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  ApplePayEntryPoint2["FREE_TRIAL_BANNER"] = "free_trial_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 +1354,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;
@@ -1383,8 +1383,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });
@@ -2005,15 +2008,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => 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: () => true
+    // no experimentFlagKey → always-on after offer exclusions
+  },
+  ["free_trial_banner" /* FREE_TRIAL_BANNER */]: {
+    isEligible: () => true
+    // Dual parity — no experimentFlagKey, no homepage gate here
   },
   ["article_paywall" /* PAYWALL */]: {
     isEligible: isEligibleForApplePayExpressPaywallExperiment,
@@ -2021,7 +2026,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 +2045,29 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
-   *
-   * 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`
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * The host page is responsible for setting up `window.experimentIntegration`
-   * before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after offer exclusions —
+   *   no homepage/Safari gate here, no banners experiment read, and no banners
+   *   `$exposure`.
+   * - `FREE_TRIAL_BANNER`: same always-on-after-exclusions gate as Dual; distinct
+   *   TEDL `entry_point` string (`free_trial_banner`) for wallet impression attribution.
+   * - `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.
    *
-   * - `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 there is no
+   * experiment gate; `BYPASS_APPLE_PAY_CHECKS` only skips device checks in
+   * `isApplePayAvailable()` on mount.
    *
    * **Eligibility:**
-   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone (SMA-3301)
+   * - `DUAL_OFFER_BANNER` / `FREE_TRIAL_BANNER` (or omitted): always eligible at
+   *   this gate (homepage placement is host-owned; Safari/Apple is enforced
+   *   later by `isApplePayAvailable()` on mount)
    * - `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 +2090,31 @@ 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;
@@ -2325,7 +2335,10 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     if (document.querySelector(ApplePayModal.tag)) {
       return;
     }
-    trackExpressWalletClick(this.#offer.sku_id);
+    trackExpressWalletClick(
+      this.#offer.sku_id,
+      this.#entryPoint ? { entryPoint: this.#entryPoint } : void 0
+    );
     ApplePayModal.define();
     const modal = document.createElement(ApplePayModal.tag);
     modal.offer = this.#offer;
@@ -2417,7 +2430,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,19 @@
 /**
- * Host-side eligibility for Apple Pay Express Feature Experiment (SMA-3301).
+ * Host-side placement eligibility helpers 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.
+ * Paywalls: used by createIfEnabled after offer exclusions so experiment
+ * $exposure is Safari/Apple-gated. Banners: createIfEnabled does not call
+ * the banner helper (always-on after offer exclusions); Safari/Apple still
+ * runs later via isApplePayAvailable() on mount. 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
- * anonymous visitors.
+ * Dual-offer / Free Trial homepage banners: homepage + Safari/iPhone.
+ * Anonymous is assumed because these banners are only mounted for
+ * anonymous visitors. Not wired into createIfEnabled ENTRY_POINT_CONFIG.
  */
-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,14 +57,23 @@ 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;
+/**
+ * Optional metadata for the wallet click event.
+ * `entry_point` is included only when provided so existing one-arg callers stay
+ * payload-compatible.
+ */
+export type ClickMetadata = {
+    /** Entry point where the Apple Pay button was clicked — e.g. 'free_trial_banner'. */
+    entryPoint?: string;
+};
 /** Wallet button clicked */
-export declare const trackExpressWalletClick: (skuId: string) => void;
+export declare const trackExpressWalletClick: (skuId: string, { entryPoint }?: ClickMetadata) => void;
 /** Apple Pay sheet opened (session.begin() called) */
 export declare const trackWalletPaymentSheetOpen: (skuId: string) => void;
 /** Payment authorised by the user in the Apple Pay sheet */

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;
@@ -71,8 +70,11 @@ var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
     device: getDevice()
   });
 };
-var trackExpressWalletClick = (skuId) => {
-  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, { sku_id: skuId });
+var trackExpressWalletClick = (skuId, { entryPoint } = {}) => {
+  track(EXPRESS_CHECKOUT_EVENTS.BUTTON_CLICK, {
+    sku_id: skuId,
+    ...entryPoint ? { entry_point: entryPoint } : {}
+  });
 };
 var trackWalletPaymentSheetOpen = (skuId) => {
   track(EXPRESS_CHECKOUT_EVENTS.SHEET_OPEN, { sku_id: skuId });

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.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",