> ## 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는 인증 UI와 이메일 알림에 54개 언어를 지원하며, 브라우저 언어 자동 감지와 허용 언어 코드의 단일 기준을 제공합니다.

이 페이지는 Didit API가 받는 언어 코드의 **실시간 기준 자료**입니다. 세션 수준의 `language` 필드와 [세션 생성](https://docs.didit.me/ko/sessions-api/create-session.md)의 `contact_details.email_lang` 필드에 대한 OpenAPI 명세에서 이 페이지를 참조합니다.

## 이 코드가 적용되는 곳

언어를 구성할 수 있는 모든 곳에서 동일한 코드 집합이 허용됩니다.

| 필드 | 위치 | 제어 대상 |
| - | - | - |
| `language` | `POST /v3/session/` 본문 | 최종 사용자에게 보이는 **인증 UI**의 언어입니다. |
| `contact_details.email_lang` | `POST /v3/session/` 본문 | **이메일 알림**(초대, 리마인더, 상태 업데이트)의 언어입니다. |
| `email_language` | `PATCH /v3/session/{id}/update-status/` 본문 | `send_email=true`일 때 상태 변경 이메일의 언어입니다. |

사용자 브라우저의 로케일이 지원되는 언어라면 인증 UI가 이를 자동으로 감지합니다. 지원되지 않으면 **영어**(`en`)로 대체됩니다. `email_lang`을 전달하지 않으면 이메일은 `en`으로 대체됩니다. 모든 값은 대소문자를 구분하므로 아래 표의 정확한 코드를 사용하십시오.

## 지원되는 모든 언어

아래 집합은 서비스의 `EMAIL_TRANSLATIONS` 키와 같습니다. 인증 UI와 이메일 현지화 계층이 모두 같은 사전을 읽으므로, 이 표의 모든 코드는 `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 |

세 언어는 인증 UI와 이메일 모두에서 오른쪽에서 왼쪽으로 표시됩니다: **아랍어**(`ar`), **히브리어**(`he`), **페르시아어 / 파르시**(`fa`).

> [!TIP]
>
> 이 코드를 허용하는 검증기는 `BaseSessionSerializer.validate_language`와 `ContactDetailsSerializer.validate_email_lang`입니다. 위 표에 없는 값이 들어오면 두 검증기 모두 `400` 오류를 반환하며, 메시지는 `"Invalid language. Supported languages are: ..."`(또는 `"Invalid email language..."`)입니다.

## 세션의 언어 선택

인증 UI는 사용자 브라우저의 언어를 **자동으로 감지**합니다. 브라우저 언어가 위 코드 중 하나이면 인터페이스와 이메일이 해당 언어로 제공됩니다. 그렇지 않으면 UI는 **영어**로 대체됩니다.

세션을 생성할 때 언어를 명시적으로 설정할 수도 있습니다.

```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`을 설정해도 브라우저 내 UI 언어는 바뀌지 않습니다. 두 필드는 서로 독립적입니다.

## 국가별 변형

사용자 대상을 알고 있다면 다음 세 코드를 **지역 변형**으로 우선 사용하는 것이 좋습니다.

* `pt-BR`: 브라질 포르투갈어(브라질 사용자에게는 일반 `pt` 대신 사용하십시오).
* `zh-CN`: 간체 중국어(중국 본토, 싱가포르).
* `zh-TW`: 번체 중국어(대만, 홍콩, 마카오).

일반 코드 `pt`와 `zh`도 허용됩니다. 선택한 변형은 어휘와 문자에만 영향을 주며, 기본 인증 로직에는 영향을 주지 않습니다.

## 새 언어 요청

위에 나열되지 않은 언어가 필요하면 지원 팀에 문의하십시오. 보통 요청을 받은 후 **24시간 이내**에 `EMAIL_TRANSLATIONS`와 인증 UI에 새 언어를 추가할 수 있습니다. 추가되면 이 페이지가 업데이트되고, 새 코드는 API에서 즉시 허용됩니다.

추가 언어 지원을 요청하려면 [hello@didit.me](mailto:hello@didit.me)로 문의하시거나 평소 이용하는 지원 채널을 통해 연락해 주십시오.

## 관련 참조

> [card] [세션 생성 API](https://docs.didit.me/ko/sessions-api/create-session.md)
>
> 인증을 시작할 때 `language`와 `email_lang`을 전달하는 위치입니다.

> [card] [세션 상태 업데이트](https://docs.didit.me/ko/sessions-api/update-status.md)
>
> 상태 변경 알림 이메일에 사용할 `email_language`를 설정합니다.

> [card] [webhook](https://docs.didit.me/ko/integration/webhooks.md)
>
> 인증 결과를 수신합니다. payload에는 선택한 `language`가 포함됩니다.

> [card] [데이터 모델](https://docs.didit.me/ko/reference/data-models.md)
>
> 세션, 연락처 정보, 상태에 대한 표준 스키마입니다.


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