> ## 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 idiomas compatíveis: KYC multilíngue

> A Didit é compatível com 54 idiomas na interface de verificação e nos e-mails, com detecção automática pelo navegador e uma fonte única dos códigos aceitos.

Esta página é a **fonte da verdade atualizada** dos códigos de idioma aceitos pela API da Didit. Ela é referenciada nas especificações OpenAPI, tanto para o campo `language` no nível da sessão quanto para o campo `contact_details.email_lang` em [Criar sessão](https://docs.didit.me/sessions-api/create-session.md).

## Onde esses códigos se aplicam

O mesmo conjunto de códigos é aceito em todos os lugares em que um idioma pode ser configurado:

| Campo | Onde | O que controla |
| - | - | - |
| `language` | Corpo de `POST /v3/session/` | Idioma da **interface de verificação** exibida ao usuário final. |
| `contact_details.email_lang` | Corpo de `POST /v3/session/` | Idioma das **notificações por e-mail** (convite, lembretes, atualizações de status). |
| `email_language` | Corpo de `PATCH /v3/session/{id}/update-status/` | Idioma do e-mail de mudança de status quando `send_email=true`. |

Se o idioma do navegador do usuário for compatível, a interface de verificação o detecta automaticamente; caso contrário, usa **inglês** (`en`) como alternativa. Se você não informar `email_lang`, os e-mails usam `en`. Todos os valores diferenciam maiúsculas de minúsculas - use exatamente os códigos da tabela abaixo.

## Todos os idiomas compatíveis

O conjunto abaixo espelha as chaves de `EMAIL_TRANSLATIONS` no serviço - tanto a interface de verificação quanto a camada de localização dos e-mails leem o mesmo dicionário, então qualquer código desta tabela funciona tanto para `language` quanto para `email_lang`.

| # | Idioma | Nome nativo | Código | Direção |
| - | - | - | - | - |
| 1 | Albanês | Shqip | `sq` | LTR |
| 2 | Árabe | العربية | `ar` | **RTL** |
| 3 | Armênio | Հայերեն | `hy` | LTR |
| 4 | Bengali | বাংলা | `bn` | LTR |
| 5 | Bósnio | Bosanski | `bs` | LTR |
| 6 | Búlgaro | Български | `bg` | LTR |
| 7 | Catalão | Català | `ca` | LTR |
| 8 | Chinês (genérico) | 中文 | `zh` | LTR |
| 9 | Chinês (simplificado) | 简体中文 | `zh-CN` | LTR |
| 10 | Chinês (tradicional) | 繁體中文 | `zh-TW` | LTR |
| 11 | Croata | Hrvatski | `hr` | LTR |
| 12 | Tcheco | Čeština | `cs` | LTR |
| 13 | Dinamarquês | Dansk | `da` | LTR |
| 14 | Holandês | Nederlands | `nl` | LTR |
| 15 | Inglês | English | `en` | LTR |
| 16 | Estoniano | Eesti | `et` | LTR |
| 17 | Finlandês | Suomi | `fi` | LTR |
| 18 | Francês | Français | `fr` | LTR |
| 19 | Georgiano | ქართული | `ka` | LTR |
| 20 | Alemão | Deutsch | `de` | LTR |
| 21 | Grego | Ελληνικά | `el` | LTR |
| 22 | Hebraico | עברית | `he` | **RTL** |
| 23 | Hindi | हिन्दी | `hi` | LTR |
| 24 | Húngaro | Magyar | `hu` | LTR |
| 25 | Indonésio | Bahasa Indonesia | `id` | LTR |
| 26 | Italiano | Italiano | `it` | LTR |
| 27 | Japonês | 日本語 | `ja` | LTR |
| 28 | Cazaque | Қазақ тілі | `kk` | LTR |
| 29 | Coreano | 한국어 | `ko` | LTR |
| 30 | Quirguiz | Кыргызча | `ky` | LTR |
| 31 | Letão | Latviešu | `lv` | LTR |
| 32 | Lituano | Lietuvių | `lt` | LTR |
| 33 | Macedônio | Македонски | `mk` | LTR |
| 34 | Malaio | Bahasa Melayu | `ms` | LTR |
| 35 | Mongol | Монгол | `mn` | LTR |
| 36 | Montenegrino | Crnogorski | `cnr` | LTR |
| 37 | Norueguês | 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 | Romeno | Română | `ro` | LTR |
| 43 | Russo | Русский | `ru` | LTR |
| 44 | Sérvio | Српски / Srpski | `sr` | LTR |
| 45 | Eslovaco | Slovenčina | `sk` | LTR |
| 46 | Esloveno | Slovenščina | `sl` | LTR |
| 47 | Somali | Soomaali | `so` | LTR |
| 48 | Espanhol | Español | `es` | LTR |
| 49 | Sueco | Svenska | `sv` | LTR |
| 50 | Tailandês | ไทย | `th` | LTR |
| 51 | Turco | Türkçe | `tr` | LTR |
| 52 | Ucraniano | Українська | `uk` | LTR |
| 53 | Uzbeque | Oʻzbekcha | `uz` | LTR |
| 54 | Vietnamita | Tiếng Việt | `vi` | LTR |

Três idiomas são exibidos da direita para a esquerda, tanto na interface de verificação quanto nos e-mails: **árabe** (`ar`), **hebraico** (`he`) e **persa / farsi** (`fa`).

> [!TIP]
>
> Os validadores que aceitam esses códigos são `BaseSessionSerializer.validate_language` e `ContactDetailsSerializer.validate_email_lang`. Ambos retornam `400` com a mensagem `"Invalid language. Supported languages are: ..."` (ou `"Invalid email language..."`) para qualquer valor fora da tabela acima.

## Como escolher o idioma de uma sessão

A interface de verificação **detecta automaticamente** o idioma do navegador do usuário. Quando o idioma do navegador é um dos códigos acima, a interface e os e-mails são exibidos nesse idioma. Caso contrário, a interface usa **inglês** como alternativa.

Você também pode definir o idioma explicitamente ao criar uma sessão:

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

Se você definir apenas `language`, os e-mails continuam em inglês por padrão, a menos que você também informe `email_lang`. Da mesma forma, definir `email_lang` não altera o idioma da interface no navegador - os dois campos são independentes.

## Variantes por país

Três códigos são **variantes regionais** que você deve preferir quando conhece o seu público:

* `pt-BR` - português do Brasil (use em vez do genérico `pt` para usuários brasileiros).
* `zh-CN` - chinês simplificado (China continental, Singapura).
* `zh-TW` - chinês tradicional (Taiwan, Hong Kong, Macau).

Os códigos genéricos `pt` e `zh` também são aceitos; a variante escolhida afeta apenas o vocabulário e os caracteres, não a lógica de verificação subjacente.

## Como solicitar um novo idioma

Se você precisa de um idioma que não está listado acima, fale com nossa equipe de suporte. Em geral, conseguimos adicionar um novo idioma a `EMAIL_TRANSLATIONS` e à interface de verificação **em até 24 horas** após a sua solicitação - depois de adicionado, esta página é atualizada e o novo código passa a ser aceito imediatamente pela API.

Fale conosco pelo [WhatsApp](https://wa.me/+19544659728) ou pelo seu canal de suporte habitual para solicitar suporte a idiomas adicionais.

## Referências relacionadas

> **[API Criar sessão](https://docs.didit.me/sessions-api/create-session.md)**
>
> Onde `language` e `email_lang` são informados ao iniciar uma verificação.

> **[Atualizar status da sessão](https://docs.didit.me/sessions-api/update-status.md)**
>
> Define `email_language` para o e-mail de notificação de mudança de status.

> **[Webhooks](https://docs.didit.me/integration/webhooks.md)**
>
> Receba os resultados da verificação - os payloads incluem o `language` escolhido.

> **[Modelos de dados](https://docs.didit.me/reference/data-models.md)**
>
> Esquema canônico de sessões, dados de contato e status.


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