/** * Canonical user-facing strings for the Apple Pay Express Checkout flow. * * These constants cover two categories: * 1. Local contact/field validation — fired before any BFF call, no API * message is available. * 2. Pre-purchase fallbacks — merchant validation failures, unstructured * network errors, and generic fallback handling when a BFF WalletApiError * is absent or present but not mapped to dedicated frontend copy. * * Structured BFF errors (EMAIL_COLLISION, PAYMENT_DECLINED, RECAPTCHA_FAILED, * etc.) generally are NOT represented here — their user-facing copy comes * directly from walletError.message in the API response, so copy changes on * the BFF side take effect without a frontend deploy. Unhandled structured * BFF errors may still fall back to MSG_PAYMENT_GENERIC_ERROR. */ /** Shown when a required Apple Pay contact field is absent. */ export declare const MSG_MISSING_REQUIRED_FIELD = "Missing required field"; /** Shown when the email address format is invalid (matches sma-checkout FormErrorMessages.EMAIL_WRONG_FORMAT). */ export declare const MSG_EMAIL_WRONG_FORMAT = "That email doesn\u2019t look right. Please enter a valid email address."; /** Shown when the email address exceeds 80 characters (matches sma-checkout FormErrorMessages.MAX_80_CHARS). */ 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. * Matches sma-checkout GENERIC_ERROR_MSG pattern. */ export declare const MSG_PAYMENT_GENERIC_ERROR = "Something went wrong. Please check your payment and billing details and try again or contact us."; /** Internal ContactValidationError message — not shown to the user directly. */ export declare const MSG_CONTACT_VALIDATION_INTERNAL = "Could not validate Apple Pay contact";