> ## 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.

# 54 lingue supportate per la verifica dell'identità KYC

> Didit supporta 54 lingue per la verifica e le email di notifica, con rilevamento automatico del browser e un unico elenco di codici accettati.

Questa pagina è la **fonte di riferimento sempre aggiornata** per i codici lingua accettati dall'API Didit. Le specifiche OpenAPI la citano sia per il campo `language` a livello di sessione sia per il campo `contact_details.email_lang` in [Crea sessione](https://docs.didit.me/it/sessions-api/create-session.md).

## Dove si applicano questi codici

Lo stesso insieme di codici è accettato ovunque sia configurabile una lingua:

| Campo | Dove | Cosa controlla |
| - | - | - |
| `language` | Corpo di `POST /v3/session/` | Lingua dell'**interfaccia di verifica** mostrata all'utente finale. |
| `contact_details.email_lang` | Corpo di `POST /v3/session/` | Lingua delle **notifiche email** (invito, promemoria, aggiornamenti di stato). |
| `email_language` | Corpo di `PATCH /v3/session/{id}/update-status/` | Lingua dell'email di cambio stato quando `send_email=true`. |

Se la lingua del browser dell'utente è supportata, l'interfaccia di verifica la rileva automaticamente; altrimenti ricorre all'**inglese** (`en`). Se non passi `email_lang`, le email usano `en` come predefinita. Tutti i valori distinguono tra maiuscole e minuscole: usa i codici esatti della tabella seguente.

## Tutte le lingue supportate

L'insieme seguente riflette le chiavi di `EMAIL_TRANSLATIONS` nel servizio: sia il livello dell'interfaccia di verifica sia quello di localizzazione delle email leggono dallo stesso dizionario, quindi ogni codice in questa tabella funziona sia per `language` sia per `email_lang`.

| # | Lingua | Nome nativo | Codice | Direzione |
| - | - | - | - | - |
| 1 | Albanese | Shqip | `sq` | LTR |
| 2 | Arabo | العربية | `ar` | **RTL** |
| 3 | Armeno | Հայերեն | `hy` | LTR |
| 4 | Bengalese | বাংলা | `bn` | LTR |
| 5 | Bosniaco | Bosanski | `bs` | LTR |
| 6 | Bulgaro | Български | `bg` | LTR |
| 7 | Catalano | Català | `ca` | LTR |
| 8 | Cinese (generico) | 中文 | `zh` | LTR |
| 9 | Cinese (semplificato) | 简体中文 | `zh-CN` | LTR |
| 10 | Cinese (tradizionale) | 繁體中文 | `zh-TW` | LTR |
| 11 | Croato | Hrvatski | `hr` | LTR |
| 12 | Ceco | Čeština | `cs` | LTR |
| 13 | Danese | Dansk | `da` | LTR |
| 14 | Olandese | Nederlands | `nl` | LTR |
| 15 | Inglese | English | `en` | LTR |
| 16 | Estone | Eesti | `et` | LTR |
| 17 | Finlandese | Suomi | `fi` | LTR |
| 18 | Francese | Français | `fr` | LTR |
| 19 | Georgiano | ქართული | `ka` | LTR |
| 20 | Tedesco | Deutsch | `de` | LTR |
| 21 | Greco | Ελληνικά | `el` | LTR |
| 22 | Ebraico | עברית | `he` | **RTL** |
| 23 | Hindi | हिन्दी | `hi` | LTR |
| 24 | Ungherese | Magyar | `hu` | LTR |
| 25 | Indonesiano | Bahasa Indonesia | `id` | LTR |
| 26 | Italiano | Italiano | `it` | LTR |
| 27 | Giapponese | 日本語 | `ja` | LTR |
| 28 | Kazako | Қазақ тілі | `kk` | LTR |
| 29 | Coreano | 한국어 | `ko` | LTR |
| 30 | Kirghiso | Кыргызча | `ky` | LTR |
| 31 | Lettone | Latviešu | `lv` | LTR |
| 32 | Lituano | Lietuvių | `lt` | LTR |
| 33 | Macedone | Македонски | `mk` | LTR |
| 34 | Malese | Bahasa Melayu | `ms` | LTR |
| 35 | Mongolo | Монгол | `mn` | LTR |
| 36 | Montenegrino | Crnogorski | `cnr` | LTR |
| 37 | Norvegese | Norsk | `no` | LTR |
| 38 | Persiano (Farsi) | فارسی | `fa` | **RTL** |
| 39 | Polacco | Polski | `pl` | LTR |
| 40 | Portoghese | Português | `pt` | LTR |
| 41 | Portoghese (Brasile) | Português (Brasil) | `pt-BR` | LTR |
| 42 | Rumeno | Română | `ro` | LTR |
| 43 | Russo | Русский | `ru` | LTR |
| 44 | Serbo | Српски / Srpski | `sr` | LTR |
| 45 | Slovacco | Slovenčina | `sk` | LTR |
| 46 | Sloveno | Slovenščina | `sl` | LTR |
| 47 | Somalo | Soomaali | `so` | LTR |
| 48 | Spagnolo | Español | `es` | LTR |
| 49 | Svedese | Svenska | `sv` | LTR |
| 50 | Thai | ไทย | `th` | LTR |
| 51 | Turco | Türkçe | `tr` | LTR |
| 52 | Ucraino | Українська | `uk` | LTR |
| 53 | Uzbeco | Oʻzbekcha | `uz` | LTR |
| 54 | Vietnamita | Tiếng Việt | `vi` | LTR |

Tre lingue vengono visualizzate da destra a sinistra sia nell'interfaccia di verifica sia nelle email: **arabo** (`ar`), **ebraico** (`he`) e **persiano / farsi** (`fa`).

> [!TIP]
>
> I validatori che accettano questi codici sono `BaseSessionSerializer.validate_language` e `ContactDetailsSerializer.validate_email_lang`. Entrambi restituiscono `400` con il messaggio `"Invalid language. Supported languages are: ..."` (oppure `"Invalid email language..."`) per qualsiasi valore non presente nella tabella sopra.

## Scegliere una lingua per una sessione

L'interfaccia di verifica **rileva automaticamente** la lingua del browser dell'utente. Quando la lingua del browser è uno dei codici sopra, l'interfaccia e le email vengono visualizzate in quella lingua. In caso contrario, l'interfaccia ricorre all'**inglese**.

Puoi anche impostare la lingua in modo esplicito quando crei una sessione:

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

Se imposti solo `language`, le email restano in inglese a meno che tu non passi anche `email_lang`. Viceversa, impostare `email_lang` non cambia la lingua dell'interfaccia nel browser: i due campi sono indipendenti.

## Varianti per paese

Tre codici sono **varianti regionali** che conviene preferire quando conosci il tuo pubblico:

* `pt-BR`: portoghese brasiliano (usalo al posto del generico `pt` per gli utenti brasiliani).
* `zh-CN`: cinese semplificato (Cina continentale, Singapore).
* `zh-TW`: cinese tradizionale (Taiwan, Hong Kong, Macao).

I codici generici `pt` e `zh` sono accettati anche; la variante che scegli influisce solo sul lessico e sui caratteri, non sulla logica di verifica sottostante.

## Richiedere una nuova lingua

Se ti serve una lingua non elencata sopra, contatta il nostro team di supporto. Di solito possiamo aggiungere una nuova lingua a `EMAIL_TRANSLATIONS` e all'interfaccia di verifica **entro 24 ore** dalla richiesta. Una volta aggiunta, questa pagina viene aggiornata e il nuovo codice viene subito accettato dall'API.

Scrivici a [hello@didit.me](mailto:hello@didit.me) o tramite il tuo solito canale di supporto per richiedere il supporto a lingue aggiuntive.

## Riferimenti correlati

> [card] [API per la creazione della sessione](https://docs.didit.me/it/sessions-api/create-session.md)
>
> Indica dove vengono passati `language` e `email_lang` all'avvio di una verifica.

> [card] [Aggiorna lo stato della sessione](https://docs.didit.me/it/sessions-api/update-status.md)
>
> Imposta `email_language` per l'email di notifica della modifica di stato.

> [card] [Webhooks](https://docs.didit.me/it/integration/webhooks.md)
>
> Ricevi i risultati delle verifiche: i payload includono la lingua selezionata, inclusa nel campo `language`.

> [card] [Modelli di dati](https://docs.didit.me/it/reference/data-models.md)
>
> Schema canonico per sessioni, dati di contatto e stati.


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