Locales

PayNext automatically translates the checkout form into the following languages. You don’t need to customize it, as we have adapted our checkout. However, if you’d like, you can override it manually.

Supported Locales

The PayNext SDK supports multiple locales for internationalization with automatic translations:

Complete Locale Codes Reference

Code	Language	Country/Region	ISO 639-1
`ar`	Arabic	-	ar
`bg`	Bulgarian	Bulgaria	bg
`cs`	Czech	Czech Republic	cs
`da`	Danish	Denmark	da
`de`	German	Germany	de
`el`	Greek	Greece	el
`en`	English	-	en
`es`	Spanish	Spain	es
`et`	Estonian	Estonia	et
`fi`	Finnish	Finland	fi
`fil`	Filipino	Philippines	fil
`fr`	French	France	fr
`hr`	Croatian	Croatia	hr
`hu`	Hungarian	Hungary	hu
`id`	Indonesian	Indonesia	id
`is`	Icelandic	Iceland	is
`it`	Italian	Italy	it
`ja`	Japanese	Japan	ja
`ko`	Korean	South Korea	ko
`lt`	Lithuanian	Lithuania	lt
`lv`	Latvian	Latvia	lv
`ms`	Malay	Malaysia	ms
`mt`	Maltese	Malta	mt
`nb`	Norwegian Bokmål	Norway	nb
`nl`	Dutch	Netherlands	nl
`nl-BE`	Dutch (Belgium)	Belgium	nl
`pl`	Polish	Poland	pl
`pt`	Portuguese	Portugal	pt
`ro`	Romanian	Romania	ro
`ru`	Russian	Russia	ru
`sk`	Slovak	Slovakia	sk
`sl`	Slovenian	Slovenia	sl
`sr`	Serbian	Serbia	sr
`sv`	Swedish	Sweden	sv
`th`	Thai	Thailand	th
`tr`	Turkish	Turkey	tr
`ua`	Ukrainian	Ukraine	uk
`vi`	Vietnamese	Vietnam	vi
`zh`	Chinese	China	zh

All locale codes follow ISO 639-1 standards. Ukrainian uses ua as the locale code while maintaining ISO 639-1 compliance with uk for the language identifier.

Locale Detection

Automatic Detection

The PayNext SDK automatically detects the user’s locale from browser settings:

Configure the locale property (and any overrides) on the object you pass into checkout.mount('element-id', { ...config }) after instantiating PayNextCheckout(), following the pattern in Mount the Checkout.

auto-detection component

import { type PayNextConfig } from '@paynext/sdk'

// Automatically detects user's browser locale
const autoLocaleConfig: PayNextConfig = {
  /* other options */
  // locale not specified - uses browser default
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', autoLocaleConfig)

Refer to Mount the Checkout for the complete mounting flow.

Optional Manual Override

If you need to override automatic detection, you can specify a locale:

manual-locale component

import { type PayNextConfig } from '@paynext/sdk'

// Force specific locale
const germanLocaleConfig: PayNextConfig = {
  /* other options */
  locale: 'de', // Always use German
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', germanLocaleConfig)

Refer to Mount the Checkout for the complete mounting flow.

Right-to-Left (RTL) Support

The PayNext SDK automatically handles RTL layout for the Arabic locale:

rtl-support component

import { type PayNextConfig } from '@paynext/sdk'

// Automatically applies RTL layout and styling
const rtlConfig: PayNextConfig = {
  /* other options */
  locale: 'ar',
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', rtlConfig)

Refer to Mount the Checkout for the complete mounting flow.

RTL layout is automatically applied for the Arabic locale. No additional configuration is needed.

Locale Fallback

When a locale is not supported or fails to load:

locale-fallback component

import { type PayNextConfig } from '@paynext/sdk'

const fallbackConfig: PayNextConfig = {
  /* other options */
  locale: 'unsupported-locale', // Falls back to 'en'
}

// When mounting (see Getting Started "Mount the Checkout" section):
// const checkout = new PayNextCheckout()
// await checkout.mount('checkout-container', fallbackConfig)

Refer to Mount the Checkout for the complete mounting flow.

The PayNext SDK automatically falls back to English (en) if the specified locale is not supported or fails to load.

Getting Started

Use Cases

Customization

Constants

Supported Locales

Locale Detection

Automatic Detection

Optional Manual Override

Right-to-Left (RTL) Support

Locale Fallback

​Supported Locales

​Locale Detection

​Automatic Detection

​Optional Manual Override

​Right-to-Left (RTL) Support

​Locale Fallback

Supported Locales

Locale Detection

Automatic Detection

Optional Manual Override

Right-to-Left (RTL) Support

Locale Fallback