@economist/web-apple-pay 1.9.0 → 1.9.2

package/README.md

@@ -132,7 +132,7 @@ 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 checks (Safari/Apple device logic)
+- device/browser supports Apple Pay (Safari on Apple device required)
 - query string/feature flag gating for your page is satisfied
 - offer variant is not excluded (`bundle`, `insider_print`)
 

package/dist/index.js

@@ -1382,6 +1382,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 +1676,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);
@@ -1944,7 +1970,7 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
   ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint3;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"

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

@@ -1377,6 +1377,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 +1671,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);
@@ -1933,7 +1959,7 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"

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

@@ -1385,6 +1385,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 +1679,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);
@@ -1941,7 +1967,7 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"

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

@@ -1377,6 +1377,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 +1671,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);
@@ -1933,7 +1959,7 @@ var getSupportedBillingCountries = (offerCountry, offerVariant) => {
 };
 
 // src/constants.ts
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"

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/constants.d.ts

@@ -4,16 +4,18 @@ export declare enum ApplePayEntryPoint {
     DUAL_OFFER_BANNER = "dual_offer_banner"
 }
 /**
- * Amplitude experiment key for Apple Pay Express Checkout.
+ * 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).
  *
- * TODO: Replace with the confirmed Amplitude experiment key once available.
- * The current value is a placeholder and must be verified against the
- * Amplitude experiment dashboard before going to production.
+ * Fail-closed: missing integration, missing key, `control`, or Amplitude fetch
+ * failure on the host → button is hidden (unless QA URL param is present).
+ *
+ * Must match the Feature experiment key in Amplitude and host app constants
+ * (Engagement / Insider / Podcasts).
  */
-export declare const APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+export declare const APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 /**
  * Amplitude variant values for the Apple Pay Express Checkout experiment.
  * CONTROL   → button hidden (baseline)

package/dist/src/constants.js

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

package/dist/src/index.js

@@ -1382,6 +1382,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 +1676,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);
@@ -1944,7 +1970,7 @@ var ApplePayEntryPoint = /* @__PURE__ */ ((ApplePayEntryPoint3) => {
   ApplePayEntryPoint3["DUAL_OFFER_BANNER"] = "dual_offer_banner";
   return ApplePayEntryPoint3;
 })(ApplePayEntryPoint || {});
-var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-feature-flag-placeholder";
+var APPLE_PAY_EXPRESS_EXPERIMENT_KEY = "apple-pay-express-checkout-on-banners";
 var APPLE_PAY_EXPRESS_VARIANTS = {
   CONTROL: "control",
   TREATMENT: "treatment"

package/package.json

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