@primer-io/react-native 2.45.0 → 3.0.0-beta.0

package/src/Components/internal/form-state/CardFormStateProvider.tsx

@@ -0,0 +1,302 @@
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';
+import { usePrimerCheckout } from '../../hooks/usePrimerCheckout';
+import { usePrimerCardNetwork } from '../../hooks/usePrimerCardNetwork';
+import { debounce, type DebouncedFunction } from '../../../utils/debounce';
+import { PrimerError } from '../../../models/PrimerError';
+import { formatDigitsWithGaps, maxFormattedCardNumberLength, maxPanDigits } from '../cardFormat';
+import type { CardFormField, CardFormErrors, UsePrimerCardFormReturn } from '../../types/CardFormTypes';
+
+const LOG = '[CardFormState]';
+const DEBOUNCE_MS = 275;
+const PAYMENT_METHOD_TYPE = 'PAYMENT_CARD';
+
+function formatCardNumber(value: string, gapPattern: readonly number[], maxDigits: number): string {
+  const digits = value.replace(/\D/g, '').slice(0, maxDigits);
+  return formatDigitsWithGaps(digits, gapPattern);
+}
+
+function formatExpiryDate(value: string, previous: string): string {
+  const digits = value.replace(/\D/g, '').slice(0, 4);
+  if (value.length < previous.length) {
+    return digits;
+  }
+  if (digits.length >= 2) {
+    return digits.slice(0, 2) + '/' + digits.slice(2);
+  }
+  return digits;
+}
+
+function formatCVV(value: string, maxDigits: 3 | 4): string {
+  return value.replace(/\D/g, '').slice(0, maxDigits);
+}
+
+function stripCardNumberForNative(formatted: string): string {
+  return formatted.replace(/\s/g, '');
+}
+
+// Display is MM/YY but Android's validator requires MM/YYYY; iOS accepts both.
+// Expand only once the year is fully typed (4-char "MM/YY"); partial edits
+// pass through unchanged so native can keep reporting "cannot be blank".
+function expandExpiryYearForNative(formatted: string): string {
+  const match = /^(\d{2})\/(\d{2})$/.exec(formatted);
+  return match ? `${match[1]}/20${match[2]}` : formatted;
+}
+
+const INITIAL_FOCUS: Record<CardFormField, boolean> = {
+  cardNumber: false,
+  expiryDate: false,
+  cvv: false,
+  cardholderName: false,
+};
+
+const CardFormStateContext = createContext<UsePrimerCardFormReturn | null>(null);
+
+/**
+ * Holds card-form state above the navigation stack so values survive screen
+ * unmounts (e.g. when CardFormScreen is pushed past by the country selector).
+ * Also gives every caller of `usePrimerCardForm()` the same singleton state.
+ *
+ * Consumes `PrimerCheckoutContext` for the native validation state + the
+ * `setRawData` / `submit` dispatch surfaces, so it must mount below
+ * `PrimerCheckoutProvider`.
+ */
+export function PrimerCardFormProvider({ children }: { children: ReactNode }) {
+  const {
+    isReady,
+    activeMethod,
+    cardFormState,
+    clientSession,
+    setRawData: providerSetRawData,
+    submit: providerSubmit,
+  } = usePrimerCheckout();
+
+  // CARD_INFORMATION.options.cardHolderName === false hides the field. Any other shape
+  // (no module, no options, or `true`) keeps it visible — matches native iOS/Android behavior.
+  const isCardholderNameVisible = useMemo(() => {
+    const module = clientSession?.checkoutModules?.find((m) => m.type === 'CARD_INFORMATION');
+    return module?.options?.cardHolderName !== false;
+  }, [clientSession]);
+
+  const [cardNumber, setCardNumber] = useState('');
+  const [expiryDate, setExpiryDate] = useState('');
+  const [cvv, setCVV] = useState('');
+  const [cardholderName, setCardholderName] = useState('');
+
+  const [hasBeenFocused, setHasBeenFocused] = useState<Record<CardFormField, boolean>>(INITIAL_FOCUS);
+  const [hasBeenBlurred, setHasBeenBlurred] = useState<Record<CardFormField, boolean>>(INITIAL_FOCUS);
+  const [submitAttempted, setSubmitAttempted] = useState(false);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+
+  const fieldsRef = useRef({ cardNumber: '', expiryDate: '', cvv: '', cardholderName: '' });
+  const debouncedRef = useRef<DebouncedFunction<
+    (data: { cardNumber: string; expiryDate: string; cvv: string; cardholderName: string }) => void
+  > | null>(null);
+  const isSubmittingRef = useRef(false);
+
+  useEffect(() => {
+    debouncedRef.current = debounce(
+      (data: { cardNumber: string; expiryDate: string; cvv: string; cardholderName: string }) => {
+        providerSetRawData(data).catch(() => {
+          // Provider already logs (sanitized); swallow to prevent unhandled rejection.
+        });
+      },
+      DEBOUNCE_MS
+    );
+    return () => debouncedRef.current?.cancel();
+  }, [providerSetRawData]);
+
+  // Always include cardholderName in the payload — the native SDK's required-fields set
+  // varies by client session; sending the field unconditionally keeps validation honest
+  // regardless of whether the merchant has required it server-side.
+  const syncToNative = useCallback(() => {
+    const fields = fieldsRef.current;
+    const data = {
+      cardNumber: stripCardNumberForNative(fields.cardNumber),
+      expiryDate: expandExpiryYearForNative(fields.expiryDate),
+      cvv: fields.cvv,
+      cardholderName: fields.cardholderName,
+    };
+    debouncedRef.current?.(data);
+  }, []);
+
+  // Descriptor resolves asynchronously (see usePrimerCardNetwork). Capture via a ref so
+  // updateCardNumber's useCallback dep array doesn't re-close over descriptor each
+  // render; the ref is refreshed below whenever descriptor changes.
+  const { descriptor } = usePrimerCardNetwork();
+  const descriptorRef = useRef(descriptor);
+  descriptorRef.current = descriptor;
+
+  const updateCardNumber = useCallback(
+    (value: string) => {
+      const d = descriptorRef.current;
+      const gap = d?.gapPattern ?? [4, 8, 12];
+      const max = d ? maxPanDigits(d) : 19;
+      const formatted = formatCardNumber(value, gap, max);
+      setCardNumber(formatted);
+      fieldsRef.current.cardNumber = formatted;
+      syncToNative();
+    },
+    [syncToNative]
+  );
+
+  const updateExpiryDate = useCallback(
+    (value: string) => {
+      const formatted = formatExpiryDate(value, fieldsRef.current.expiryDate);
+      setExpiryDate(formatted);
+      fieldsRef.current.expiryDate = formatted;
+      syncToNative();
+    },
+    [syncToNative]
+  );
+
+  const updateCVV = useCallback(
+    (value: string) => {
+      const formatted = formatCVV(value, descriptorRef.current.cvvLength);
+      setCVV(formatted);
+      fieldsRef.current.cvv = formatted;
+      syncToNative();
+    },
+    [syncToNative]
+  );
+
+  const updateCardholderName = useCallback(
+    (value: string) => {
+      setCardholderName(value);
+      fieldsRef.current.cardholderName = value;
+      syncToNative();
+    },
+    [syncToNative]
+  );
+
+  // Re-arm: focusing a previously-blurred field clears its blur flag so its error
+  // disappears until the user blurs again. A submit attempt overrides this gate
+  // so the user can't hide errors by tapping a field after a failed submit.
+  const markFieldFocused = useCallback((field: CardFormField) => {
+    setHasBeenFocused((prev) => (prev[field] ? prev : { ...prev, [field]: true }));
+    setHasBeenBlurred((prev) => (!prev[field] ? prev : { ...prev, [field]: false }));
+  }, []);
+
+  const markFieldBlurred = useCallback((field: CardFormField) => {
+    setHasBeenBlurred((prev) => (prev[field] ? prev : { ...prev, [field]: true }));
+  }, []);
+
+  const markSubmitAttempted = useCallback(() => {
+    setSubmitAttempted(true);
+  }, []);
+
+  const errors = useMemo(() => {
+    const visible: CardFormErrors = {};
+    for (const field of Object.keys(cardFormState.errors) as CardFormField[]) {
+      const show = submitAttempted || (hasBeenFocused[field] && hasBeenBlurred[field]);
+      if (show) visible[field] = cardFormState.errors[field];
+    }
+    return visible;
+  }, [cardFormState.errors, hasBeenFocused, hasBeenBlurred, submitAttempted]);
+
+  // Mid-typing re-format: when the detected network flips (e.g. first 4 digits
+  // resolve to AMEX), reformat what's already in the field so spacing matches the
+  // new gap pattern AND truncate if the new max is shorter (OTHER 19 → Amex 15).
+  useEffect(() => {
+    const currentDigits = fieldsRef.current.cardNumber.replace(/\D/g, '');
+    if (!currentDigits) return;
+    const maxDigits = maxPanDigits(descriptor);
+    const truncated = currentDigits.slice(0, maxDigits);
+    const reformatted = formatDigitsWithGaps(truncated, descriptor.gapPattern);
+    if (reformatted === fieldsRef.current.cardNumber) return;
+    fieldsRef.current.cardNumber = reformatted;
+    setCardNumber(reformatted);
+    // If truncation actually dropped digits, tell native so validation matches
+    // what the user sees.
+    if (truncated.length !== currentDigits.length) syncToNative();
+  }, [descriptor, syncToNative]);
+
+  const submit = useCallback(async () => {
+    // Flip submit-attempted before any guard returns so a failed submit reveals every error.
+    setSubmitAttempted(true);
+    if (!isReady || activeMethod !== PAYMENT_METHOD_TYPE) return;
+    if (isSubmittingRef.current) return;
+    debouncedRef.current?.flush();
+    if (!cardFormState.isValid) return;
+    isSubmittingRef.current = true;
+    setIsSubmitting(true);
+    try {
+      await providerSubmit();
+    } catch (err) {
+      console.error(`${LOG} submit failed: ${err instanceof PrimerError ? err.errorId : 'unknown'}`);
+    } finally {
+      isSubmittingRef.current = false;
+      setIsSubmitting(false);
+    }
+  }, [isReady, activeMethod, cardFormState.isValid, providerSubmit]);
+
+  const reset = useCallback(() => {
+    setCardNumber('');
+    setExpiryDate('');
+    setCVV('');
+    setCardholderName('');
+    setHasBeenFocused(INITIAL_FOCUS);
+    setHasBeenBlurred(INITIAL_FOCUS);
+    setSubmitAttempted(false);
+    setIsSubmitting(false);
+    isSubmittingRef.current = false;
+    fieldsRef.current = { cardNumber: '', expiryDate: '', cvv: '', cardholderName: '' };
+    debouncedRef.current?.cancel();
+    providerSetRawData({ cardNumber: '', expiryDate: '', cvv: '', cardholderName: '' }).catch(() => {});
+  }, [providerSetRawData]);
+
+  const value = useMemo<UsePrimerCardFormReturn>(
+    () => ({
+      cardNumber,
+      expiryDate,
+      cvv,
+      cardholderName,
+      updateCardNumber,
+      updateExpiryDate,
+      updateCVV,
+      updateCardholderName,
+      isValid: cardFormState.isValid,
+      errors,
+      markFieldFocused,
+      markFieldBlurred,
+      markSubmitAttempted,
+      submit,
+      isSubmitting,
+      submitAttempted,
+      requiredFields: cardFormState.requiredFields,
+      binData: cardFormState.binData,
+      descriptor,
+      cardNumberMaxLength: maxFormattedCardNumberLength(descriptor),
+      isCardholderNameVisible,
+      reset,
+    }),
+    [
+      cardNumber,
+      expiryDate,
+      cvv,
+      cardholderName,
+      updateCardNumber,
+      updateExpiryDate,
+      updateCVV,
+      updateCardholderName,
+      cardFormState.isValid,
+      cardFormState.requiredFields,
+      cardFormState.binData,
+      errors,
+      markFieldFocused,
+      markFieldBlurred,
+      markSubmitAttempted,
+      submit,
+      isSubmitting,
+      submitAttempted,
+      descriptor,
+      isCardholderNameVisible,
+      reset,
+    ]
+  );
+
+  return <CardFormStateContext.Provider value={value}>{children}</CardFormStateContext.Provider>;
+}
+
+export function useCardFormStateContext(): UsePrimerCardFormReturn | null {
+  return useContext(CardFormStateContext);
+}

package/src/Components/internal/form-state/index.ts

@@ -0,0 +1,2 @@
+export { PrimerCardFormProvider, useCardFormStateContext } from './CardFormStateProvider';
+export { BillingAddressFormStateProvider, useBillingAddressFormStateContext } from './BillingAddressFormStateProvider';

package/src/Components/internal/googlePay.ts

@@ -0,0 +1,13 @@
+import { Platform } from 'react-native';
+
+/** The Google Pay payment-method type. */
+export const GOOGLE_PAY = 'GOOGLE_PAY';
+
+/**
+ * Whether Google Pay can be presented. The iOS SDK also recognizes `GOOGLE_PAY`, so it can appear
+ * in the available-methods list on iOS — gate on `Platform.OS` so merchants need no platform branch
+ * in their render path (FR-010). Native already gated capability via `isReadyToPay`, so list
+ * membership on Android is sufficient.
+ */
+export const isGooglePaySupported = (methods: ReadonlyArray<{ paymentMethodType: string }>): boolean =>
+  Platform.OS === 'android' && methods.some((m) => m.paymentMethodType === GOOGLE_PAY);

package/src/Components/internal/localization/index.ts

@@ -0,0 +1,5 @@
+export { usePrimerLocalization } from './usePrimerLocalization';
+export { translate } from './translate';
+export { hasLocale } from './strings';
+export type { TranslationParams } from './types';
+export type { LocalizationResult } from './usePrimerLocalization';

package/src/Components/internal/localization/interpolation.ts

@@ -0,0 +1,13 @@
+import type { TranslationParams } from './types';
+
+const PLACEHOLDER_REGEX = /\{\{(\w+)\}\}/g;
+
+export function interpolate(template: string, params?: TranslationParams): string {
+  if (!params) return template;
+  return template.replace(PLACEHOLDER_REGEX, (match, key: string) => {
+    const value = params[key];
+    if (value !== undefined) return String(value);
+    console.warn(`[Primer] Missing interpolation param "${key}" in template "${template}"`);
+    return match;
+  });
+}

package/src/Components/internal/localization/locale-resolver.ts

@@ -0,0 +1,37 @@
+import type { ResolvedLocale } from './types';
+import { hasLocale } from './strings';
+
+function normalizeLocale(locale: string): string {
+  return locale.replace(/_/g, '-');
+}
+
+function getDeviceLocale(): string | null {
+  try {
+    return normalizeLocale(Intl.DateTimeFormat().resolvedOptions().locale);
+  } catch (error) {
+    console.warn('[Primer] Failed to detect device locale, falling back to "en"', error);
+    return null;
+  }
+}
+
+function extractBaseLanguage(locale: string): string {
+  return locale.split('-')[0]!;
+}
+
+function findSupportedLocale(candidate: string): string | null {
+  if (hasLocale(candidate)) return candidate;
+  const base = extractBaseLanguage(candidate);
+  if (base !== candidate && hasLocale(base)) return base;
+  return null;
+}
+
+// Resolution: device locale → base language fallback → "en"
+export function resolveLocale(): ResolvedLocale {
+  const deviceLocale = getDeviceLocale();
+  if (deviceLocale) {
+    const resolved = findSupportedLocale(deviceLocale);
+    if (resolved) return { locale: resolved, source: 'device' };
+  }
+
+  return { locale: 'en', source: 'fallback' };
+}

package/src/Components/internal/localization/strings/ar.json

@@ -0,0 +1,227 @@
+{
+  "accessibility_ach_continue_hint": "انقر مرتين للمتابعة إلى اختيار الحساب البنكي",
+  "accessibility_ach_mandate_accept_hint": "انقر مرتين لقبول التفويض وإتمام الدفع",
+  "accessibility_ach_mandate_decline_hint": "انقر مرتين للرفض وإلغاء الدفع",
+  "accessibility_action_delete": "حذف طريقة الدفع",
+  "accessibility_action_edit": "تعديل بيانات البطاقة",
+  "accessibility_action_set_default": "تعيين كطريقة الدفع الافتراضية",
+  "accessibility_card_form_billing_address_address_line_1_label": "سطر العنوان 1، مطلوب",
+  "accessibility_card_form_billing_address_address_line_2_label": "سطر العنوان 2، اختياري",
+  "accessibility_card_form_billing_address_city_hint": "أدخل اسم المدينة",
+  "accessibility_card_form_billing_address_city_label": "المدينة، مطلوبة",
+  "accessibility_card_form_billing_address_country_label": "الدولة، مطلوبة",
+  "accessibility_card_form_billing_address_first_name_label": "الاسم الأول، مطلوب",
+  "accessibility_card_form_billing_address_last_name_label": "اسم العائلة، مطلوب",
+  "accessibility_card_form_billing_address_postal_code_hint": "أدخل الرمز البريدي",
+  "accessibility_card_form_billing_address_postal_code_label": "الرمز البريدي، مطلوب",
+  "accessibility_card_form_billing_address_state_label": "الولاية/المنطقة، مطلوبة",
+  "accessibility_card_form_billing_section": "عنوان الفواتير",
+  "accessibility_card_form_card_number_error_empty": "رقم البطاقة، مطلوب",
+  "accessibility_card_form_card_number_error_invalid": "رقم البطاقة غير صالح. يرجى التحقق والمحاولة مرة أخرى.",
+  "accessibility_card_form_card_number_hint": "أدخل رقم بطاقتك",
+  "accessibility_card_form_card_number_label": "رقم البطاقة، مطلوب",
+  "accessibility_card_form_cardholder_name_hint": "أدخل الاسم كما هو مكتوب على البطاقة",
+  "accessibility_card_form_cardholder_name_label": "اسم حامل البطاقة",
+  "accessibility_card_form_cvc_error_invalid": "رمز الأمان غير صالح.",
+  "accessibility_card_form_cvc_hint": "رمز مكون من 3 أو 4 أرقام على ظهر البطاقة",
+  "accessibility_card_form_cvc_label": "رمز الأمان، مطلوب",
+  "accessibility_card_form_cvv_icon": "رمز الأمان CVV",
+  "accessibility_card_form_expiry_error_invalid": "تاريخ الانتهاء غير صالح.",
+  "accessibility_card_form_expiry_hint": "أدخل تاريخ الانتهاء بصيغة شهر/سنة",
+  "accessibility_card_form_expiry_icon": "تاريخ انتهاء البطاقة",
+  "accessibility_card_form_expiry_label": "تاريخ الانتهاء، مطلوب",
+  "accessibility_card_form_network_selector": "اختيار الشبكة",
+  "accessibility_card_form_network_selector_hint": "انقر مرتين لاختيار شبكة بطاقة مختلفة",
+  "accessibility_card_form_network_selector_inline_hint": "انقر مرتين لاختيار هذه الشبكة",
+  "accessibility_card_form_network_selector_label": "محدد شبكة البطاقة",
+  "accessibility_card_form_submit_disabled": "الزر معطل. أكمل جميع الحقول المطلوبة لتفعيل الدفع",
+  "accessibility_card_form_submit_hint": "انقر مرتين لإرسال الدفع",
+  "accessibility_card_form_submit_label": "الدفع",
+  "accessibility_card_form_submit_loading": "جاري تنفيذ عملية الدفع، يرجى الانتظار",
+  "accessibility_checkout_error_icon": "خطأ",
+  "accessibility_checkout_success_icon": "تمت عملية الدفع بنجاح",
+  "accessibility_common_back": "الرجوع",
+  "accessibility_common_cancel": "إلغاء",
+  "accessibility_common_close": "إغلاق",
+  "accessibility_common_dismiss": "إغلاق",
+  "accessibility_common_loading": "جاري التحميل، يرجى الانتظار",
+  "accessibility_common_optional": "اختياري",
+  "accessibility_common_processing_payment": "جاري تنفيذ عملية الدفع، يرجى الانتظار",
+  "accessibility_common_required": "مطلوب",
+  "accessibility_common_selected": "محدد",
+  "accessibility_common_show_all": "عرض جميع طرق الدفع المحفوظة",
+  "accessibility_country_selection_clear": "مسح",
+  "accessibility_country_selection_item": "{{countryName}}، دولة",
+  "accessibility_country_selection_search": "البحث عن الدول",
+  "accessibility_country_selection_search_icon": "بحث",
+  "accessibility_error_generic": "حدث خطأ. يرجى المحاولة مرة أخرى.",
+  "accessibility_error_multiple_errors": "تم العثور على {{count}} أخطاء",
+  "accessibility_klarna_authorize_hint": "انقر مرتين للمتابعة مع Klarna",
+  "accessibility_klarna_category": "خيار الدفع {{categoryName}}",
+  "accessibility_klarna_category_selected": "خيار الدفع {{categoryName}}، محدد",
+  "accessibility_klarna_finalize_hint": "انقر مرتين لإتمام الدفع",
+  "accessibility_klarna_payment_view": "نموذج الدفع Klarna",
+  "accessibility_payment_selection_card_full": "هذه البطاقة {{cardNetwork}} المنتهية بـ {{last4}} تنتهي صلاحيتها في {{expiry}}",
+  "accessibility_payment_selection_card_masked": "بطاقة تنتهي بأرقام مخفية",
+  "accessibility_payment_selection_coming_soon": "طريقة الدفع قريباً",
+  "accessibility_payment_selection_pay_with_card": "الدفع بالبطاقة",
+  "accessibility_payment_selection_pay_with_ideal": "الدفع بـ iDEAL",
+  "accessibility_payment_selection_pay_with_klarna": "الدفع بـ Klarna",
+  "accessibility_payment_selection_pay_with_paypal": "الدفع بـ PayPal",
+  "accessibility_paypal_logo": "PayPal",
+  "accessibility_screen_country_selection": "اختيار الدولة",
+  "accessibility_screen_error": "حدث خطأ في الدفع",
+  "accessibility_screen_loading_payment_methods": "جاري تحميل طرق الدفع",
+  "accessibility_screen_payment_method": "طريقة الدفع {{paymentMethodName}}",
+  "accessibility_screen_processing_payment": "جاري تنفيذ عملية الدفع",
+  "accessibility_screen_success": "تمت عملية الدفع بنجاح",
+  "accessibility_vault_delete_payment_method": "حذف طريقة الدفع هذه",
+  "accessibility_vaulted_ach": "حساب بنكي {{bankName}}",
+  "accessibility_vaulted_ach_full": "حساب بنكي {{bankName}} ينتهي بـ {{last4}}",
+  "accessibility_vaulted_card_full": "بطاقة {{cardNetwork}} تنتهي بـ {{last4}}، تنتهي في {{expiry}}، {{cardholderName}}",
+  "accessibility_vaulted_card_no_name": "بطاقة {{cardNetwork}} تنتهي بـ {{last4}}، تنتهي في {{expiry}}",
+  "accessibility_vaulted_klarna": "Klarna",
+  "accessibility_vaulted_klarna_email": "Klarna، {{email}}",
+  "accessibility_vaulted_method_cvv": "بطاقة {{label}}",
+  "accessibility_vaulted_payment_method": "طريقة دفع محفوظة: {{paymentMethodName}}",
+  "accessibility_vaulted_paypal": "PayPal",
+  "accessibility_vaulted_paypal_email": "PayPal، {{email}}",
+  "primer_ach_button_continue": "متابعة",
+  "primer_ach_email_disclaimer": "سنستخدم هذا فقط لإبقائك على اطلاع بشأن دفعتك",
+  "primer_ach_mandate_button_accept": "أوافق",
+  "primer_ach_mandate_button_decline": "إلغاء",
+  "primer_ach_mandate_template": "بالنقر على \"أوافق\"، فإنك تفوّض {{merchantName}} بخصم أي مبلغ مستحق من الحساب البنكي المحدد أعلاه مقابل الرسوم الناتجة عن استخدامك لخدمات {{merchantName}} و/أو شراء منتجات من {{merchantName}}، وفقاً لموقع {{merchantName}} وشروطه، حتى يتم إلغاء هذا التفويض. يمكنك تعديل أو إلغاء هذا التفويض في أي وقت بإخطار {{merchantName}} قبل 30 (ثلاثين) يوماً.",
+  "primer_ach_mandate_title": "تفويض",
+  "primer_ach_pay_with_title": "الدفع عبر ACH",
+  "primer_ach_personal_details_subtitle": "بياناتك الشخصية",
+  "primer_ach_title": "حساب بنكي",
+  "primer_ach_user_details_title": "أدخل بياناتك لربط حسابك البنكي",
+  "primer_card_form_add_card": "إضافة بطاقة",
+  "primer_card_form_billing_address_title": "عنوان الفواتير",
+  "primer_card_form_error_address1_invalid": "سطر العنوان 1 غير صالح",
+  "primer_card_form_error_address1_required": "سطر العنوان 1 مطلوب",
+  "primer_card_form_error_address2_invalid": "سطر العنوان 2 غير صالح",
+  "primer_card_form_error_address2_required": "سطر العنوان 2 مطلوب",
+  "primer_card_form_error_card_expired": "انتهت صلاحية البطاقة",
+  "primer_card_form_error_card_type_unsupported": "نوع البطاقة غير مدعوم",
+  "primer_card_form_error_city_invalid": "المدينة غير صالحة",
+  "primer_card_form_error_city_required": "المدينة مطلوبة",
+  "primer_card_form_error_country_invalid": "الدولة غير صالحة",
+  "primer_card_form_error_country_required": "الدولة مطلوبة",
+  "primer_card_form_error_cvv_invalid": "رمز CVV غير صالح",
+  "primer_card_form_error_email_invalid": "البريد الإلكتروني غير صالح",
+  "primer_card_form_error_email_required": "البريد الإلكتروني مطلوب",
+  "primer_card_form_error_expiry_invalid": "التاريخ غير صالح",
+  "primer_card_form_error_first_name_invalid": "الاسم الأول غير صالح",
+  "primer_card_form_error_first_name_required": "الاسم الأول مطلوب",
+  "primer_card_form_error_last_name_invalid": "اسم العائلة غير صالح",
+  "primer_card_form_error_last_name_required": "اسم العائلة مطلوب",
+  "primer_card_form_error_name_invalid": "اسم حامل البطاقة غير صالح",
+  "primer_card_form_error_name_length": "يجب أن يتراوح الاسم بين 2 و 45 حرفاً",
+  "primer_card_form_error_number_invalid": "رقم البطاقة غير صالح",
+  "primer_card_form_error_phone_invalid": "أدخل رقم هاتف صالح",
+  "primer_card_form_error_postal_invalid": "الرمز البريدي غير صالح",
+  "primer_card_form_error_postal_required": "الرمز البريدي مطلوب",
+  "primer_card_form_error_state_invalid": "الولاية أو المنطقة أو المقاطعة غير صالحة",
+  "primer_card_form_error_state_required": "الولاية أو المنطقة أو المقاطعة مطلوبة",
+  "primer_card_form_label_address1": "سطر العنوان 1",
+  "primer_card_form_label_address2": "سطر العنوان 2",
+  "primer_card_form_label_city": "المدينة",
+  "primer_card_form_label_country": "الدولة",
+  "primer_card_form_label_country_code": "رمز الدولة",
+  "primer_card_form_label_cvv": "CVV",
+  "primer_card_form_label_email": "البريد الإلكتروني",
+  "primer_card_form_label_expiry": "تاريخ الانتهاء",
+  "primer_card_form_label_field": "الحقل",
+  "primer_card_form_label_first_name": "الاسم الأول",
+  "primer_card_form_label_last_name": "اسم العائلة",
+  "primer_card_form_label_name": "الاسم على البطاقة",
+  "primer_card_form_label_number": "رقم البطاقة",
+  "primer_card_form_label_otp": "رمز OTP",
+  "primer_card_form_label_phone": "رقم الهاتف",
+  "primer_card_form_label_postal": "الرمز البريدي",
+  "primer_card_form_label_retail": "منفذ البيع",
+  "primer_card_form_label_state": "الولاية/المنطقة",
+  "primer_card_form_network_selector_title": "اختيار الشبكة",
+  "primer_card_form_placeholder_address1": "شارع الشيخ زايد 123",
+  "primer_card_form_placeholder_address2": "شقة 4ب",
+  "primer_card_form_placeholder_city": "دبي",
+  "primer_card_form_placeholder_country_code": "اختر الدولة",
+  "primer_card_form_placeholder_cvv": "123",
+  "primer_card_form_placeholder_cvv_amex": "1234",
+  "primer_card_form_placeholder_email": "mohammed.ahmed@example.com",
+  "primer_card_form_placeholder_expiry": "شهر/سنة",
+  "primer_card_form_placeholder_expiry_alt": "12/25",
+  "primer_card_form_placeholder_first_name": "محمد",
+  "primer_card_form_placeholder_last_name": "أحمد",
+  "primer_card_form_placeholder_name": "الاسم الكامل",
+  "primer_card_form_placeholder_number": "1234 1234 1234 1234",
+  "primer_card_form_placeholder_otp": "123456",
+  "primer_card_form_placeholder_phone": "971 50 123 4567+",
+  "primer_card_form_placeholder_postal": "12345",
+  "primer_card_form_placeholder_retail": "اختر المنفذ",
+  "primer_card_form_placeholder_state": "دبي",
+  "primer_card_form_retail_not_implemented": "اختيار منفذ البيع غير متاح بعد",
+  "primer_card_form_title": "الدفع بالبطاقة",
+  "primer_checkout_auto_dismiss_message": "ستغلق هذه الشاشة تلقائياً خلال 3 ثوانٍ",
+  "primer_checkout_dismissing": "جاري الإغلاق...",
+  "primer_checkout_error_button_other_methods": "اختر طرق دفع أخرى",
+  "primer_checkout_error_subtitle": "حدثت مشكلة في الشبكة.",
+  "primer_checkout_error_title": "فشلت عملية الدفع",
+  "primer_checkout_loading_indicator": "جاري التحميل",
+  "primer_checkout_loading_subtitle": "قد يستغرق هذا بضع ثوانٍ.",
+  "primer_checkout_processing_subtitle": "يرجى الانتظار...",
+  "primer_checkout_processing_title": "جاري معالجة عملية الدفع",
+  "primer_checkout_scope_unavailable": "عملية الدفع غير متاحة",
+  "primer_checkout_splash_subtitle": "لن يستغرق هذا وقتاً طويلاً",
+  "primer_checkout_splash_title": "جاري تحميل صفحة الدفع الآمنة",
+  "primer_checkout_success_subtitle": "سيتم توجيهك إلى صفحة تأكيد الطلب قريباً.",
+  "primer_checkout_success_title": "تمت عملية الدفع بنجاح",
+  "primer_checkout_system_error_title": "خطأ في نظام الدفع",
+  "primer_checkout_title": "الدفع",
+  "primer_common_back": "رجوع",
+  "primer_common_button_cancel": "إلغاء",
+  "primer_common_button_pay": "دفع",
+  "primer_common_button_pay_amount": "دفع {{amount}}",
+  "primer_common_button_retry": "إعادة المحاولة",
+  "primer_common_error_generic": "حدث خطأ غير معروف.",
+  "primer_common_error_unexpected": "حدث خطأ غير متوقع.",
+  "primer_country_no_results": "لم يتم العثور على دول",
+  "primer_country_placeholder_search": "بحث",
+  "primer_country_selector_placeholder": "محدد الدولة",
+  "primer_country_title": "اختيار الدولة",
+  "primer_klarna_button_authorize": "متابعة",
+  "primer_klarna_button_finalize": "ادفع",
+  "primer_klarna_loading_subtitle": "قد يستغرق هذا بضع ثوانٍ.",
+  "primer_klarna_loading_title": "جارٍ التحميل",
+  "primer_klarna_select_category_description": "اختر طريقة الدفع المفضلة",
+  "primer_misc_coming_soon": "قريباً",
+  "primer_payment_selection_empty": "لا توجد طرق دفع متاحة",
+  "primer_payment_selection_header": "اختر طريقة الدفع",
+  "primer_payment_selection_surcharge_label": "رسوم إضافية",
+  "primer_payment_selection_surcharge_may_apply": "قد يتم تطبيق رسوم إضافية",
+  "primer_payment_selection_surcharge_none": "لا توجد رسوم إضافية",
+  "primer_paypal_button_continue": "المتابعة مع PayPal",
+  "primer_paypal_redirect_description": "سيتم توجيهك إلى PayPal لإتمام عملية الدفع بأمان.",
+  "primer_paypal_title": "PayPal",
+  "primer_vault_button_show_all": "عرض الكل",
+  "primer_vault_cvv_error_generic": "حدث خطأ ما. حاول مرة أخرى.",
+  "primer_vault_cvv_error_invalid": "يرجى إدخال رمز CVV صالح.",
+  "primer_vault_cvv_hint_with_label": "أدخل رمز {{label}} الخاص بالبطاقة لعملية دفع آمنة.",
+  "primer_vault_cvv_title": "أدخل رمز CVV",
+  "primer_vault_default_bank": "حساب مصرفي",
+  "primer_vault_default_cardholder": "حامل البطاقة",
+  "primer_vault_default_klarna": "Klarna",
+  "primer_vault_default_paypal": "حساب PayPal",
+  "primer_vault_delete_button_cancel": "إلغاء",
+  "primer_vault_delete_button_confirm": "حذف",
+  "primer_vault_delete_message": "هل أنت متأكد من حذف طريقة الدفع هذه؟",
+  "primer_vault_format_card_details": "{{cardNetwork}} تنتهي بـ {{last4}}",
+  "primer_vault_format_expires": "تنتهي في {{month}}/{{year}}",
+  "primer_vault_format_masked": "•••• {{last4}}",
+  "primer_vault_manage_button_done": "تم",
+  "primer_vault_manage_button_edit": "تعديل",
+  "primer_vault_manage_title": "جميع طرق الدفع المحفوظة",
+  "primer_vault_section_title": "طرق الدفع المحفوظة",
+  "primer_vault_selected_button_other": "عرض طرق الدفع الأخرى"
+}