@economist/web-apple-pay 1.10.2-beta.1 → 1.11.1-beta.1

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',
@@ -54,56 +57,6 @@ container.appendChild(button);
 
 When clicked, the button creates and opens `teg-apple-pay-modal` automatically.
 
-### 3) Gated creation — `createIfEnabled`
-
-Hosts that mount Apple Pay on a wall, banner, or popup should use
-`ApplePayButton.createIfEnabled(offer, country, entryPoint)` instead of
-`document.createElement`. It applies Amplitude experiment and placement rules
-per entry point, then returns a configured button or `null`.
-
-```ts
-import {
-  ApplePayButton,
-  ApplePayEntryPoint,
-} from '@economist/web-apple-pay';
-
-const button = ApplePayButton.createIfEnabled(
-  offer,
-  'US',
-  ApplePayEntryPoint.FREE_TRIAL_POPUP,
-);
-
-if (button) {
-  container.appendChild(button);
-  await button.whenReady();
-  if (button.style.display === 'none') {
-    button.remove();
-  }
-}
-```
-
-#### Entry points
-
-| `ApplePayEntryPoint` | Value | Amplitude flag | Placement eligibility |
-| --- | --- | --- | --- |
-| `PAYWALL` | `article_paywall` | `apple-pay-express-checkout-on-paywalls` | Safari / Apple device |
-| `REGWALL` | `article_regwall` | `apple-pay-express-checkout-on-banners` | none |
-| `DUAL_OFFER_BANNER` (default if omitted) | `dual_offer_banner` | `apple-pay-express-checkout-on-banners` | homepage + Safari / iPhone |
-| `FREE_TRIAL_POPUP` | `free_trial_popup` | **none** — always shown | none |
-
-`FREE_TRIAL_POPUP` does not read `window.experimentIntegration` and does not
-emit `$exposure`. The button is created whenever the offer is valid (excluded
-variants still suppress it). The component still hides itself after mount if
-Apple Pay is unavailable on the device.
-
-For every other entry point:
-
-- Host must set `window.experimentIntegration.getVariant` before calling
-  `createIfEnabled`.
-- `treatment` → button created; `control` / missing / anything else → `null`.
-- QA override: `?FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` shows the button without
-  emitting `$exposure`.
-
 ## Runtime configuration
 
 ### `configureApplePay(config)`
@@ -135,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 {
@@ -170,13 +123,21 @@ Consumers should listen for this event and continue payment orchestration.
 - `defineApplePayElements()`: registers both custom elements.
 - `configureApplePay(config)`: sets required runtime config (merchant ID and wallet API base URL, with optional debug bypass).
 - `ApplePayButton`: button component class.
-  - `createIfEnabled(offer, country, entryPoint?)`: returns a configured button or `null` after applying Amplitude / placement rules for the entry point. `FREE_TRIAL_POPUP` is not experiment-gated.
   - `whenReady(): Promise<void>` — resolves when the current render lifecycle completes (available or hidden). Resolves immediately if called before the element is connected.
-- `ApplePayEntryPoint`: where the button is mounted (`PAYWALL`, `REGWALL`, `DUAL_OFFER_BANNER`, `FREE_TRIAL_POPUP`).
+  - `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
@@ -184,9 +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)
-- for paywall / regwall / dual-offer banner: Amplitude variant is `treatment`, or the `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` QA param is present
-- `FREE_TRIAL_POPUP` is not Amplitude-gated — if the button is missing, check offer variant and device support instead
+- 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
@@ -237,4 +198,3 @@ Story coverage matrix:
 - `ApplePayButton` behavior and state variants are available as individual canvas stories in Storybook.
 - `ApplePayModal` docs page shows the stable default example.
 - `ApplePayModal` behavior and state variants are available as individual canvas stories in Storybook.
-

package/dist/index.js

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;
@@ -1308,10 +1310,9 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  ApplePayEntryPoint2["FREE_TRIAL_POPUP"] = "free_trial_popup";
+  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",
@@ -1355,7 +1356,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;
@@ -1384,8 +1385,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 });
@@ -2006,15 +2010,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,
@@ -2022,10 +2028,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-  },
-  ["free_trial_popup" /* FREE_TRIAL_POPUP */]: {
-    isEligible: () => true
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2044,28 +2047,29 @@ 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`
-   * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+   * - `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 (except `FREE_TRIAL_POPUP`).
-   *
-   * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2088,6 +2092,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
+    }
     if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
@@ -2232,9 +2239,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       button.removeAttribute("aria-busy");
       button.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     }
-    this.getAnimations?.({ subtree: true }).forEach(
-      (animation) => animation.cancel()
-    );
+    this.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     void this.offsetHeight;
     this.style.display = "none";
     this.querySelector(SEL_CONTAINER)?.remove();
@@ -2343,7 +2348,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;
@@ -2435,7 +2443,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,28 +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`
-     * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+     * - `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 (except `FREE_TRIAL_POPUP`).
-     *
-     * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
      *
      * @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

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;
@@ -1299,7 +1301,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 +1344,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 +1373,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 +1998,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,10 +2016,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-  },
-  ["free_trial_popup" /* FREE_TRIAL_POPUP */]: {
-    isEligible: () => true
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2032,28 +2035,29 @@ 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`
-   * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+   * - `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 (except `FREE_TRIAL_POPUP`).
-   *
-   * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2076,6 +2080,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
+    }
     if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
@@ -2220,9 +2227,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       button.removeAttribute("aria-busy");
       button.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     }
-    this.getAnimations?.({ subtree: true }).forEach(
-      (animation) => animation.cancel()
-    );
+    this.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     void this.offsetHeight;
     this.style.display = "none";
     this.querySelector(SEL_CONTAINER)?.remove();
@@ -2331,7 +2336,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

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;
@@ -1307,7 +1309,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 +1352,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 +1381,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 +2006,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,10 +2024,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-  },
-  ["free_trial_popup" /* FREE_TRIAL_POPUP */]: {
-    isEligible: () => true
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2040,28 +2043,29 @@ 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`
-   * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+   * - `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 (except `FREE_TRIAL_POPUP`).
-   *
-   * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2084,6 +2088,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
+    }
     if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
@@ -2228,9 +2235,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       button.removeAttribute("aria-busy");
       button.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     }
-    this.getAnimations?.({ subtree: true }).forEach(
-      (animation) => animation.cancel()
-    );
+    this.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     void this.offsetHeight;
     this.style.display = "none";
     this.querySelector(SEL_CONTAINER)?.remove();
@@ -2339,7 +2344,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.js

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;

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

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;
@@ -1299,7 +1301,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 +1344,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 +1373,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 +1998,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,10 +2016,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-  },
-  ["free_trial_popup" /* FREE_TRIAL_POPUP */]: {
-    isEligible: () => true
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2032,28 +2035,29 @@ 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`
-   * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+   * - `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 (except `FREE_TRIAL_POPUP`).
-   *
-   * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2076,6 +2080,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
+    }
     if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
@@ -2220,9 +2227,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       button.removeAttribute("aria-busy");
       button.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     }
-    this.getAnimations?.({ subtree: true }).forEach(
-      (animation) => animation.cancel()
-    );
+    this.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     void this.offsetHeight;
     this.style.display = "none";
     this.querySelector(SEL_CONTAINER)?.remove();
@@ -2331,7 +2336,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

@@ -2,38 +2,26 @@ export declare enum ApplePayEntryPoint {
     PAYWALL = "article_paywall",
     REGWALL = "article_regwall",
     DUAL_OFFER_BANNER = "dual_offer_banner",
-    /** Post-registration free-trial popup. Not Amplitude-gated. */
-    FREE_TRIAL_POPUP = "free_trial_popup"
+    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,17 +3,15 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  ApplePayEntryPoint2["FREE_TRIAL_POPUP"] = "free_trial_popup";
+  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

@@ -83,7 +83,9 @@ var apple_pay_modal_template_default = `<style>
     left: 0;
     width: 100%;
     height: 100%;
-    z-index: 97;
+    /* Above acquisition DualOfferBanner (1000) and Engagement ribbon (96).
+       Was 97 for wall/ribbon hosts only; hosts without a ribbon clamp need this. */
+    z-index: 1100;
     background: rgba(13, 13, 13, 0.7);
     display: flex;
     align-items: center;
@@ -1308,10 +1310,9 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["PAYWALL"] = "article_paywall";
   ApplePayEntryPoint2["REGWALL"] = "article_regwall";
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  ApplePayEntryPoint2["FREE_TRIAL_POPUP"] = "free_trial_popup";
+  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",
@@ -1355,7 +1356,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;
@@ -1384,8 +1385,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 });
@@ -2006,15 +2010,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,
@@ -2022,10 +2028,7 @@ var ENTRY_POINT_CONFIG = {
   },
   ["article_regwall" /* REGWALL */]: {
     isEligible: () => true,
-    experimentFlagKey: APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-  },
-  ["free_trial_popup" /* FREE_TRIAL_POPUP */]: {
-    isEligible: () => true
+    enabled: false
   }
 };
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
@@ -2044,28 +2047,29 @@ 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`
-   * - no Amplitude gate for `FREE_TRIAL_POPUP` (always shown)
+   * - `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 (except `FREE_TRIAL_POPUP`).
-   *
-   * - `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` / `FREE_TRIAL_POPUP`: no host-side placement gate
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2088,6 +2092,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     }
     const { isEligible: eligibilityCheck, experimentFlagKey } = config;
     const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
+    }
     if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
@@ -2232,9 +2239,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       button.removeAttribute("aria-busy");
       button.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     }
-    this.getAnimations?.({ subtree: true }).forEach(
-      (animation) => animation.cancel()
-    );
+    this.getAnimations?.({ subtree: true }).forEach((animation) => animation.cancel());
     void this.offsetHeight;
     this.style.display = "none";
     this.querySelector(SEL_CONTAINER)?.remove();
@@ -2343,7 +2348,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;
@@ -2435,7 +2443,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.2-beta.1",
+  "version": "1.11.1-beta.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",