@economist/web-apple-pay 1.9.1 → 1.9.2

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);

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);

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);

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);

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

@@ -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);

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.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",