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

# Idiomas suportados: KYC multilingue

> A Didit suporta 54 idiomas na interface de verificação e nos e-mails, com deteção automática do navegador e códigos de idioma padronizados.

Esta página é a **fonte de referência em tempo real** para os códigos de idioma aceites pela API da Didit. Está referenciada nas especificações OpenAPI, tanto para o campo `language` ao nível da sessão como para o campo `contact_details.email_lang` em [Criar sessão](https://docs.didit.me/pt/sessions-api/create-session.md).

## Onde se aplicam estes códigos

O mesmo conjunto de códigos é aceite em todos os locais onde é possível configurar um idioma:

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

Se o idioma do navegador do utilizador for suportado, a interface de verificação deteta-o automaticamente; caso contrário, recorre ao **Inglês** (`en`). Se não indicar `email_lang`, os e-mails usam `en`. Todos os valores são sensíveis a maiúsculas e minúsculas. Utilize os códigos exatos indicados na tabela abaixo.

## Todos os idiomas suportados

O conjunto abaixo reflete as chaves de `EMAIL_TRANSLATIONS` no serviço. A interface de verificação e a camada de localização de e-mails leem do mesmo dicionário, pelo que qualquer código desta tabela funciona tanto para `language` como 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 | Checo | Čeština | `cs` | LTR |
| 13 | Dinamarquês | Dansk | `da` | LTR |
| 14 | Neerlandês | Nederlands | `nl` | LTR |
| 15 | Inglês | English | `en` | LTR |
| 16 | Estónio | 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 | Polaco | 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 | Usbeque | Oʻzbekcha | `uz` | LTR |
| 54 | Vietnamita | Tiếng Việt | `vi` | LTR |

Três idiomas são apresentados da direita para a esquerda, tanto na interface de verificação como nos e-mails: **Árabe** (`ar`), **Hebraico** (`he`) e **Persa / Farsi** (`fa`).

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

## Escolher um idioma para uma sessão

A interface de verificação **deteta automaticamente** o idioma do navegador do utilizador. Quando o idioma do navegador é um dos códigos acima, a interface e os e-mails são apresentados nesse idioma. Caso contrário, a interface recorre ao **Inglês**.

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 definir apenas `language`, os e-mails continuam em Inglês, a menos que indique também `email_lang`. Inversamente, 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 deve preferir quando conhece o seu público:

* `pt-BR`: Português do Brasil (use em vez de `pt` genérico para utilizadores 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 aceites. A variante que escolher afeta apenas o vocabulário e os caracteres, não a lógica de verificação subjacente.

## Pedir um novo idioma

Se precisar de um idioma que não esteja indicado acima, contacte a nossa equipa de suporte. Normalmente, conseguimos adicionar um novo idioma a `EMAIL_TRANSLATIONS` e à interface de verificação **no prazo de 24 horas** após o seu pedido. Depois de adicionado, esta página é atualizada e o novo código passa a ser aceite de imediato pela API.

Contacte-nos em [hello@didit.me](mailto:hello@didit.me) ou através do seu canal de suporte habitual para pedir suporte a idiomas adicionais.

## Referências relacionadas

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

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

> [card] [Webhooks](https://docs.didit.me/pt/integration/webhooks.md)
>
> Receba os resultados da verificação, já que os payloads incluem o `language` escolhido.

> [card] [Modelos de dados](https://docs.didit.me/pt/reference/data-models.md)
>
> Esquema canónico para sessões, dados de contacto e estados.


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