Localization (Order Status API)

The API for localizing your extension.

OrderStatusApi

The API object provided to this and other `customer-account.order-status` extension targets.

Docs_OrderStatus_LocalizationApi

localization

Details about the location, language, and currency of the buyer. For utilities to easily format and translate content based on these details, you can use the [`i18n`](/docs/api/checkout-ui-extensions/apis/standardapi#properties-propertydetail-i18n) object instead.

OrderStatusLocalization

country

The country context of the checkout. This value carries over from the context of the cart, where it was used to contextualize the storefront experience. It will update if the buyer changes the country of their shipping address. The value is undefined if unknown.

currency

The currency that the buyer sees for money amounts in the checkout.

extensionLanguage

This is the buyer's language, as supported by the extension. If the buyer's actual language is not supported by the extension, this is the fallback locale used for translations. For example, if the buyer's language is 'fr-CA' but your extension only supports translations for 'fr', then the `isoCode` for this language is 'fr'. If your extension does not provide french translations at all, this value is the default locale for your extension (that is, the one matching your .default.json file).

language

The language the buyer sees in the checkout.

market

The [market](/docs/apps/markets) context of the checkout. This value carries over from the context of the cart, where it was used to contextualize the storefront experience. It will update if the buyer changes the country of their shipping address. The value is undefined if unknown.

timezone

The buyer’s time zone.

Country

isoCode

The ISO-3166-1 code for this country.

CountryCode

'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AR' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PS' | 'PT' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TA' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'ZZ'

Currency

isoCode

The ISO-4217 code for this currency.

CurrencyCode

'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UYW' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XDR' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XSU' | 'XTS' | 'XUA' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' | 'ZWL'

Language

isoCode

The BCP-47 language tag. It may contain a dash followed by an ISO 3166-1 alpha-2 region code.

Market

handle

The human-readable, shop-scoped identifier for the market.

id

A globally-unique identifier for a market.

Timezone

useCurrency

Returns the currency of the checkout.

UseCurrencyGeneratedType

Returns the currency of the checkout, and automatically re-renders your component if the currency changes.

Returns: Currency

export function useCurrency< Target extends RenderOrderStatusExtensionTarget = RenderOrderStatusExtensionTarget, >(): Currency { const api = useApi<Target>(); const extensionTarget = api.extension.target; if (!('currency' in api.localization)) { throw new ExtensionHasNoFieldError('currency', extensionTarget); } return useSubscription(api.localization.currency); }

Currency

isoCode

The ISO-4217 code for this currency.

CurrencyCode

useExtensionLanguage

Returns the buyer's language, as supported by the extension.

UseExtensionLanguageGeneratedType

Returns the buyer's language, as supported by the extension.

Returns: Language

export function useExtensionLanguage< Target extends RenderExtensionTarget = RenderExtensionTarget, >(): Language { const {localization} = useApi<Target>(); return useSubscription(localization.extensionLanguage); }

Language

isoCode

The BCP-47 language tag. It may contain a dash followed by an ISO 3166-1 alpha-2 region code.

useLanguage

Returns the current language of the checkout, and automatically re-renders your component if the language changes.

UseLanguageGeneratedType

Returns the current language of the checkout, and automatically re-renders your component if the language changes.

Returns: Language

export function useLanguage< Target extends RenderExtensionTarget = RenderExtensionTarget, >(): Language { const {localization} = useApi<Target>(); return useSubscription(localization.language); }

Language

isoCode

The BCP-47 language tag. It may contain a dash followed by an ISO 3166-1 alpha-2 region code.

useLocalizationCountry

Returns the country of the checkout, and automatically re-renders your component if the country changes.

UseLocalizationCountryGeneratedType

Returns the country of the checkout, and automatically re-renders your component if the country changes.

Returns: Country | undefined

export function useLocalizationCountry< Target extends RenderOrderStatusExtensionTarget = RenderOrderStatusExtensionTarget, >(): Country | undefined { const api = useApi<Target>(); const extensionTarget = api.extension.target; if (!('country' in api.localization)) { throw new ExtensionHasNoFieldError('country', extensionTarget); } return useSubscription(api.localization.country); }

Country

isoCode

The ISO-3166-1 code for this country.

CountryCode

useTimezone

Returns the time zone of the checkout, and automatically re-renders your component if the time zone changes.

UseTimezoneGeneratedType

Returns the time zone of the checkout, and automatically re-renders your component if the time zone changes.

Returns: Timezone

export function useTimezone< Target extends RenderOrderStatusExtensionTarget = RenderOrderStatusExtensionTarget, >(): Timezone { const api = useApi<Target>(); const extensionTarget = api.extension.target; if (!('timezone' in api.localization)) { throw new ExtensionHasNoFieldError('timezone', extensionTarget); } return useSubscription(api.localization.timezone); }

Timezone

useLocalizationMarket

Returns the market of the checkout, and automatically re-renders your component if it changes.

UseLocalizationMarketGeneratedType

Returns the market of the checkout, and automatically re-renders your component if it changes.

Returns: Market | undefined

export function useLocalizationMarket< Target extends RenderOrderStatusExtensionTarget = RenderOrderStatusExtensionTarget, >(): Market | undefined { const api = useApi<Target>(); const extensionTarget = api.extension.target; if (!('market' in api.localization)) { throw new ExtensionHasNoFieldError('market', extensionTarget); } return useSubscription(api.localization.market); }