@economist/web-apple-pay 1.9.1 → 1.9.3

package/dist/index.js

@@ -1303,6 +1303,19 @@ var redirectToCheckoutFallback = (params) => {
   return url.pathname + url.search;
 };
 
+// src/constants.ts
+var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
+  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
+  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
+  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  return ApplePayEntryPoint3;
+})(ApplePayEntryPoint || {});
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -1340,6 +1353,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -1382,6 +1414,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -1662,7 +1708,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);
@@ -1937,19 +1995,6 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
   return [...zoneCountries];
 };
 
-// src/constants.ts
-var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
-  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
-  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
-  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  return ApplePayEntryPoint3;
-})(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
-var APPLE_PAY_EXPRESS_VARIANTS = {
-  CONTROL: "control",
-  TREATMENT: "treatment"
-};
-
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -1995,6 +2040,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
+    if (experimentValue) {
+      trackApplePayExperimentExposure(experimentValue);
+    }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT

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

@@ -1298,6 +1298,13 @@ var redirectToCheckoutFallback = (params) => {
   return url.pathname + url.search;
 };
 
+// src/constants.ts
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -1335,6 +1342,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -1377,6 +1403,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -1657,7 +1697,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);
@@ -1932,13 +1984,6 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
   return [...zoneCountries];
 };
 
-// src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
-var APPLE_PAY_EXPRESS_VARIANTS = {
-  CONTROL: "control",
-  TREATMENT: "treatment"
-};
-
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -1984,6 +2029,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
+    if (experimentValue) {
+      trackApplePayExperimentExposure(experimentValue);
+    }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT

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

@@ -1306,6 +1306,13 @@ var redirectToCheckoutFallback = (params) => {
   return url.pathname + url.search;
 };
 
+// src/constants.ts
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -1343,6 +1350,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -1385,6 +1411,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -1665,7 +1705,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);
@@ -1940,13 +1992,6 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
   return [...zoneCountries];
 };
 
-// src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
-var APPLE_PAY_EXPRESS_VARIANTS = {
-  CONTROL: "control",
-  TREATMENT: "treatment"
-};
-
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -1992,6 +2037,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
+    if (experimentValue) {
+      trackApplePayExperimentExposure(experimentValue);
+    }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT

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

@@ -1298,6 +1298,13 @@ var redirectToCheckoutFallback = (params) => {
   return url.pathname + url.search;
 };
 
+// src/constants.ts
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -1335,6 +1342,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -1377,6 +1403,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -1657,7 +1697,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);
@@ -1932,13 +1984,6 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
   return [...zoneCountries];
 };
 
-// src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
-var APPLE_PAY_EXPRESS_VARIANTS = {
-  CONTROL: "control",
-  TREATMENT: "treatment"
-};
-
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -1984,6 +2029,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
+    if (experimentValue) {
+      trackApplePayExperimentExposure(experimentValue);
+    }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT

package/dist/src/clients/payment-checkout/messages.d.ts

@@ -22,6 +22,25 @@ export declare const MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look righ
 export declare const MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 /** Shown when the billing country is not in the supported list for the offer. */
 export declare const MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+/**
+ * Fallback user-facing message for billing country mismatch when the country
+ * name cannot be resolved from the country code.
+ */
+export declare const BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+/**
+ * User-facing message shown as an inlineError on the checkout redirect page
+ * when the billing country does not match the offer price zone.
+ */
+export declare const MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+/**
+ * Builds a short, user-facing message for a billing country mismatch, suitable
+ * for Apple's native payment sheet (~50 char limit).
+ *
+ * Returns `"[Country] address required"` (e.g. "Taiwan address required") when
+ * the country code resolves to a name, otherwise falls back to
+ * BILLING_COUNTRY_MISMATCH_FALLBACK.
+ */
+export declare const buildCountryMismatchMessage: (countryCode: string | undefined) => string;
 /**
  * Generic fallback error shown to the user when merchant validation or the
  * purchase call fails. Redirected as an inlineError on the checkout fallback page.

package/dist/src/clients/payment-checkout/messages.js

@@ -3,13 +3,30 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 export {
+  BILLING_COUNTRY_MISMATCH_FALLBACK,
+  MSG_BILLING_COUNTRY_MISMATCH_REDIRECT,
   MSG_CONTACT_VALIDATION_INTERNAL,
   MSG_EMAIL_TOO_LONG,
   MSG_EMAIL_WRONG_FORMAT,
   MSG_MISSING_REQUIRED_FIELD,
   MSG_PAYMENT_GENERIC_ERROR,
-  MSG_UNSUPPORTED_BILLING_COUNTRY
+  MSG_UNSUPPORTED_BILLING_COUNTRY,
+  buildCountryMismatchMessage
 };

package/dist/src/clients/payment-checkout/payment-handler.js

@@ -117,6 +117,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -375,7 +389,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);

package/dist/src/index.js

@@ -1303,6 +1303,19 @@ var redirectToCheckoutFallback = (params) => {
   return url.pathname + url.search;
 };
 
+// src/constants.ts
+var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
+  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
+  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
+  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
+  return ApplePayEntryPoint3;
+})(ApplePayEntryPoint || {});
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -1340,6 +1353,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -1382,6 +1414,20 @@ var MSG_MISSING_REQUIRED_FIELD = "Missing required field";
 var MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address.";
 var MSG_EMAIL_TOO_LONG = "This field must be 80 characters or less.";
 var MSG_UNSUPPORTED_BILLING_COUNTRY = "Billing country does not match offer price zone";
+var BILLING_COUNTRY_MISMATCH_FALLBACK = "Country not supported for this purchase";
+var MSG_BILLING_COUNTRY_MISMATCH_REDIRECT = "This country isn\u2019t supported for this purchase. Try updating your billing address.";
+var buildCountryMismatchMessage = (countryCode) => {
+  if (!countryCode) return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  try {
+    const regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    const upper = countryCode.toUpperCase();
+    const countryName = regionNames.of(upper);
+    const isResolved = countryName && countryName !== upper && countryName !== "Unknown Region";
+    return isResolved ? `${countryName} address required` : BILLING_COUNTRY_MISMATCH_FALLBACK;
+  } catch {
+    return BILLING_COUNTRY_MISMATCH_FALLBACK;
+  }
+};
 var MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us.";
 var MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";
 
@@ -1662,7 +1708,19 @@ async function handlePaymentAuthorized(event, session, sessionData, config) {
     });
   } catch (err) {
     if (err instanceof ContactValidationError) {
-      failApplePaySession(session, err.errors);
+      const isBillingCountryMismatch = err.errors.some(
+        (e) => e.contactField === "countryCode"
+      );
+      if (isBillingCountryMismatch) {
+        const countryCode = event.payment.billingContact?.countryCode;
+        const userMessage = buildCountryMismatchMessage(countryCode);
+        failApplePaySession(session, [
+          new ApplePayError("billingContactInvalid", "countryCode", userMessage)
+        ]);
+        redirectFallback(skuId, returnUrl, country, { inlineError: MSG_BILLING_COUNTRY_MISMATCH_REDIRECT });
+      } else {
+        failApplePaySession(session, err.errors);
+      }
       return;
     }
     const walletError = parseWalletApiError(err);
@@ -1937,19 +1995,6 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
   return [...zoneCountries];
 };
 
-// src/constants.ts
-var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
-  ApplePayEntryPoint3["PAYWALL"] = "article_paywall";
-  ApplePayEntryPoint3["REGWALL"] = "article_regwall";
-  ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
-  return ApplePayEntryPoint3;
-})(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
-var APPLE_PAY_EXPRESS_VARIANTS = {
-  CONTROL: "control",
-  TREATMENT: "treatment"
-};
-
 // src/apple-pay-button.ts
 var FEATURE_APPLE_PAY_EXPRESS_CHECKOUT = "FEATURE_APPLE_PAY_EXPRESS_CHECKOUT";
 var TOTAL_LABEL = "The Economist";
@@ -1995,6 +2040,9 @@ var ApplePayButton = class _ApplePayButton extends HTMLElement {
     const experimentValue = window.experimentIntegration?.getVariant?.(
       APPLE_PAY_EXPRESS_EXPERIMENT_KEY
     );
+    if (experimentValue) {
+      trackApplePayExperimentExposure(experimentValue);
+    }
     const isTreatment = experimentValue === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
     const hasUrlParamFlag = new URLSearchParams(window.location.search).has(
       FEATURE_APPLE_PAY_EXPRESS_CHECKOUT

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

@@ -17,6 +17,7 @@ declare global {
             events?: Record<string, unknown>[];
             [key: string]: unknown;
         };
+        __applePayExperimentExposures?: Record<string, boolean>;
     }
 }
 export declare const EXPRESS_CHECKOUT_EVENTS: {
@@ -46,6 +47,14 @@ export type ImpressionMetadata = {
     /** ISO 3166-1 alpha-2 country code of the offer (e.g. 'GB', 'US'). */
     country: string;
 };
+/**
+ * Amplitude Experiment exposure for Apple Pay Express (SMA-3301).
+ *
+ * Fired when createIfEnabled evaluates an assigned variant (control or
+ * treatment). Deduped per pathname + variant so repeated banner renders on
+ * the same page do not over-count.
+ */
+export declare const trackApplePayExperimentExposure: (variant: string) => 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,3 +1,10 @@
+// src/constants.ts
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
+var APPLE_PAY_EXPRESS_VARIANTS = {
+  CONTROL: "control",
+  TREATMENT: "treatment"
+};
+
 // src/utils/expressCheckoutTracking.ts
 var EXPRESS_CHECKOUT_EVENTS = {
   /** Wallet button displayed */
@@ -35,6 +42,25 @@ var track = (action, extra) => {
     ...extra
   });
 };
+var trackApplePayExperimentExposure = (variant) => {
+  const isActiveVariant = variant === APPLE_PAY_EXPRESS_VARIANTS.CONTROL || variant === APPLE_PAY_EXPRESS_VARIANTS.TREATMENT;
+  if (!isActiveVariant) {
+    return;
+  }
+  const exposures = window.__applePayExperimentExposures ?? {};
+  window.__applePayExperimentExposures = exposures;
+  const pathname = window.location?.pathname ?? "";
+  const dedupeKey = `${pathname}:${APPLE_PAY_EXPRESS_EXPERIMENT_KEY}:${variant}`;
+  if (exposures[dedupeKey]) {
+    return;
+  }
+  exposures[dedupeKey] = true;
+  emitTedlEvent({
+    name: "$exposure",
+    flag_key: APPLE_PAY_EXPRESS_EXPERIMENT_KEY,
+    variant
+  });
+};
 var trackExpressWalletImpression = (skuId, { entryPoint, country }) => {
   track(EXPRESS_CHECKOUT_EVENTS.IMPRESSION, {
     wallet_type: "apple_pay",
@@ -73,6 +99,7 @@ var trackValidationFieldError = (field, errorType) => {
 };
 export {
   EXPRESS_CHECKOUT_EVENTS,
+  trackApplePayExperimentExposure,
   trackExpressWalletClick,
   trackExpressWalletImpression,
   trackFallbackCheckout,

package/package.json

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