Available languages
This article details the languages supported in Kustom Checkout (KCO) and how they function.
Background
KCO supports a limited set of locales per country to maintain high-quality localized descriptions. Locale affects language only and doesn't impact purchase country or currency. For broader information on language localization, see https://en.wikipedia.org/wiki/Language_localisation.
Table of available languages and locales
| Language | Locale | Description |
|---|---|---|
| Danish | da | Default |
| Dutch | nl | Default |
| English | en en-AT en-DE en-FI en-GB en-NL en-NO en-SE en-US | Default English - Austria English - Germany English - Finland English - Great Britain English - Netherlands English - Norway English - Sweden English - United States |
| Finnish | fi | Default |
| French | fr | Default |
| German | de | Default |
| Italian | it | Default |
| Norwegian (Bokmål) | nb | Default |
| Polish | pl | Default |
| Portuguese | pt | Default |
| Spanish | es | Default |
| Swedish | sv sv-FI | Default Swedish - Finland |
How it is done
The table above lists all supported languages. Other locales may fallback to supported versions. For example, fr-GB falls back to French translations. If a locale is unsupported (e.g., zh-CN), it falls back to English. Locale is set in the createOrder or updateOrder API call using the locale property.
Order configuration examples
Example JSON (GB):
{
"purchase_country": "GB",
"purchase_currency": "GBP",
"locale": "en-GB",
"order_amount": 50000,
"order_tax_amount": 4545,
"order_lines": [
{
"type": "physical",
"reference": "19-402-USA",
"name": "Red T-Shirt",
"quantity": 5,
"quantity_unit": "pcs",
"unit_price": 10000,
"tax_rate": 1000,
"total_amount": 50000,
"total_discount_amount": 0,
"total_tax_amount": 4545
}
],
"merchant_urls": {
"terms": "https://www.example.com/terms.html",
"checkout": "https://www.example.com/checkout.html?order_id={checkout.order.id}",
"confirmation": "https://www.example.com/confirmation.html?order_id={checkout.order.id}",
"push": "https://www.example.com/api/push?order_id={checkout.order.id}"
}
}