> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Idiomes compatibles: 54 idiomes i KYC multilingüe

> Didit admet 54 idiomes per a la interfície de verificació i els correus, amb detecció automàtica del navegador i codis únics.

Aquesta pàgina és la **font de veritat en temps real** dels codis d'idioma que accepta l'API de Didit. Les especificacions d'OpenAPI la referencien per als camps de nivell de sessió `language` i `contact_details.email_lang` de [Create Session](https://docs.didit.me/ca/sessions-api/create-session.md).

## On s'apliquen aquests codis

El mateix conjunt de codis s'accepta a tots els llocs on es pot configurar un idioma:

| Camp | On | Què controla |
| - | - | - |
| `language` | Cos de `POST /v3/session/` | Idioma de la **interfície de verificació** que veu l'usuari final. |
| `contact_details.email_lang` | Cos de `POST /v3/session/` | Idioma de les **notificacions per correu electrònic** (invitació, recordatoris, actualitzacions d'estat). |
| `email_language` | Cos de `PATCH /v3/session/{id}/update-status/` | Idioma del correu electrònic de canvi d'estat quan `send_email=true`. |

Si la configuració regional del navegador de l'usuari és compatible, la interfície de verificació la detecta automàticament; si no ho és, utilitza l'**anglès** (`en`) per defecte. Si no passes `email_lang`, els correus electrònics utilitzen `en`. Tots els valors distingeixen entre majúscules i minúscules: fes servir els codis exactes de la taula següent.

## Tots els idiomes admesos

El conjunt següent reflecteix les claus de `EMAIL_TRANSLATIONS` al servei: tant la interfície de verificació com la capa de localització de correus electrònics llegeixen del mateix diccionari, de manera que qualsevol codi d'aquesta taula funciona tant per a `language` com per a `email_lang`.

| # | Idioma | Nom natiu | Codi | Direcció |
| - | - | - | - | - |
| 1 | Albanès | Shqip | `sq` | LTR |
| 2 | Àrab | العربية | `ar` | **RTL** |
| 3 | Armeni | Հայերեն | `hy` | LTR |
| 4 | Bengali | বাংলা | `bn` | LTR |
| 5 | Bosnià | Bosanski | `bs` | LTR |
| 6 | Búlgar | Български | `bg` | LTR |
| 7 | Català | Català | `ca` | LTR |
| 8 | Xinès (genèric) | 中文 | `zh` | LTR |
| 9 | Xinès (simplificat) | 简体中文 | `zh-CN` | LTR |
| 10 | Xinès (tradicional) | 繁體中文 | `zh-TW` | LTR |
| 11 | Croat | Hrvatski | `hr` | LTR |
| 12 | Txec | Čeština | `cs` | LTR |
| 13 | Danès | Dansk | `da` | LTR |
| 14 | Neerlandès | Nederlands | `nl` | LTR |
| 15 | Anglès | English | `en` | LTR |
| 16 | Estonià | Eesti | `et` | LTR |
| 17 | Finlandès | Suomi | `fi` | LTR |
| 18 | Francès | Français | `fr` | LTR |
| 19 | Georgià | ქართული | `ka` | LTR |
| 20 | Alemany | Deutsch | `de` | LTR |
| 21 | Grec | Ελληνικά | `el` | LTR |
| 22 | Hebreu | עברית | `he` | **RTL** |
| 23 | Hindi | हिन्दी | `hi` | LTR |
| 24 | Hongarès | Magyar | `hu` | LTR |
| 25 | Indonesi | Bahasa Indonesia | `id` | LTR |
| 26 | Italià | Italiano | `it` | LTR |
| 27 | Japonès | 日本語 | `ja` | LTR |
| 28 | Kazakh | Қазақ тілі | `kk` | LTR |
| 29 | Coreà | 한국어 | `ko` | LTR |
| 30 | Kirguís | Кыргызча | `ky` | LTR |
| 31 | Letó | Latviešu | `lv` | LTR |
| 32 | Lituà | Lietuvių | `lt` | LTR |
| 33 | Macedoni | Македонски | `mk` | LTR |
| 34 | Malai | Bahasa Melayu | `ms` | LTR |
| 35 | Mongol | Монгол | `mn` | LTR |
| 36 | Montenegrí | Crnogorski | `cnr` | LTR |
| 37 | Noruec | Norsk | `no` | LTR |
| 38 | Persa (farsi) | فارسی | `fa` | **RTL** |
| 39 | Polonès | Polski | `pl` | LTR |
| 40 | Portuguès | Português | `pt` | LTR |
| 41 | Portuguès (Brasil) | Português (Brasil) | `pt-BR` | LTR |
| 42 | Romanès | Română | `ro` | LTR |
| 43 | Rus | Русский | `ru` | LTR |
| 44 | Serbi | Српски / Srpski | `sr` | LTR |
| 45 | Eslovac | Slovenčina | `sk` | LTR |
| 46 | Eslovè | Slovenščina | `sl` | LTR |
| 47 | Somali | Soomaali | `so` | LTR |
| 48 | Castellà | Español | `es` | LTR |
| 49 | Suec | Svenska | `sv` | LTR |
| 50 | Tai | ไทย | `th` | LTR |
| 51 | Turc | Türkçe | `tr` | LTR |
| 52 | Ucraïnès | Українська | `uk` | LTR |
| 53 | Uzbek | Oʻzbekcha | `uz` | LTR |
| 54 | Vietnamita | Tiếng Việt | `vi` | LTR |

Tres idiomes es mostren de dreta a esquerra tant a la interfície de verificació com als correus electrònics: **àrab** (`ar`), **hebreu** (`he`) i **persa / farsi** (`fa`).

> [!TIP]
>
> Els validadors que accepten aquests codis són `BaseSessionSerializer.validate_language` i `ContactDetailsSerializer.validate_email_lang`. Tots dos generen un error `400` amb el missatge `"Invalid language. Supported languages are: ..."` (o `"Invalid email language..."`) per a qualsevol valor que no sigui a la taula anterior.

## Com triar un idioma per a una sessió

La interfície de verificació **detecta automàticament** l'idioma del navegador de l'usuari. Quan l'idioma del navegador és un dels codis anteriors, la interfície i els correus electrònics es mostren en aquest idioma. Si no, la interfície utilitza l'**anglès** per defecte.

També pots definir l'idioma explícitament en crear una sessió:

```json theme={null}
{
  "workflow_id": "your-workflow-id",
  "language": "es",
  "contact_details": {
    "email": "user@example.com",
    "send_notification_emails": true,
    "email_lang": "es"
  }
}
```

Si només defineixes `language`, els correus electrònics continuaran utilitzant l'anglès per defecte, tret que també passis `email_lang`. A la inversa, definir `email_lang` no canvia l'idioma de la interfície al navegador: els dos camps són independents.

## Variants per país

Hi ha tres codis que són **variants regionals** i que has de preferir quan coneguis el teu públic:

* `pt-BR`: portuguès brasiler (usa'l en lloc de `pt` genèric per als usuaris del Brasil).
* `zh-CN`: xinès simplificat (Xina continental, Singapur).
* `zh-TW`: xinès tradicional (Taiwan, Hong Kong, Macau).

També s'accepten els codis genèrics `pt` i `zh`; la variant que triis només afecta el vocabulari i els caràcters, no la lògica de verificació subjacent.

## Com sol·licitar un idioma nou

Si necessites un idioma que no figura a la llista anterior, contacta amb el nostre equip de suport. Normalment podem afegir un idioma nou a `EMAIL_TRANSLATIONS` i a la interfície de verificació **en un termini de 24 hores** des de la teva sol·licitud. Un cop afegit, aquesta pàgina s'actualitza i l'API accepta el codi nou immediatament.

Contacta amb nosaltres a [hello@didit.me](mailto:hello@didit.me) o a través del teu canal de suport habitual per sol·licitar suport per a idiomes addicionals.

## Referències relacionades

> [card] [API per crear sessions](https://docs.didit.me/ca/sessions-api/create-session.md)
>
> On es passen `language` i `email_lang` en iniciar una verificació.

> [card] [Actualitzar l'estat de la sessió](https://docs.didit.me/ca/sessions-api/update-status.md)
>
> Defineix `email_language` per al correu de notificació del canvi d'estat.

> [card] [Webhooks](https://docs.didit.me/ca/integration/webhooks.md)
>
> Rep els resultats de la verificació: els payloads inclouen el `language` escollit.

> [card] [Models de dades](https://docs.didit.me/ca/reference/data-models.md)
>
> Esquema canònic de sessions, dades de contacte i estats.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.