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

package/README.md

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

package/dist/index.js

@@ -1310,7 +1310,7 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"
@@ -1353,7 +1353,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1361,14 +1361,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });
@@ -2005,9 +2005,24 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
+var ENTRY_POINT_CONFIG = {
+  ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
+  },
+  ["article_paywall" /* PAYWALL */]: {
+    isEligible: isEligibleForApplePayExpressPaywallExperiment,
+    experimentFlagKey: APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY
+  },
+  ["article_regwall" /* REGWALL */]: {
+    isEligible: () => true,
+    enabled: false
+  }
+};
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
 var DEFAULT_CURRENCY = "USD";
@@ -2024,25 +2039,24 @@ 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` using
-   * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. 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 eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
-   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-   * the dual-offer banner is only mounted for anonymous visitors.
+   * **Eligibility:**
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+   * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2058,29 +2072,40 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
     );
-    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
-    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
-    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    const resolvedEntryPoint = entryPoint || "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const config = ENTRY_POINT_CONFIG[resolvedEntryPoint];
+    if (!config) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-    );
-    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(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-          );
-        }
-      });
+    const { isEligible: eligibilityCheck, experimentFlagKey } = config;
+    const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
     }
-    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;
@@ -2393,6 +2418,8 @@ function defineApplePayElements() {
 }
 export {
   APPLE_PAY_EXCLUDED_VARIANTS,
+  APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY,
+  APPLE_PAY_EXPRESS_VARIANTS,
   ApplePayButton,
   ApplePayEntryPoint,
   ApplePayModal,

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

@@ -6,25 +6,24 @@ export declare class ApplePayButton extends HTMLElement {
     static readonly tag = "teg-apple-pay-button";
     static define(): void;
     /**
-     * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+     * Creates and configures an ApplePayButton when the entry point allows it.
      *
-     * Reads the experiment variant from `window.experimentIntegration.getVariant` using
-     * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. The host page is responsible
-     * for setting up `window.experimentIntegration` before calling this method.
+     * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+     *   no banners experiment read and no banners `$exposure`.
+     * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+     *   (`treatment` or QA URL param). The host must set up
+     *   `window.experimentIntegration` before calling for this entry point.
+     * - `REGWALL`: inert — always returns null.
      *
-     * - `treatment` → button created and returned
-     * - `control` / missing / anything else → returns null (button suppressed)
+     * **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.
      *
-     * **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.
-     *
-     * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-     * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-     * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-     * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-     * the dual-offer banner is only mounted for anonymous visitors.
+     * **Eligibility:**
+     * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+     * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
      *
      * @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,7 @@ 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",
   TREATMENT: "treatment"
@@ -1342,7 +1342,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1350,14 +1350,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });
@@ -1994,9 +1994,24 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
+var ENTRY_POINT_CONFIG = {
+  ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
+  },
+  ["article_paywall" /* PAYWALL */]: {
+    isEligible: isEligibleForApplePayExpressPaywallExperiment,
+    experimentFlagKey: APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY
+  },
+  ["article_regwall" /* REGWALL */]: {
+    isEligible: () => true,
+    enabled: false
+  }
+};
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
 var DEFAULT_CURRENCY = "USD";
@@ -2013,25 +2028,24 @@ 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` using
-   * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. 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 eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
-   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-   * the dual-offer banner is only mounted for anonymous visitors.
+   * **Eligibility:**
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+   * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2047,29 +2061,40 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
     );
-    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
-    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
-    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    const resolvedEntryPoint = entryPoint || "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const config = ENTRY_POINT_CONFIG[resolvedEntryPoint];
+    if (!config) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-    );
-    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(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-          );
-        }
-      });
+    const { isEligible: eligibilityCheck, experimentFlagKey } = config;
+    const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
     }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

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

@@ -1307,7 +1307,7 @@ 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",
   TREATMENT: "treatment"
@@ -1350,7 +1350,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1358,14 +1358,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });
@@ -2002,9 +2002,24 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
+var ENTRY_POINT_CONFIG = {
+  ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
+  },
+  ["article_paywall" /* PAYWALL */]: {
+    isEligible: isEligibleForApplePayExpressPaywallExperiment,
+    experimentFlagKey: APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY
+  },
+  ["article_regwall" /* REGWALL */]: {
+    isEligible: () => true,
+    enabled: false
+  }
+};
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
 var DEFAULT_CURRENCY = "USD";
@@ -2021,25 +2036,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant` using
-   * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. The host page is responsible
-   * for setting up `window.experimentIntegration` before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
+   * **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.
    *
-   * **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.
-   *
-   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-   * the dual-offer banner is only mounted for anonymous visitors.
+   * **Eligibility:**
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+   * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2055,29 +2069,40 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
     );
-    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
-    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
-    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    const resolvedEntryPoint = entryPoint || "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const config = ENTRY_POINT_CONFIG[resolvedEntryPoint];
+    if (!config) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-    );
-    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(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-          );
-        }
-      });
+    const { isEligible: eligibilityCheck, experimentFlagKey } = config;
+    const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
     }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

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

@@ -1299,7 +1299,7 @@ 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",
   TREATMENT: "treatment"
@@ -1342,7 +1342,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1350,14 +1350,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });
@@ -1994,9 +1994,24 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
+var ENTRY_POINT_CONFIG = {
+  ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
+  },
+  ["article_paywall" /* PAYWALL */]: {
+    isEligible: isEligibleForApplePayExpressPaywallExperiment,
+    experimentFlagKey: APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY
+  },
+  ["article_regwall" /* REGWALL */]: {
+    isEligible: () => true,
+    enabled: false
+  }
+};
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
 var DEFAULT_CURRENCY = "USD";
@@ -2013,25 +2028,24 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     define(_ApplePayButton.tag, _ApplePayButton);
   }
   /**
-   * Creates and configures an ApplePayButton when the Amplitude experiment is enabled.
+   * Creates and configures an ApplePayButton when the entry point allows it.
    *
-   * Reads the experiment variant from `window.experimentIntegration.getVariant` using
-   * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. The host page is responsible
-   * for setting up `window.experimentIntegration` before calling this method.
+   * - `DUAL_OFFER_BANNER` (or omitted): always-on after eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * - `treatment` → button created and returned
-   * - `control` / missing / anything else → returns null (button suppressed)
+   * **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.
    *
-   * **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.
-   *
-   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-   * the dual-offer banner is only mounted for anonymous visitors.
+   * **Eligibility:**
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+   * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2047,29 +2061,40 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
     );
-    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
-    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
-    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    const resolvedEntryPoint = entryPoint || "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const config = ENTRY_POINT_CONFIG[resolvedEntryPoint];
+    if (!config) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-    );
-    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(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-          );
-        }
-      });
+    const { isEligible: eligibilityCheck, experimentFlagKey } = config;
+    const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
     }
-    const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
-    if (!isTreatment && !hasUrlParamFlag) {
+    if (!hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
       return null;
     }
+    if (experimentFlagKey) {
+      const experimentValue = window.experimentIntegration?.getVariant?.(
+        experimentFlagKey
+      );
+      const isExperimentVariant = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (isExperimentVariant && isEligible && !bypassApplePayChecks() && !hasUrlParamFlag) {
+        void isApplePayAvailable().then((available) => {
+          if (available) {
+            trackApplePayExperimentExposure(
+              experimentValue,
+              getExperimentKeyFromNextData(experimentFlagKey),
+              experimentFlagKey
+            );
+          }
+        });
+      }
+      const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+      if (!isTreatment && !hasUrlParamFlag) {
+        return null;
+      }
+    }
     _ApplePayButton.define();
     const button = document.createElement(_ApplePayButton.tag);
     button.offer = offer;

package/dist/src/constants.d.ts

@@ -4,18 +4,23 @@ export declare enum ApplePayEntryPoint {
     DUAL_OFFER_BANNER = "dual_offer_banner"
 }
 /**
- * Amplitude experiment key for Apple Pay Express Checkout on banners.
- * This package reads the variant for this key internally via
- * `window.experimentIntegration.getVariant()` — set up by the host page
- * before `createIfEnabled` is called. Gates all entry points (paywall, regwall, banner).
+ * Amplitude experiment key for Apple Pay Express Checkout on article paywalls
+ * (`ApplePayEntryPoint.PAYWALL`, e.g. single-offer-paywall / multi-offer paywall).
  *
- * Fail-closed: missing integration, missing key, `control`, or Amplitude fetch
- * failure on the host → button is hidden (unless QA URL param is present).
+ * 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).
+ * (Engagement / Insider / Podcasts) while those still bridge the experiment.
  */
-export declare const APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+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_PAYWALLS_EXPERIMENT_KEY;
 /**
  * Amplitude variant values for the Apple Pay Express Checkout experiment.
  * CONTROL   → button hidden (baseline)

package/dist/src/constants.js

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

package/dist/src/index.d.ts

@@ -2,7 +2,8 @@ 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 } 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';
 export declare function defineApplePayElements(): void;

package/dist/src/index.js

@@ -1310,7 +1310,7 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint2) => {
   ApplePayEntryPoint2["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint2;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-paywalls";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"
@@ -1353,7 +1353,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -1361,14 +1361,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });
@@ -2005,9 +2005,24 @@ var getExperimentKeyFromNextData = (flagKey) => {
 
 // src/utils/applePayExpressEligibility.ts
 var isApplePayExpressHomepage = (pathname = window.location.pathname) => pathname === "/";
-var isEligibleForApplePayExpressExperiment = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressBanner = () => isApplePayExpressHomepage() && isAppleDeviceOrSafari();
+var isEligibleForApplePayExpressPaywallExperiment = () => isAppleDeviceOrSafari();
 
 // src/apple-pay-button.ts
+var ENTRY_POINT_CONFIG = {
+  ["dual_offer_banner" /* DUAL_OFFER_BANNER */]: {
+    isEligible: isEligibleForApplePayExpressBanner
+    // no experimentFlagKey → always-on after eligibility / exclusions
+  },
+  ["article_paywall" /* PAYWALL */]: {
+    isEligible: isEligibleForApplePayExpressPaywallExperiment,
+    experimentFlagKey: APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY
+  },
+  ["article_regwall" /* REGWALL */]: {
+    isEligible: () => true,
+    enabled: false
+  }
+};
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
 var DEFAULT_CURRENCY = "USD";
@@ -2024,25 +2039,24 @@ 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` using
-   * {@link APPLE_PAY_EXPRESS_EXPERIMENT_KEY}. 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 eligibility / exclusions —
+   *   no banners experiment read and no banners `$exposure`.
+   * - `PAYWALL`: experiment-gated via {@link APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY}
+   *   (`treatment` or QA URL param). The host must set up
+   *   `window.experimentIntegration` before calling for this entry point.
+   * - `REGWALL`: inert — always returns null.
    *
-   * **Transition period:** the legacy `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param
-   * gate is also evaluated as a fallback until all host apps have integrated
-   * `window.experimentIntegration`. Once all consumers are migrated, the URL param
-   * fallback will be removed.
+   * **PAYWALL only — transition period:** the legacy
+   * `FEATURE_APPLE_PAY_EXPRESS_CHECKOUT` URL param can show the button without
+   * treatment (and without inflating `$exposure`). For banners, the same URL
+   * param / `BYPASS_APPLE_PAY_CHECKS` only bypass **eligibility**, not an
+   * experiment gate.
    *
-   * **SMA-3301 eligibility:** the homepage + Safari/iPhone eligibility gate
-   * only applies to the `DUAL_OFFER_BANNER` entry point (or when `entryPoint`
-   * is omitted). `PAYWALL`/`REGWALL` entry points render on article pages and
-   * keep their pre-SMA-3301 behaviour unaffected. Anonymous is assumed because
-   * the dual-offer banner is only mounted for anonymous visitors.
+   * **Eligibility:**
+   * - `DUAL_OFFER_BANNER` (or omitted): homepage + Safari/iPhone
+   * - `PAYWALL`: Safari/Apple device only (no homepage) — article paywalls
    *
    * @param offer - The offer to display in the Apple Pay flow.
    * @param country - The user's country code.
@@ -2058,29 +2072,40 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT
     );
-    const isBannerEntryPoint = !entryPoint || entryPoint === "dual_offer_banner" /* DUAL_OFFER_BANNER */;
-    const isEligible = !isBannerEntryPoint || isEligibleForApplePayExpressExperiment();
-    if (isBannerEntryPoint && !hasUrlParamFlag && !bypassApplePayChecks() && !isEligible) {
+    const resolvedEntryPoint = entryPoint || "dual_offer_banner" /* DUAL_OFFER_BANNER */;
+    const config = ENTRY_POINT_CONFIG[resolvedEntryPoint];
+    if (!config) {
       return null;
     }
-    const experimentValue = window.experimentIntegration?.getVariant?.(
-      APPLE_PAY_EXPRESS_EXPERIMENT_KEY
-    );
-    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(APPLE_PAY_EXPRESS_EXPERIMENT_KEY)
-          );
-        }
-      });
+    const { isEligible: eligibilityCheck, experimentFlagKey } = config;
+    const isEligible = eligibilityCheck();
+    if (config.enabled === false) {
+      return null;
     }
-    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;
@@ -2393,6 +2418,8 @@ function defineApplePayElements() {
 }
 export {
   APPLE_PAY_EXCLUDED_VARIANTS,
+  APPLE_PAY_EXPRESS_PAYWALLS_EXPERIMENT_KEY,
+  APPLE_PAY_EXPRESS_VARIANTS,
   ApplePayButton,
   ApplePayEntryPoint,
   ApplePayModal,

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

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

package/dist/src/utils/applePayExpressEligibility.js

@@ -7,8 +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

@@ -11,6 +11,7 @@
  *
  * Event names are aligned to the PRD spec (section 10 — Tracking & Analytics).
  */
+import { type ApplePayExperimentFlagKey } from '../constants';
 declare global {
     interface Window {
         tedl?: {
@@ -51,11 +52,15 @@ export type ImpressionMetadata = {
  * Amplitude Experiment exposure for Apple Pay Express (SMA-3301).
  *
  * Fired from createIfEnabled only after isApplePayAvailable() succeeds
- * (control or treatment). Deduped per pathname + variant so repeated banner
- * renders on the same page do not over-count. Includes experiment_key from
- * Engagement SSR (__NEXT_DATA__) when present for run attribution.
+ * (control or treatment). Deduped per pathname + flag_key + variant so
+ * repeated renders on the same page do not over-count. Includes
+ * experiment_key from Engagement SSR (__NEXT_DATA__) when present for run
+ * attribution.
+ *
+ * @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) => void;
+export declare const trackApplePayExperimentExposure: (variant: string, experimentKey: string | undefined, flagKey: ApplePayExperimentFlagKey) => void;
 /** Wallet button displayed — emits all 5 required analytics dimensions. */
 export declare const trackExpressWalletImpression: (skuId: string, { entryPoint, country }: ImpressionMetadata) => void;
 /** Wallet button clicked */

package/dist/src/utils/expressCheckoutTracking.js

@@ -1,5 +1,4 @@
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"
@@ -42,7 +41,7 @@ var track = (action, extra) => {
     ...extra
   });
 };
-var trackApplePayExperimentExposure = (variant, experimentKey) => {
+var trackApplePayExperimentExposure = (variant, experimentKey, flagKey) => {
   const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
   if (!isActiveVariant) {
     return;
@@ -50,14 +49,14 @@ var trackApplePayExperimentExposure = (variant, experimentKey) => {
   const exposures = window.__applePayExperimentExposures ?? {};
   window.__applePayExperimentExposures = exposures;
   const pathname = window.location?.pathname ?? "";
-  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  const dedupeKey = `${pathname}:${flagKey}:${variant}`;
   if (exposures[dedupeKey]) {
     return;
   }
   exposures[dedupeKey] = true;
   emitTedlEvent({
     name: "$exposure",
-    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    flag_key: flagKey,
     variant,
     ...experimentKey ? { experiment_key: experimentKey } : {}
   });

package/package.json

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