Languages & currency

The elements adapt to the 24 official EU languages plus Catalan. They can detect the customer’s language by themselves and format amounts to the local conventions.

The list of the 25 languages

bg ca cs da de el en es et fi fr ga hr hu it lt lv mt nl pl pt ro sk sl sv

Each catalog is its own lazy-loaded file. A customer only downloads their own (about ten kB), never the other 24: switching language fetches exactly one more.

Which language renders

1. The locale attribute on <payplug-session>: set it when your page forces the language: <payplug-session locale="de">. That attribute is reactive: changing it re-renders every text in the new language.
2. The browser’s language (navigator.language) when the attribute is absent. The elements render in the browser’s language.
3. English as the last resort, if the language set or detected is not supported.

Note

A regional locale always reads its base language’s catalog.

For example, fr-BE renders the fr texts, but uses fr-BE for formatting: a Belgian customer sees French words with Belgian number conventions.

One currency, and amounts in minor units

• One currency per session, set at creation (currency: "EUR"); every amount is an integer in the currency’s minor unit (100000 = €1,000.00).
• Display uses native Intl with the currency’s own fraction digits: EUR shows two decimals, JPY shows none, and the same amount reads €1,000.00 with en, 1 000,00 € with fr. The symbol, the order and the separators always follow the locale.

What this costs your page

Nothing up front: the main bundle embeds no catalog and no CLDR data. The one catalog the session resolves is fetched when the first component renders.