@economist/web-apple-pay 2.0.0-beta.1 → 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 {
@@ -122,7 +125,8 @@ Consumers should listen for this event and continue payment orchestration.
 - `ApplePayButton`: button component class.
   - `whenReady(): Promise<void>` — resolves when the current render lifecycle completes (available or hidden). Resolves immediately if called before the element is connected.
   - `createIfEnabled(offer, country, entryPoint?)`: returns a configured button or `null`.
-    - `DUAL_OFFER_BANNER` (or omitted): always-on after homepage + Safari/Apple eligibility and offer exclusions — no banners Amplitude experiment / `$exposure`.
+    - `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.
@@ -141,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 paywalls: Amplitude treatment (or `?FEATURE_APPLE_PAY_EXPRESS_CHECKOUT`) is satisfied
-- for banners: homepage + Safari/Apple eligibility (and consumer kill switch off)
+- 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,6 +1308,7 @@ 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_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
@@ -1382,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 });
@@ -2004,15 +2008,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressBanner
-    // no experimentFlagKey → always-on after eligibility / exclusions
+    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,
@@ -2041,8 +2047,11 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
   /**
    * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-   *   no banners experiment read and no banners `$exposure`.
+   * - `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.
@@ -2050,12 +2059,14 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    *
    * **PAYWALL only — transition period:** the legacy
    * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-   * treatment (and without inflating `$exposure`). For banners, the same URL
-   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-   * experiment gate.
+   * 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
+   * - `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
    *
    * @param offer - The offer to display in the Apple Pay flow.
@@ -2086,9 +2097,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       return null;
     }
     if (experimentFlagKey) {
-      const experimentValue = window.experimentIntegration?.getVariant?.(
-        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) => {
@@ -2326,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;

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

@@ -8,8 +8,11 @@ export declare class ApplePayButton extends HTMLElement {
     /**
      * Creates and configures an ApplePayButton when the entry point allows it.
      *
-     * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-     *   no banners experiment read and no banners `$exposure`.
+     * - `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.
@@ -17,12 +20,14 @@ export declare class ApplePayButton extends HTMLElement {
      *
      * **PAYWALL only — transition period:** the legacy
      * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-     * treatment (and without inflating `$exposure`). For banners, the same URL
-     * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-     * experiment gate.
+     * 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
+     * - `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
      *
      * @param offer - The offer to display in the Apple Pay flow.

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

@@ -1371,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 });
@@ -1993,15 +1996,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressBanner
-    // no experimentFlagKey → always-on after eligibility / exclusions
+    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,
@@ -2030,8 +2035,11 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
   /**
    * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-   *   no banners experiment read and no banners `$exposure`.
+   * - `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.
@@ -2039,12 +2047,14 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    *
    * **PAYWALL only — transition period:** the legacy
    * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-   * treatment (and without inflating `$exposure`). For banners, the same URL
-   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-   * experiment gate.
+   * 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
+   * - `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
    *
    * @param offer - The offer to display in the Apple Pay flow.
@@ -2075,9 +2085,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       return null;
     }
     if (experimentFlagKey) {
-      const experimentValue = window.experimentIntegration?.getVariant?.(
-        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) => {
@@ -2315,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

@@ -1379,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 });
@@ -2001,15 +2004,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressBanner
-    // no experimentFlagKey → always-on after eligibility / exclusions
+    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,
@@ -2038,8 +2043,11 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
   /**
    * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-   *   no banners experiment read and no banners `$exposure`.
+   * - `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.
@@ -2047,12 +2055,14 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    *
    * **PAYWALL only — transition period:** the legacy
    * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-   * treatment (and without inflating `$exposure`). For banners, the same URL
-   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-   * experiment gate.
+   * 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
+   * - `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
    *
    * @param offer - The offer to display in the Apple Pay flow.
@@ -2083,9 +2093,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       return null;
     }
     if (experimentFlagKey) {
-      const experimentValue = window.experimentIntegration?.getVariant?.(
-        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) => {
@@ -2323,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

@@ -1371,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 });
@@ -1993,15 +1996,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressBanner
-    // no experimentFlagKey → always-on after eligibility / exclusions
+    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,
@@ -2030,8 +2035,11 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
   /**
    * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-   *   no banners experiment read and no banners `$exposure`.
+   * - `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.
@@ -2039,12 +2047,14 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    *
    * **PAYWALL only — transition period:** the legacy
    * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-   * treatment (and without inflating `$exposure`). For banners, the same URL
-   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-   * experiment gate.
+   * 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
+   * - `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
    *
    * @param offer - The offer to display in the Apple Pay flow.
@@ -2075,9 +2085,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       return null;
     }
     if (experimentFlagKey) {
-      const experimentValue = window.experimentIntegration?.getVariant?.(
-        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) => {
@@ -2315,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,7 +1,8 @@
 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 article paywalls

package/dist/src/constants.js

@@ -3,6 +3,7 @@ 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_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";

package/dist/src/index.js

@@ -1308,6 +1308,7 @@ 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_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
@@ -1382,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 });
@@ -2004,15 +2008,17 @@ var getExperimentKeyFromNextData = (flagKey) => {
 };
 
 // src/utils/applePayExpressEligibility.ts
-var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
 var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
 var ENTRY_POINT_CONFIG = {
   ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
-    isEligible: isEligibleForApplePayExpressBanner
-    // no experimentFlagKey → always-on after eligibility / exclusions
+    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,
@@ -2041,8 +2047,11 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
   /**
    * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
-   *   no banners experiment read and no banners `$exposure`.
+   * - `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.
@@ -2050,12 +2059,14 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
    *
    * **PAYWALL only — transition period:** the legacy
    * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
-   * treatment (and without inflating `$exposure`). For banners, the same URL
-   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
-   * experiment gate.
+   * 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
+   * - `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
    *
    * @param offer - The offer to display in the Apple Pay flow.
@@ -2086,9 +2097,7 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
       return null;
     }
     if (experimentFlagKey) {
-      const experimentValue = window.experimentIntegration?.getVariant?.(
-        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) => {
@@ -2326,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;

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

@@ -1,18 +1,17 @@
 /**
- * Host-side placement eligibility for Apple Pay Express.
+ * Host-side placement eligibility helpers for Apple Pay Express.
  *
- * Used by createIfEnabled after offer exclusions. Enforces placement and
- * device/browser eligibility (homepage + Safari/Apple for banners;
- * Safari/Apple only for paywalls). Banner surfaces are always-on after
- * eligibility; paywalls remain experiment-gated separately. Exposure
- * (paywalls) is further gated on isApplePayAvailable()
- * (BYPASS_APPLE_PAY_CHECKS respected).
+ * 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 / Free Trial homepage banners: homepage + Safari/iPhone.
  * Anonymous is assumed because these banners are only mounted for
- * anonymous visitors.
+ * anonymous visitors. Not wired into createIfEnabled ENTRY_POINT_CONFIG.
  */
 export declare const isEligibleForApplePayExpressBanner: () => boolean;
 /**

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

@@ -63,8 +63,17 @@ export type ImpressionMetadata = {
 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

@@ -70,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": "2.0.0-beta.1",
+  "version": "2.0.0-beta.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",