> ## 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 языка для многоязычного KYC

> Didit поддерживает 54 языка для интерфейса верификации и email-уведомлений, с автоопределением языка браузера и единым источником допустимых кодов.

## Где применяются эти коды

Эта страница является **актуальным источником** кодов языков, которые принимает API Didit. На неё ссылаются OpenAPI-спецификации для поля `language` на уровне сессии и для поля `contact_details.email_lang` в запросе [Создание сессии](https://docs.didit.me/ru/sessions-api/create-session.md).

Один и тот же набор кодов принимается везде, где можно настроить язык:

| Поле | Где | За что отвечает |
| - | - | - |
| `language` | Тело запроса `POST /v3/session/` | Язык **интерфейса верификации**, который видит конечный пользователь. |
| `contact_details.email_lang` | Тело запроса `POST /v3/session/` | Язык **email-уведомлений** (приглашения, напоминания, обновления статуса). |
| `email_language` | Тело запроса `PATCH /v3/session/{id}/update-status/` | Язык письма о смене статуса, когда `send_email=true`. |

Если локаль браузера пользователя поддерживается, интерфейс верификации определяет её автоматически; в противном случае используется **английский** (`en`). Если вы не передаёте `email_lang`, письма отправляются на английском (`en`). Все значения чувствительны к регистру, поэтому используйте точные коды из таблицы ниже.

## Все поддерживаемые языки

Список ниже совпадает с ключами `EMAIL_TRANSLATIONS` в сервисе: и интерфейс верификации, и слой локализации email читают один и тот же словарь, поэтому любой код из этой таблицы работает и для `language`, и для `email_lang`.

| № | Язык | Название на языке | Код | Направление |
| - | - | - | - | - |
| 1 | Албанский | Shqip | `sq` | LTR |
| 2 | Арабский | العربية | `ar` | **RTL** |
| 3 | Армянский | Հայերեն | `hy` | LTR |
| 4 | Бенгальский | বাংলা | `bn` | LTR |
| 5 | Боснийский | Bosanski | `bs` | LTR |
| 6 | Болгарский | Български | `bg` | LTR |
| 7 | Каталанский | Català | `ca` | LTR |
| 8 | Китайский (общий) | 中文 | `zh` | LTR |
| 9 | Китайский (упрощённый) | 简体中文 | `zh-CN` | LTR |
| 10 | Китайский (традиционный) | 繁體中文 | `zh-TW` | LTR |
| 11 | Хорватский | Hrvatski | `hr` | LTR |
| 12 | Чешский | Čeština | `cs` | LTR |
| 13 | Датский | Dansk | `da` | LTR |
| 14 | Нидерландский | Nederlands | `nl` | LTR |
| 15 | Английский | English | `en` | LTR |
| 16 | Эстонский | Eesti | `et` | LTR |
| 17 | Финский | Suomi | `fi` | LTR |
| 18 | Французский | Français | `fr` | LTR |
| 19 | Грузинский | ქართული | `ka` | LTR |
| 20 | Немецкий | Deutsch | `de` | LTR |
| 21 | Греческий | Ελληνικά | `el` | LTR |
| 22 | Иврит | עברית | `he` | **RTL** |
| 23 | Хинди | हिन्दी | `hi` | LTR |
| 24 | Венгерский | Magyar | `hu` | LTR |
| 25 | Индонезийский | Bahasa Indonesia | `id` | LTR |
| 26 | Итальянский | Italiano | `it` | LTR |
| 27 | Японский | 日本語 | `ja` | LTR |
| 28 | Казахский | Қазақ тілі | `kk` | LTR |
| 29 | Корейский | 한국어 | `ko` | LTR |
| 30 | Киргизский | Кыргызча | `ky` | LTR |
| 31 | Латышский | Latviešu | `lv` | LTR |
| 32 | Литовский | Lietuvių | `lt` | LTR |
| 33 | Македонский | Македонски | `mk` | LTR |
| 34 | Малайский | Bahasa Melayu | `ms` | LTR |
| 35 | Монгольский | Монгол | `mn` | LTR |
| 36 | Черногорский | Crnogorski | `cnr` | LTR |
| 37 | Норвежский | Norsk | `no` | LTR |
| 38 | Персидский (фарси) | فارسی | `fa` | **RTL** |
| 39 | Польский | Polski | `pl` | LTR |
| 40 | Португальский | Português | `pt` | LTR |
| 41 | Португальский (Бразилия) | Português (Brasil) | `pt-BR` | LTR |
| 42 | Румынский | Română | `ro` | LTR |
| 43 | Русский | Русский | `ru` | LTR |
| 44 | Сербский | Српски / Srpski | `sr` | LTR |
| 45 | Словацкий | Slovenčina | `sk` | LTR |
| 46 | Словенский | Slovenščina | `sl` | LTR |
| 47 | Сомали | Soomaali | `so` | LTR |
| 48 | Испанский | Español | `es` | LTR |
| 49 | Шведский | Svenska | `sv` | LTR |
| 50 | Тайский | ไทย | `th` | LTR |
| 51 | Турецкий | Türkçe | `tr` | LTR |
| 52 | Украинский | Українська | `uk` | LTR |
| 53 | Узбекский | Oʻzbekcha | `uz` | LTR |
| 54 | Вьетнамский | Tiếng Việt | `vi` | LTR |

Три языка отображаются справа налево как в интерфейсе верификации, так и в письмах: **арабский** (`ar`), **иврит** (`he`) и **персидский (фарси)** (`fa`).

> [!TIP]
>
> Коды проверяют валидаторы `BaseSessionSerializer.validate_language` и `ContactDetailsSerializer.validate_email_lang`. Оба возвращают ошибку с кодом `400` и сообщением `"Invalid language. Supported languages are: ..."` (или `"Invalid email language..."`) для любого значения, которого нет в таблице выше.

## Выбор языка для сессии

Интерфейс верификации **автоматически определяет** язык браузера пользователя. Если язык браузера соответствует одному из приведённых выше кодов, интерфейс и письма выводятся на этом языке. В противном случае интерфейс переходит на **английский**.

Язык можно также задать явно при создании сессии:

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

Если вы задаёте только `language`, письма всё равно выводятся на английском, пока вы не передадите и `email_lang`. И наоборот: установка `email_lang` не меняет язык интерфейса в браузере, эти два поля независимы.

## Региональные варианты

Три кода являются **региональными вариантами**, которые стоит предпочесть, если вы знаете свою аудиторию:

* `pt-BR` — бразильский португальский (используйте вместо общего `pt` для пользователей из Бразилии).
* `zh-CN` — упрощённый китайский (материковый Китай, Сингапур).
* `zh-TW` — традиционный китайский (Тайвань, Гонконг, Макао).

Общие коды `pt` и `zh` тоже принимаются. Выбранный вариант влияет только на лексику и иероглифы, но не на логику верификации.

## Запрос нового языка

Если нужного вам языка нет в списке выше, свяжитесь с нашей службой поддержки. Обычно мы можем добавить новый язык в `EMAIL_TRANSLATIONS` и в интерфейс верификации **в течение 24 часов** после вашего запроса. После добавления эта страница обновляется, и новый код сразу принимается API.

Напишите нам на [hello@didit.me](mailto:hello@didit.me) или через привычный канал поддержки, чтобы запросить поддержку дополнительных языков.

## Связанные материалы

> [card] [API создания сессии](https://docs.didit.me/ru/sessions-api/create-session.md)
>
> Где передаются `language` и `email_lang` при запуске верификации.

> [card] [Обновление статуса сессии](https://docs.didit.me/ru/sessions-api/update-status.md)
>
> Задаёт `email_language` для письма с уведомлением об изменении статуса.

> [card] [Webhook](https://docs.didit.me/ru/integration/webhooks.md)
>
> Получайте результаты верификации: в payload содержится выбранный `language`.

> [card] [Модели данных](https://docs.didit.me/ru/reference/data-models.md)
>
> Каноническая схема для сессий, контактных данных и статусов.


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