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

# 신분증 인증 방식: 문서, 조회, 디지털 ID 지갑

> Didit의 단일 기능으로 문서 촬영, 공인 출처 기반 비문서 조회, 디지털 ID 지갑 로그인의 3가지 방식으로 신원을 인증하세요.

신분증 인증은 세 가지 방법을 제공하는 단일 기능입니다. 국가별로 사용할 수 있는 방법을 선택하면, 최종 사용자에게는 자신이 선택한 국가에 적용되는 방법이 제공되며, 세션에는 실제로 결과를 생성한 방법이 기록됩니다.

| 방법 | 사용자가 수행하는 작업 | 보증 등급 |
| - | - | - |
| **서류 촬영** | 여권, 신분증, 운전면허증 또는 거주 허가증을 촬영합니다 | 서류 기반 |
| **비문서 조회** | 국가 신분증 번호와 몇 가지 개인 정보를 입력하며, 이는 정부 또는 기타 공인 출처와 대조하여 확인됩니다 | 데이터 일치 |
| **지갑** | MitID, BankID 또는 itsme와 같은 정부 또는 은행 디지털 신원으로 로그인합니다 | 암호화 기반 |

서류 촬영은 기존과 동일합니다. [`documents_allowed`](https://docs.didit.me/ko/management-api/workflows/feature-configs)를 통해 이미 구성한 모든 항목(허용되는 유형, 하위 유형, 촬영 규칙, 임계값, 경고)은 이전과 똑같이 작동하며, 방법에 대해 아무것도 지정하지 않은 워크플로는 서류 촬영 전용으로 유지됩니다.

## 각 방법의 작동 방식

### 서류 촬영

이 섹션의 나머지 부분에서 설명하는 내용은 다음과 같습니다. 사용자가 문서를 촬영하면 Didit이 이를 판독하고 진위 여부를 확인한 후 추출된 필드를 반환합니다. Didit이 지원하는 모든 국가에서 검사당 \$0.15에 이용할 수 있습니다. [신분증 인증 개요](https://docs.didit.me/ko/core-technology/id-verification/overview.md)부터 살펴보세요.

### 비문서 조회

사용자가 국가 신분증 번호와 몇 가지 개인 정보를 입력하면, Didit이 해당 국가의 공인 출처와 대조하여 확인합니다. 문서 사진 촬영은 필요하지 않습니다.

해당 출처는 대부분의 국가에서 정부 등록부이지만, 모든 국가가 그런 것은 아닙니다. 캐나다, 프랑스, 인도네시아, 네덜란드, 노르웨이, 싱가포르, 영국, 미국의 경우 신용 정보 기관의 파일, 금융 서비스 기록, 공과금 납부 내역 또는 거주 기록 파일이 대신 사용됩니다. 출처와 적용되는 동의 체계가 이에 따라 달라지므로 정확한 출처는 일반화되지 않고 아래 표 및 [비문서 조회](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md)에 국가별로 명시되어 있습니다.

출처에서 증명사진을 반환하는 경우(현재 남아프리카 공화국, 나이지리아, 아르헨티나, 파나마의 4개국이며, 모두 정부 등록부입니다) 사용자에게 셀피도 요청합니다. 해당 셀피에 대해 수동 라이브니스 감지가 실행되고 등록부 사진과 얼굴 대조가 수행되며, 이 모든 과정은 조회 내에서 조회 가격에 포함되어 진행됩니다. 출처에서 데이터만 반환하는 경우에는 얼굴을 대조할 대상이 없으므로 셀피를 촬영하지 않습니다. 필요한 경우 [라이브니스 감지](https://docs.didit.me/ko/core-technology/liveness/overview.md) 및 [얼굴 대조](https://docs.didit.me/ko/core-technology/face-match/overview.md)를 별도의 워크플로 단계로 실행하세요.

국가별 전체 요청 필드, 형식 규칙 및 동의 체계는 [비문서 조회](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md)에서 확인할 수 있습니다.

### 지갑

사용자는 국가 eID나 은행 신원 등 이미 보유하고 있는 디지털 신원으로 로그인합니다.
지갑이 사용자를 인증한 다음, 서명된 신원 속성을 Didit과 공유합니다.
지갑에 따라 사용자가 개인 식별 코드나 전화번호를 입력할 수 있으며, 지갑 확인에는 문서 사진이 필요하지 않습니다.

로그인 환경은 앱 전환, QR 코드 또는 사용자의 휴대폰에서 확인하는 비교 코드 등 지갑에 따라 다릅니다.
[Smart-ID 및 Mobile-ID](https://docs.didit.me/ko/core-technology/id-verification/smart-id-mobile-id.md)는 비교 코드를 사용합니다.
지갑별 속성, 프로덕션 가용성 및 실패 처리 방식은 [디지털 신원 지갑](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md)에서 확인할 수 있습니다.

## 보증 등급

모든 신분증 인증 결과에는 이를 생성한 방법에서 파생된 보증 등급이 부여됩니다. 이 등급은 순위가 아니라 실제로 무엇이 입증되었는지를 있는 그대로 설명합니다.

| 등급 | 세션 값 | 의미 |
| - | - | - |
| 서류 기반 | `documentary` | 실물 문서를 촬영, 판독하고 진위 여부를 확인했습니다. |
| 데이터 일치 | `data_match` | 사용자가 입력한 세부 정보가 조회한 출처가 보유한 기록과 일치했습니다. 문서를 검사하지 않았습니다. |
| 암호화 기반 | `cryptographic` | 디지털 신원 제공업체가 사용자를 인증하고 공유된 속성에 서명했습니다. |

> [!NOTE]
>
> 보증 등급은 관리자 대상 라벨입니다. 세션 payload, 콘솔 및 내보내기 데이터에 표시됩니다. 최종 사용자에게는 등급, 가격 또는 조회된 출처의 이름이 표시되지 않습니다.

## 국가별 방법 구성

방법은 신분증 인증(`OCR`) 기능 구성의 `methods` 키 아래에 [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) 국가 코드를 키로 하여 설정됩니다. 키를 생략하거나, 국가를 생략하거나, 국가 내에서 특정 방법을 생략하면 해당 국가는 서류 촬영 전용으로 적용됩니다.

```json theme={null}
{
  "feature": "OCR",
  "config": {
    "methods": {
      "ZAF": {
        "document": { "enabled": true },
        "id_lookup": {
          "enabled": true,
          "max_attempts": 2,
          "skip_liveness_and_face_match": true,
          "on_partial_match": "fallback_to_document",
          "on_no_match": "fallback_to_document",
          "on_provider_error": "fallback_to_document"
        },
        "wallet": { "enabled": false, "providers": [], "on_failure": "fallback_to_document" }
      },
      "DNK": {
        "document": { "enabled": true },
        "id_lookup": { "enabled": true, "on_no_match": "decline" }
      }
    }
  }
}
```

위의 두 국가는 공개된 카탈로그에서 조회에 대해 `available`로 표시되어 있습니다.
이 예제에서는 사용자의 환경에서 지갑이 활성화되어 있는지에 의존하지 않도록 지갑을 비활성화된 상태로 둡니다.
**출시 예정**으로 표시된 지갑을 활성화하는 워크플로는 거부되며, 해당 저장 요청의 다른 구성도 함께 거부됩니다.

카탈로그에서 특정 국가에 대해 지갑을 `available`로 표시하면 해당 국가의 지갑 블록은 다음과 같습니다.

```json theme={null}
{
  "DNK": {
    "document": { "enabled": true },
    "wallet": { "enabled": true, "providers": ["mitid"], "on_failure": "fallback_to_document" }
  }
}
```

요청을 전송하기 전에 카탈로그를 확인하세요. 사전 요구사항: [디지털 신원 지갑](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md)에 나열된 해당 국가에 대해 지갑 상태가 Available이어야 합니다.

저장 시 API가 적용하는 두 가지 규칙:

* **가용성은 서버에서 결정됩니다.** 기능 카탈로그에서 해당 국가에 대해 `available`로 표시하지 않은 방법이나 지갑은 거부됩니다. 콘솔의 **국가** 탭이나 [`didit_workflow_get_id_verification_methods_catalog`](https://docs.didit.me/ko/integration/mcp/tools) MCP 도구를 통해 카탈로그를 먼저 확인하세요.
* **지갑은 허용 목록이며 순위가 아닙니다.** `providers`는 국가에서 제공할 수 있는 지갑을 정의합니다. 전송하는 순서는 의미가 없으며 정규화되어 제거됩니다. 선택은 최종 사용자가 수행합니다.

기본값 및 유효성 검사를 포함한 전체 필드별 레퍼런스는 [워크플로 기능 구성](https://docs.didit.me/ko/management-api/workflows/feature-configs.md#ocr-/-신분증-인증)에서 확인할 수 있습니다.

## 대체 수단(fallback): 비문서 방식이 완료되지 않을 때 일어나는 동작

네 가지 스위치에 따라 다음 동작이 결정됩니다. 각 스위치는 `fallback_to_document`(사용자를 신분증 촬영 단계로 이동) 또는 `decline`(신분증 인증을 거부하며 세션 종료) 중 하나로 설정할 수 있습니다. `wallet.on_failure`는 아래에 설명된 `retry`도 지원합니다. 네 스위치 모두 기본값은 `fallback_to_document`입니다.

| 스위치 | 트리거 조건 |
| - | - |
| `id_lookup.on_partial_match` | 등록부에서 응답했으나 일부 필드가 일치하지 않는 경우. |
| `id_lookup.on_no_match` | 등록부에서 응답했으나 일치하는 기록을 찾을 수 없는 경우. |
| `id_lookup.on_provider_error` | 등록부에 연결할 수 없거나 응답이 없는 경우. |
| `wallet.on_failure` | 지갑 로그인이 취소되었거나, 시간 초과되었거나, 실패한 경우. |

`wallet.on_failure`는 지갑만 허용하는 국가(신분증 촬영 비활성화)를 위한 세 번째 값인 `retry`도 지원합니다.

| 값 | 완료되지 않은 로그인 시 동작 |
| - | - |
| `fallback_to_document` | 사용자를 신분증 촬영 단계로 이동시킵니다. |
| `decline` | 신분증 인증을 거부하고 세션을 종료합니다. |
| `retry` | 사용자를 지갑 단계에 유지하며 "{wallet}이(가) 완료되지 않았습니다" 메시지와 기본 "다시 {wallet} 시도하기" 버튼을 표시합니다. 신분증은 제공되지 않고 이로 인해 세션이 거부되지 않으며, 사용자가 완료하거나 세션이 만료될 때까지 열린 상태로 유지됩니다. |

`retry`는 지갑 전용입니다. "일치 항목 없음"으로 응답한 등록부는 재시도할 내용이 없으므로 조회 스위치에는 `fallback_to_document` 또는 `decline`만 설정할 수 있습니다.
신분증 촬영으로 이어지는 실패 처리가 필요한 `document.fallback_only`와 함께 사용하는 것은 허용되지 않습니다.
지갑으로 로그인하여 반환된 데이터가 워크플로의 검사(연령, 이름 일치 등)를 통과하지 못한 경우는 인증된 로그인에 해당합니다. 워크플로의 규칙에 따라 결정되며, `wallet.on_failure`는 적용되지 않습니다.
token 자체는 진짜이지만 요구 사항을 충족하지 못하는 로그인(잘못된 보증 수준, 유효하지 않은 서명, 필수 클레임 누락)은 실패로 처리되어 `wallet.on_failure`를 따릅니다.

`id_lookup.max_attempts`(1\~5, 기본값 1)는 스위치가 작동하기 전까지 사용자에게 허용되는 응답된 조회 횟수입니다. 클라이언트 측 형식 검사를 통과하지 못한 번호는 등록부에 전송되지 않으므로 시도 횟수를 소모하지 않으며, 사용자에게는 수정을 요청하기만 합니다.

지갑이나 조회가 신분증 촬영으로 대체되려면 해당 국가에서 신분증 촬영이 활성화되어 있고 최소 하나의 신분증 유형이 허용되어 있어야 합니다.
신분증 촬영이 비활성화되어 있거나 해당 국가에 허용된 신분증 유형이 없으면, 스위치가 `fallback_to_document`로 설정되어 있더라도 로그인 실패나 불일치 조회 시 세션이 거부됩니다. 단, `wallet.on_failure: retry`는 예외로 절대 거부되지 않고 사용자가 지갑 단계에 머무릅니다.
대체할 수 있는 수단이 없기 때문입니다.

**결과를 생성한 방식: `fallback_from`**

`verification_method`에는 검증된 결과를 생성한 방식인 `wallet`, `id_lookup`, `document` 중 하나가 항상 기록됩니다.
`fallback_from`은 두 가지 결과 모두에서 비문서 방식이 신분증 단계를 완료하지 못한 이유를 설명합니다.

* **대체 수단 실행.** 사용자가 신분증 촬영 단계로 이동합니다. 이후 진행되는 신분증 인증에는 `verification_method: "document"`가 적용되며, `fallback_from`에는 실패한 방식이 기록됩니다(예: `{ "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }`). 지갑으로 인증된 세션에는 `verification_method: "wallet"` 및 `fallback_from: null`이 적용됩니다.
* **거부.** 스위치가 `decline`으로 설정되어 있거나 대체할 신분증 수단이 없는 경우입니다. 거부된 신분증 인증에는 `"action": "decline"`이 포함된 `fallback_from`이 기록됩니다.

`method`는 `wallet` 또는 `id_lookup`이며, `reason`은 해당 방식을 종료시킨 결과(`cancelled`, `timeout`, `no_match`, `provider_error` 등)입니다.
동일한 필드가 세션 결정 및 [`status.updated` webhook](https://docs.didit.me/ko/integration/webhooks)으로 전달됩니다.

등록부의 무응답(시간 초과 또는 서비스 장애)은 예외로, 이 자체로 사용자를 거부하지는 않습니다.
조회 비용은 청구되지 않고 시도 횟수도 차감되지 않으며, 사용자에게 다시 시도하라는 안내가 표시됩니다.
해당 단계에서 응답 없는 조회가 3회 발생한 후에는 `id_lookup.on_provider_error`가 적용됩니다. `decline`은 거부 처리하고, `fallback_to_document`는 사용자를 신분증 촬영으로 이동시킵니다.
해당 스위치가 `fallback_to_document`이지만 국가에 대체할 신분증 수단이 없는 경우 조회가 열린 상태로 유지되어 사용자가 계속 시도할 수 있으며 세션은 거부되지 않습니다.

### 대체 수단으로만 신분증 촬영 제공

기본적으로 지갑 또는 신분증 조회와 함께 신분증 촬영을 지원하는 국가는 첫 화면에 두 방식을 나란히 표시합니다.
신분증 촬영을 처음부터 전면에 제공하지 않고 해당 국가에 계속 활성화해 두려면 `document.fallback_only`를 `true`로 설정하십시오.
사용자는 해당 국가의 지갑 또는 신분증 조회부터 시작합니다.
단일 지갑인 경우 사용자는 해당 지갑으로 바로 이동합니다.
지갑 로그인이 실패하거나 취소되거나 시간 초과된 사용자, 또는 조회가 일치하지 않는 사용자만 신분증 촬영 단계로 이동합니다.
어떤 결과에서 신분증 촬영으로 이어질지는 위의 스위치에 의해 결정되므로, 스위치 중 적어도 하나는 `fallback_to_document`로 설정되어 있어야 합니다.

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true, "fallback_only": true },
    "wallet": { "enabled": true, "providers": ["ftn"], "on_failure": "fallback_to_document" }
  }
}
```

`fallback_only`는 선택 사항이며 기본값은 `false`입니다.
`document.enabled`가 `true`가 아니거나 해당 국가의 지갑이나 신분증 조회 중 신분증 촬영으로 대체되도록 설정된 항목이 하나도 없으면 거부됩니다.
대체 수단으로 제공할 신분증 유형을 `documents_allowed`에서 활성화하십시오(예: 핀란드의 경우 여권 및 신분증).

## 각 방식의 비용

| 방식 | 가격 |
| - | - |
| 문서 촬영 | 검사당 \$0.15 |
| 비문서 조회 | [국가 및 식별자별 공개 USD 요금](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md#지원-국가-및-요금) |

위 가격은 정가 기준이며, 두 방식 모두 귀하의 [요금제 할인](https://docs.didit.me/ko/getting-started/pricing.md#할인)이 적용됩니다. 조회는 실행되는 서비스에 대해 공개 데이터베이스 검증 소매 요금을 사용하며, 한 번의 시도에 여러 서비스가 관여할 수 있습니다. 나이지리아는 NIN 또는 BVN 중 하나를 선택합니다. [국가별 표](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md#지원-국가-및-요금)에는 설정된 전체 시도 가격이 표시되며, 응답을 받은 각 재시도는 별도로 청구됩니다.

### 결제 규칙

* **응답한 등록부에 대해 조회 비용이 청구됩니다.** 일치, 부분 일치, 불일치 모두 청구 대상입니다. 쿼리가 실행되었고 응답 자체가 상품이기 때문입니다.
* **응답하지 않은 등록부는 청구되지 않습니다.** 공급자 오류에는 비용이 발생하지 않습니다.
* **클라이언트 측 형식 검사를 통과하지 못한 번호는 청구되지 않으며**, 등록부에 도달하지 않았으므로 `max_attempts` 횟수에도 포함되지 않습니다.
* **사용자가 대체 방식으로 전환하는 경우 문서 촬영 비용이 추가로 청구됩니다.** 응답을 받은 후 문서로 전환된 조회는 두 번의 검사가 실행되었으므로 두 건의 비용이 발생합니다.

## 커버리지

문서 캡처는 Didit이 지원하는 모든 국가에서 이용할 수 있으며 아래 표에는 중복 기재하지 않았습니다: 확인 건당 \$0.15. 이 표에는 **문서 외** 방식이 존재하는 국가만 나열되어 있습니다. 표에 기재되지 않은 국가이거나 계획 없음으로 표시된 항목은 문서 캡처만 지원됩니다.

| 국가 | 코드 | 문서 외 조회 | 디지털 신분증 지갑 |
| - | - | - | - |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ar.svg)아르헨티나 | `ARG` | 이용 가능 — RENAPER | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/au.svg)호주 | `AUS` | 계획 없음 | ConnectID (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/at.svg)오스트리아 | `AUT` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/be.svg)벨기에 | `BEL` | 계획 없음 | itsme (출시 예정), Smart-ID (이용 가능), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/bo.svg)볼리비아 | `BOL` | 이용 가능 — SEGIP | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)브라질 | `BRA` | 이용 가능 — Receita Federal | gov.br (출시 예정), Google Wallet (이용 가능) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/bg.svg)불가리아 | `BGR` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/kh.svg)캄보디아 | `KHM` | 이용 가능 — 내무부 유권자 등록부 | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ca.svg)캐나다 | `CAN` | 이용 가능 — 캐나다 신용정보기관 기록 (FINTRAC 듀얼 프로세스) | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cl.svg)칠레 | `CHL` | 이용 가능 — Servicio de Registro Civil e Identificación | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cn.svg)중국 | `CHN` | 이용 가능 — NCIIC (National Citizen Identity Information Center) | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/co.svg)콜롬비아 | `COL` | 이용 가능 — Registraduría General de la Nación / ANI | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cr.svg)코스타리카 | `CRI` | 이용 가능 — Tribunal Supremo de Elecciones | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/hr.svg)크로아티아 | `HRV` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cy.svg)키프로스 | `CYP` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cz.svg)체코 | `CZE` | 계획 없음 | Bank iD (출시 예정), MojeID (출시 예정), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/dk.svg)덴마크 | `DNK` | 이용 가능 — CPR 등록부 | MitID (이용 가능), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/do.svg)도미니카 공화국 | `DOM` | 이용 가능 — Junta Central Electoral | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ec.svg)에콰도르 | `ECU` | 이용 가능 — Registro Civil del Ecuador | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sv.svg)엘살바도르 | `SLV` | 이용 가능 — RNPN | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ee.svg)에스토니아 | `EST` | 계획 없음 | Smart-ID (이용 가능), Mobile-ID (이용 가능), 에스토니아 ID 카드 (출시 예정), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/fi.svg)핀란드 | `FIN` | 이용 가능 — DVV 인구 등록부 | Finnish Trust Network (이용 가능), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/fr.svg)프랑스 | `FRA` | 이용 가능 — 프랑스 거주 및 공공요금 기록 | FranceConnect (출시 예정), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/de.svg)독일 | `DEU` | 계획 없음 | Personalausweis (출시 예정), EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gr.svg)그리스 | `GRC` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gt.svg)과테말라 | `GTM` | 이용 가능 — RENAP | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/hn.svg)온두라스 | `HND` | 이용 가능 — CNE | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/hu.svg)헝가리 | `HUN` | 계획 없음 | EUDI Wallet (출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/is.svg)아이슬란드 | `ISL` | 계획 없음 | Auðkenni(출시 예정), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/in.svg)인도 | `IND` | 이용 가능 — UIDAI (Aadhaar) | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/id.svg)인도네시아 | `IDN` | 이용 가능 — 거주 기록 기반 인도네시아 주민등록 | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ie.svg)아일랜드 | `IRL` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/it.svg)이탈리아 | `ITA` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ke.svg)케냐 | `KEN` | 이용 가능 — IPRS (Integrated Population Registration System) | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/lv.svg)라트비아 | `LVA` | 계획 없음 | Smart-ID(이용 가능), eParaksts mobile(출시 예정), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/li.svg)리히텐슈타인 | `LIE` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/lt.svg)리투아니아 | `LTU` | 계획 없음 | Smart-ID(이용 가능), Mobile-ID(이용 가능), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/lu.svg)룩셈부르크 | `LUX` | 계획 없음 | itsme(출시 예정), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/my.svg)말레이시아 | `MYS` | 이용 가능 — JPN (National Registration Department) | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/mt.svg)몰타 | `MLT` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/mx.svg)멕시코 | `MEX` | 이용 가능 — RENAPO | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/nl.svg)네덜란드 | `NLD` | 이용 가능 — 네덜란드 거주 기록 | itsme(출시 예정), iDIN(이용 가능), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ng.svg)나이지리아 | `NGA` | 이용 가능 — NIMC / NIBSS | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/no.svg)노르웨이 | `NOR` | 이용 가능 — 노르웨이 거주 기록 | BankID(출시 예정), Vipps(출시 예정), Buypass ID(출시 예정), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pa.svg)파나마 | `PAN` | 이용 가능 — Tribunal Electoral / SIB | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/py.svg)파라과이 | `PRY` | 이용 가능 — Tribunal Superior de Justicia Electoral | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pe.svg)페루 | `PER` | 이용 가능 — RENIEC | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pl.svg)폴란드 | `POL` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pt.svg)포르투갈 | `PRT` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ro.svg)루마니아 | `ROU` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)싱가포르 | `SGP` | 이용 가능 — 싱가포르 신용평가기관 및 공과금 기록 | Google Wallet(이용 가능) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sk.svg)슬로바키아 | `SVK` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/si.svg)슬로베니아 | `SVN` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/za.svg)남아프리카 공화국 | `ZAF` | 이용 가능 — Department of Home Affairs | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/es.svg)스페인 | `ESP` | 계획 없음 | EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/se.svg)스웨덴 | `SWE` | 이용 가능 — Skatteverket 주민등록 | BankID(이용 가능), Freja eID(출시 예정), EUDI Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/tw.svg)대만 | `TWN` | 계획 없음 | Google Wallet(이용 가능) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/th.svg)태국 | `THA` | 이용 가능 — DOPA 주민등록 | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ua.svg)우크라이나 | `UKR` | 계획 없음 | Diia(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ae.svg)아랍에미리트 | `ARE` | 계획 없음 | UAE PASS(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)영국 | `GBR` | 지원됨 — 영국 신용정보기관 및 금융 서비스 기록 | OneID(출시 예정), Google Wallet(지원됨), GOV.UK Wallet(출시 예정) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)미국 | `USA` | 지원됨 — 미국 신용정보기관 및 금융 서비스 기록 | Google Wallet(지원됨) |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/uy.svg)우루과이 | `URY` | 지원됨 — Dirección Nacional del Registro de Estado Civil | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ve.svg)베네수엘라 | `VEN` | 지원됨 — CNE | 계획 없음 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/zm.svg)잠비아 | `ZMB` | 지원됨 — Zambia Revenue Authority | 계획 없음 |

> [!NOTE]
>
> 지원 범위는 백엔드가 제공하는 기능 카탈로그에서 생성되므로, 이 표는 콘솔과 API가 검증에 사용하는 소스와 동일합니다. **출시 예정**은 해당 항목이 콘솔에 표시되지만 아직 활성화할 수 없음을 의미하며, 라이브 기능이 아니며 확정된 출시 일정도 제공되지 않습니다.

## 세션에 기록되는 내용

모든 신분증 인증 결과에는 이를 생성한 인증 방식, 보증 등급, 그리고 비문서 기반 방식이 실행된 경우 방식별 증거 블록이 포함됩니다. 문서 기반 세션은 이전과 동일한 형식으로 반환되며, 새로운 키에는 `null`이 전달됩니다.

| 필드 | 유형 | 설명 |
| - | - | - |
| `verification_method` | string | `document`, `id_lookup` 또는 `wallet`. |
| `assurance` | string | `documentary`, `data_match` 또는 `cryptographic`. |
| `wallet_provider` | string \| null | 지갑으로 결과를 생성한 경우 카탈로그 지갑 ID. |
| `id_lookup` | object \| null | 등록기관 증거: 출처, 확인 시각, 시도 횟수, 필드별 비교, 등록기관의 인물 사진. |
| `wallet_verification` | object \| null | 자격 증명: 제공업체, 발급 기관, 보증 수준, 서명 유효성, 공유된 속성. |
| `fallback_from` | object \| null | 비문서 방식이 실패한 경우 `{ "method": ..., "reason": ..., "action": ... }`: 사용자가 계속 진행한 문서 인증의 경우 `action`은 `fallback_to_document`, 거부된 신분증 인증의 경우 `decline`. 대체가 발생하지 않은 경우 `null`. |

세 가지 방식 모두에 대한 필드별 유형과 예시는 [신분증 인증 데이터 모델](https://docs.didit.me/ko/reference/data-models.md#신분증-인증)에서 확인할 수 있으며, 동일한 키가 [`status.updated` webhook](https://docs.didit.me/ko/integration/webhooks)으로 전달됩니다.

## 관련 문서

* [비문서 조회](https://docs.didit.me/ko/core-technology/id-verification/non-doc-lookup.md) — 국가별 필드, 형식, 동의 및 보존
* [디지털 신분증 지갑](https://docs.didit.me/ko/core-technology/id-verification/digital-id-wallets.md) — 지갑별 속성, 보증 및 실패 동작
* [콘솔에서의 신분증 인증 방식](https://docs.didit.me/ko/console/id-verification-methods.md) — 국가 탭 및 세션 방식 칩
* [워크플로 기능 설정](https://docs.didit.me/ko/management-api/workflows/feature-configs.md#ocr-/-신분증-인증) — `methods` 키 참조


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