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

# 신분증 인증 보고서: 필드 및 품질 점수

> Didit 신분증 인증 보고서 가이드: 상태, 추출된 문서 필드, 이미지 품질 점수, 세션 간 일치 여부 및 API 응답 내 데이터 위치를 확인하세요.

## 개요

**신분증 인증 보고서**는 Didit이 여권, 신분증, 운전면허증, 거주 허가증 등 정부 발급 신분증에서 추출하고 검증한 모든 정보를 담고 있습니다. 여기에는 OCR로 인식된 인적 사항 및 신분증 필드, 캡처된 미디어의 서명된 URL, 파싱 및 지오코딩된 주소 데이터, 면별 이미지 품질 점수, MRZ 내용, 다중 문자 체계(라틴/비라틴) 분석, 크로스 세션 신분증 일치 여부 등이 모두 포함됩니다.

이 보고서는 사용자가 워크플로에서 문서 캡처 단계를 완료한 후(또는 독립형 OCR endpoint를 직접 호출한 후) 생성됩니다. Didit은 문서 유형을 식별하고, OCR을 실행하며, MRZ / 바코드 / QR 코드를 검증하고, 주소를 파싱하며, 변조 여부(화면 캡처, 인쇄물 복사본, 인물 사진 조작)를 스크리닝하고, 해당 애플리케이션에서 캡처된 다른 모든 문서와 비교합니다.

각 보고서는 전체 세션 상태와 무관하게 신분증 인증 단계 자체의 결과만을 반영하는 자체 `status`를 갖습니다.

* **승인됨** — 문서가 인식되었고, 모든 필수 필드가 추출되었으며, 거부로 라우팅되는 경고가 발생하지 않았습니다.
* **검토 중** — 하나 이상의 경고가 발생했으며, 워크플로 설정에 따라 해당 경고가 검토로 라우팅되었습니다.
* **거부됨** — 자동 거부 조건(지원되지 않는 문서, 만료된 문서, 인물 사진 누락, 차단 목록 일치, 적응형 연령 확인 실패)이 트리거되었거나 설정된 작업이 '거부'인 경고가 발생했습니다(최소/최대 연령의 기본 작업은 거부입니다).
* **만료됨** — 인증 완료 **이후**에 문서의 `expiration_date`가 지났습니다. Didit의 지속적인 만료 모니터링을 통해 보고서가 `Approved`에서 `Expired`로 전환되고, `DOCUMENT_EXPIRED` 경고가 추가되며, 승인되었던 세션 상태가 `Kyc Expired`로 변경됩니다.
* **완료되지 않음** — 사용자가 캡처 단계를 끝까지 완료하지 않았습니다.

## API 응답에서 나타나는 위치

신분증 보고서는 단일 `id_verification` 객체가 아니라 **항상 JSON 배열**인 `id_verifications[]` 배열 내에 포함되어 전달됩니다. 워크플로에서 둘 이상의 문서 단계를 실행하는 경우(예: 기본 신분증 단계와 단계 상향(step-up) 단계를 실행하는 경우) 여러 항목이 나타납니다.

* **세션 결정 API** — `GET /v3/session/{sessionId}/decision/`은 최상위 수준에서 `id_verifications[]`를 반환합니다. [세션 결정 조회](https://docs.didit.me/ko/sessions-api/retrieve-session.md)를 참고하십시오.
* **Webhook** — 단계에서 데이터가 생성되면 `session.status.updated` payload에 동일한 `id_verifications[]` 배열이 포함됩니다. [Webhook](https://docs.didit.me/ko/integration/webhooks.md)을 참고하십시오.
* **독립형 OCR API** — 문서를 직접 제출하면 동일한 필드를 가진 단일 `id_verification` 객체가 반환됩니다. [독립형 OCR API](https://docs.didit.me/ko/standalone-apis/id-verification.md)를 참고하십시오.

> [!NOTE]
>
> `response.id_verifications[0]`을 읽고 배열을 순회하십시오. 단일 `id_verification` 형태는 독립형 OCR API에만 존재하며, v3 결정 endpoint에는 존재하지 않습니다.

## 스키마

필드별 표준 스키마는 [데이터 모델](https://docs.didit.me/ko/reference/data-models.md#신분증-인증) 참조 페이지에서 확인할 수 있습니다. 아래 필드는 `IDVerificationV2Serializer`를 확장하고 `node_id`, 세션 간 `matches[]` 배열, Silent Capture `document_selfie_face_matches[]` 배열을 추가한 `IDVerificationV3Serializer`에서 직접 제공됩니다.

### 최상위 필드

| 필드 | 타입 | 설명 |
| - | - | - |
| `status` | `"Approved" \| "Declined" \| "In Review" \| "Expired" \| "Not Finished"` | ID 단계 상태. |
| `node_id` | string \| null | 이 보고서를 생성한 워크플로 그래프 노드. |
| `document_type` | `"Passport" \| "Identity Card" \| "Driver's License" \| "Residence Permit" \| "Health Insurance Card" \| "Tax Card" \| "Social Security Card" \| "Work Permit" \| "Visa" \| "Public Service Card" \| "Birth Certificate" \| "Firearm License" \| "Other" \| null` | 인식된 최상위 문서 계열(사람이 읽을 수 있는 형식). |
| `document_subtype` | string \| null | 워크플로의 문서 설정에서 허용하는 항목으로 필터링된 Didit 문서 레지스트리의 문서 하위 유형 코드. 지역별 문서에는 `QUEENSLAND_DRIVER_LICENSE_GENERIC`과 같이 지역이 포함됩니다. 미국 상업용 운전면허증(CDL)과 표준 면허증을 구분하는 방법을 포함한 전체 코드 목록은 [문서 하위 유형](https://docs.didit.me/ko/core-technology/id-verification/document-subtypes-id-verification.md)을 참조하세요. |
| `document_number` | string | OCR로 추출된 문서 번호. 면허증 번호와 카드 번호가 모두 인쇄된 운전면허증의 경우 표 아래의 참고 사항을 확인하세요. |
| `personal_number` | string | 문서 번호와 구분되는 OCR로 추출된 개인/국가 식별 번호. |
| `portrait_image`, `front_image`, `front_video`, `back_image`, `back_video`, `full_front_image`, `full_back_image` | string (서명된 URL) | 캡처된 미디어. URL은 서명되어 있으며 유효 시간이 제한되어 있으므로 즉시 다운로드해야 하며 URL을 영구 저장해서는 안 됩니다. |
| `front_image_camera_front`, `back_image_camera_front` | string (서명된 URL) \| null | 문서 캡처 중 사용자의 전면 카메라로 캡처한 프레임. 카메라 간 얼굴 교차 확인에 사용되며 [얼굴 차단 목록](https://docs.didit.me/ko/console/blocklist-users.md#얼굴-차단)과 비교됩니다. 각 프레임은 [얼굴 차단 목록에 추가](https://docs.didit.me/ko/management-api/lists/create-entry.md#문서-촬영-셀피의-얼굴)할 수도 있습니다. |
| `front_image_camera_front_face_match_score`, `back_image_camera_front_face_match_score` | float (0–100) \| null | 전면 카메라 프레임과 문서 인물 사진 간의 유사도 점수. |
| `document_selfie_face_matches` | array \| null | 문서 캡처 중 촬영된 셀피와 얼굴이 일치하는 이전 세션 또는 얼굴 차단 목록 항목([Silent Capture 얼굴 검색](https://docs.didit.me/ko/core-technology/face-search/overview.md#문서-촬영-중-캡처된-셀피)). `liveness_checks[].matches`와 동일한 항목 형식이며, `match_image_url`은 만료되는 사전 서명된 URL입니다. 이전 세션이거나 검색이 실행되지 않은 경우 `null`, 실행되었지만 일치 항목이 없는 경우 `[]`입니다. |
| `front_image_quality_score`, `back_image_quality_score` | object \| null | 면별 품질 평가(이미지 품질 점수 참조). |
| `document_liveness` | object \| null | 사기 유형별 문서 라이브니스 점수 및 판정에 사용된 임계값(문서 라이브니스 점수 참조). V3 전용입니다. |
| `date_of_birth`, `expiration_date`, `date_of_issue` | string (YYYY-MM-DD) | 문서 날짜. |
| `age` | number | `date_of_birth`를 기준으로 계산된 소지자의 나이(연 단위). |
| `issuing_state` | string (ISO 3166-1 alpha-3) | 발급 국가 코드. |
| `issuing_state_name` | string | 현지화된 국가 이름. |
| `first_name`, `last_name`, `full_name` | string | `preferred_characters`로 선택된 문자 체계의 소지자 성명(아래 참조). |
| `gender` | `"M" \| "F" \| "U"` | 성별(문서에 기재되어 있는 경우, `U` = 알 수 없음). |
| `address`, `formatted_address` | string | 원본 및 지오코딩/포맷팅된 주소 문자열. |
| `place_of_birth` | string | OCR로 추출된 출생지. |
| `marital_status` | `"SINGLE" \| "MARRIED" \| "DIVORCED" \| "WIDOWED" \| "UNKNOWN"` | 혼인 여부(문서에 기재되어 있는 경우). |
| `nationality` | string (ISO 3166-1 alpha-3) | 소지자 국적(발급 국가와 다른 경우). |
| `extra_fields` | object | 문서별 추가 필드(운전면허 범주, 혈액형, 대체 문자 체계 이름, `tax_number` 등). |
| `mrz` | object \| null | 파싱된 MRZ 키/값 필드. |
| `parsed_address` | object \| null | 구조화 및 지오코딩된 주소(`street_1`, `street_2`, `city`, `region`, `country`, `postal_code`, `address_type`, `formatted_address`, `document_location`, `raw_results`, `is_best_match`). |
| `extra_files[]` | array of signed URLs | 이 문서에 첨부된 추가 이미지. |
| `matches[]` | array | 세션 간 문서 일치 항목(세션 간 일치 참조). |
| `warnings[]` | array | 모듈 수준 경고 — [신분증 인증 경고](https://docs.didit.me/ko/core-technology/id-verification/warnings-id-verification.md)를 참조하세요. |

> [!NOTE]
>
> **`issuing_state`는 항상 국가 수준이며, 하위 지역 수준이 아닙니다.** 주나 도에서 발급한 운전면허증(호주, 미국, 캐나다)을 포함한 모든 문서 유형에서 `issuing_state` 및 `issuing_state_name`은 주(state)가 아닌 **국가**(예: `AUS` / `Australia`)를 보고합니다. 문서에 하위 지역 값이 있는 경우 `parsed_address.region`에서 별도로 제공됩니다(일부 문서 유형에서는 `extra_fields.state`로 대체). **Business Console** 세션 개요에서는 해당 값이 있는 경우 **발급 국가** 아래에 **Region** 행으로 표시됩니다.

> [!NOTE]
>
> **두 개의 번호가 있는 운전면허증(호주).** 호주 면허증에는 소지자의 운전 자격을 식별하며 카드가 재발급되어도 변경되지 않는 면허 번호와, 실물 카드를 식별하며 재발급할 때마다 변경되는 카드 번호가 모두 인쇄되어 있습니다. 이러한 면허증에 대해 Didit은 항상 번호를 다음과 같이 매핑합니다.
>
> * `personal_number` — **면허 번호**
> * `document_number` — **카드 번호**
>
> 이는 모든 호주 주 및 준주(NSW, VIC, QLD, WA, SA, TAS, ACT, NT)에 적용됩니다. 일부 변형에서는 카드 번호가 뒷면에만 인쇄되어 있으므로 면허증 뒷면을 캡처할 때만 읽을 수 있습니다. 카드 번호를 읽을 수 없는 경우 면허 번호가 `document_number`와 `personal_number` **모두**로 보고되므로, 인증이 완료되면 `document_number`에는 항상 식별자가 포함됩니다. 어느 경우든 `personal_number`는 면허 번호입니다. 다른 문서 유형에서 `document_number`는 여전히 OCR로 추출된 기본 번호로 유지되며, 그 자체가 소지자 수준의 식별자일 수 있습니다.

> [!NOTE]
>
> **아르헨티나 CUIL은 `personal_number`가 아닌 `extra_fields.tax_number`에 저장됩니다.**
> 아르헨티나 문서는 AFIP, ANSES 및 신용평가기관의 기준 키가 되는 11자리 식별자인 CUIL을 문서마다 서로 다른 위치에 인쇄하며, DNI에는 그 옆에 또 다른 11자리 숫자가 인쇄되어 있습니다:
>
> * **운전면허증**의 경우, CUIL은 `personal_number`에 전달됩니다.
> * **DNI**의 경우, `personal_number`에는 카드 신청 건을 식별하는 번호이자 소지자의 식별자가 아닌 *número de trámite*가 전달됩니다. DNI의 CUIL은 자체 인쇄 필드에서 읽어옵니다.
>
> 따라서 `personal_number`는 아르헨티나의 신뢰할 수 있는 CUIL이 **아닙니다**. DNI에서 이 번호는 11자리 숫자이지만 어떤 등록부에서도 결과를 반환하지 않습니다. 대신 `extra_fields.tax_number`를 확인하십시오. Didit은 소지자가 어떤 아르헨티나 문서를 제시했든 관계없이 해당 값이 실제 CUIL(개인 접두사 및 모듈로-11 검증 숫자)로 검증될 때만 구분 기호 없는 표준 숫자 형태(`27111111117`)로 보고합니다. 카드의 CUIL을 읽을 수 없는 경우, CUIL이 아닌 숫자로 채워지는 대신 해당 키가 생략되므로 이러한 사용자를 처리하려면 운전면허증을 두 번째 문서로 캡처하거나 설문지 답변 또는 세션의 `metadata`를 통해 CUIL을 수집하십시오.

### 이미지 품질 점수

`front_image_quality_score` 및 `back_image_quality_score`는 각각 다음을 반환합니다:

| 필드 | 타입 | 측정 대상 |
| - | - | - |
| `focus_score` | number 0–100 | 선명도 — 균일한 배경에서도 안정적인 상위 10% 로컬 라플라시안 분산. 가중치 45%. |
| `brightness_score` | number 0–100 | 너무 어둡거나 과다 노출된 이미지에 불이익을 부여합니다. 가중치 30%. |
| `brightness_issue` | `"ok" \| "too_dark" \| "too_bright"` | `brightness_score`가 낮을 때 밝기 문제의 방향성. |
| `resolution_score` | number 0–100 | 캡처의 총 픽셀 수를 기준으로 합니다. 가중치 25%. |
| `is_document_fully_visible` | boolean \| null | 문서의 네 모서리가 모두 보이면 `true`, 모서리가 잘린 경우 `false`, 모서리 감지를 사용할 수 없는 경우 `null`. |
| `overall_score` | number 0–100 | 가중치 종합 점수(초점 45%, 밝기 30%, 해상도 25%). |

> [!TIP]
>
> 빠른 적합성 확인을 위해 `overall_score`를 사용하십시오. 점수가 **70**을 넘으면 일반적으로 안정적인 인증에 충분히 양호한 캡처임을 나타냅니다.

### 문서 라이브니스 점수

`document_liveness`는 **경고 발생 여부와 관계없이** [문서 라이브니스 검사](https://docs.didit.me/ko/core-technology/id-verification/warnings-id-verification.md#문서-라이브니스-위변조)가 측정한 내용을 보고합니다. 경고는 점수가 워크플로의 임계값 중 하나 아래로 떨어졌을 때만 존재하므로, 이 필드가 도입되기 전에는 승인된 문서에 라이브니스 증거가 전혀 포함되지 않았습니다. 즉, 이 필드를 통해 통과된 세션을 감사할 수 있습니다. 검사가 실행되지 않은 경우(예: 신분증이 아닌 방식이거나 세션 로그에 모델 가동 중단이 기록된 경우)에는 `null`이 됩니다.

여기에는 사기 유형별(`portrait_replace`, `printed_copy`, `screen_replay`)로 각각 다음을 포함하는 객체가 하나씩 전달됩니다:

| 필드 | 타입 | 의미 |
| - | - | - |
| `score` | number 0–100 \| null | 이 사기 유형에 대해 해당 문서가 진본일 가능성(높을수록 진본일 가능성이 높음). 두 면 중 **더 낮은** 값이며, 결정에 사용된 값입니다. 어느 면도 유효한 점수를 생성하지 못한 경우(예: 인물 사진이 발견되지 않은 면에서 인물 사진 점수가 제외된 경우)에는 `null`입니다. |
| `front`, `back` | number 0–100 \| null | 캡처된 면별 동일한 점수. 캡처되지 않았거나 점수가 제외된 면의 경우 `null`입니다. |
| `decline_threshold`, `review_threshold` | number \| null | 신분증 인증 노드가 이 문서를 평가할 때 저장된 임계값입니다. 이후의 워크플로 수정 사항은 이 값에 영향을 주지 않습니다. 과거 평가 증거를 사용할 수 없는 경우 `null`입니다. |
| `bucket` | `"approve" \| "review" \| "decline" \| null` | 해당 임계값 대비 `score`가 위치하는 구간: `decline_threshold` 미만 → `decline`, `review_threshold` 미만 → `review`, 그 외 → `approve`. 유효한 점수가 없거나, 검사가 적용되지 않았거나, 과거 평가 증거를 사용할 수 없는 경우 `null`입니다. 버킷은 전체 세션 상태가 아니라 이 사기 유형 검사 자체를 나타냅니다. |

```json theme={null}
"document_liveness": {
  "portrait_replace": {
    "score": 96.46,
    "front": 96.46,
    "back": 98.2,
    "decline_threshold": 35,
    "review_threshold": 70,
    "bucket": "approve"
  },
  "printed_copy": {
    "score": 91.2,
    "front": 91.2,
    "back": 93.7,
    "decline_threshold": 35,
    "review_threshold": 77,
    "bucket": "approve"
  },
  "screen_replay": {
    "score": 99.9,
    "front": 99.9,
    "back": 99.5,
    "decline_threshold": 30,
    "review_threshold": 70,
    "bucket": "approve"
  }
}
```

저장된 평가 증거가 없는 이전 문서의 경우 저장된 점수는 계속 표시되지만 임계값과 `bucket`은 모두 `null`입니다. 과거 결과를 재구성하기 위해 현재 워크플로 설정을 사용하는 일은 절대 없습니다. 문서 평가가 아직 완료되지 않은 캡처에도 동일하게 적용됩니다.

Business Console의 세션 신분증 인증 섹션에 있는 **문서 라이브니스** 블록에도 동일한 세 행이 표시됩니다.

### 세션 간 일치 항목

`matches[]`는 애플리케이션 내에서 이 문서와 일치하는 다른 문서를 최대 **5**개까지 나열합니다. 기준은 동일한 **생년월일**, 동일한 **발급 국가**, 그리고 유사도가 매우 높은 **성명**입니다. 차단 목록에 등록된 문서의 경우 추가로 문서 번호가 정확히 일치해야 합니다. 동일한 사용자(동일한 `vendor_data`)에 속한 세션은 제외됩니다.

각 항목에는 `session_id`, `session_number`, `vendor_data`, `verification_date`, `user_details`(`name`, `document_type`, `document_number`), `status`, `is_blocklisted`(문서가 차단 목록에 추가된 경우 `true`), `api_service`, 그리고 서명된 `front_image_url`이 포함됩니다.

## 상태 값

| 상태 | 의미 | 후속 영향 |
| - | - | - |
| `Approved` | 문서가 인식되었고, 필수 필드가 추출되었으며, 구성된 임계값을 기준으로 모든 검사를 통과했습니다. | 성공한 신분증 검사로 반영됩니다. |
| `In Review` | 하나 이상의 경고가 발생했으며 워크플로가 이를 검토로 라우팅합니다. | 검토자가 작업을 수행할 때까지 세션도 `In Review`로 이동합니다. |
| `Declined` | 자동 거부 조건(지원되지 않는 문서, 만료된 문서, 인물 사진 누락, 차단 목록 일치, 적응형 연령 실패)이 트리거되었거나 Decline으로 구성된 경고가 발생했습니다. | 워크플로를 충족하는 승인된 다른 분기가 없는 한 세션이 거부됩니다. |
| `Expired` | 승인 **후** 문서의 만료일이 지났습니다. 기본적으로 활성화되어 있는 Didit의 지속적인 문서 모니터링(**Expiration mode**가 **Allow expired**인 국가 및 문서 유형은 제외됨)과 `DOCUMENT_EXPIRED` 경고에 의해 설정됩니다. | 승인된 세션이 `Kyc Expired`로 이동합니다. |
| `Not Finished` | 사용자가 캡처 단계를 중단했습니다. | 신분증 분기에서 결과가 생성되지 않았습니다. |

## 다중 문자 체계 문서 (라틴 / 비라틴)

키르기스스탄, 카자흐스탄, 러시아, 일본, 한국, 중국, 아랍, 태국 등 일부 문서에는 소지자의 성명, 주소 또는 출생지가 라틴 문자 음역 표기**와** 현지 문자 체계 **모두**로 인쇄되어 있습니다. 워크플로(또는 독립형 API) 설정인 `preferred_characters`를 사용하여 최상위 응답을 채울 문자 체계를 선택할 수 있습니다:

| 값 | 최상위 필드에 채워지는 내용 | 반대 문자 체계가 들어가는 위치 |
| - | - | - |
| `latin` *(기본값)* | 문서에 인쇄된 라틴 문자 음역 표기 | `extra_fields.*_non_latin` |
| `non_latin` | 문서에 인쇄된 현지 문자 체계 값 | `extra_fields.*_latin` |

대체 문자 체계 값은 `extra_fields` 내부의 접미사가 붙은 키 아래에 저장됩니다: `first_name_non_latin`, `last_name_non_latin`, `middle_name_non_latin`, `full_name_non_latin`, `address_non_latin`, `place_of_birth_non_latin` (또는 이에 상응하는 `_latin` 변형).

### 대체 문자 체계 필드가 표시되는 경우

* **두 문자 체계가 실제로 문서에 모두 존재하는 경우에만 나타납니다.** 명목상 "Surname-Kyrgyz (Cyrillic)"으로 라벨이 지정된 OCR 필드가 라틴 문자 텍스트(동형 문자 또는 라틴 문자 음역 표기)로 추출된 경우, 이는 비라틴 대체 항목으로 인정되지 **않으며** 해당 키는 생략됩니다.
* `full_name_non_latin`(및 `full_name_latin`)은 두 문자 체계가 모두 제공되는 경우 항상 개별 이름, 중간 이름 및 성 구성 요소를 바탕으로 **재구성**됩니다. 일관성을 유지하기 위해 OCR의 원시 "Full Name" 필드는 무시됩니다.
* `preferred_characters=latin`이지만 문서에 비라틴 텍스트**만** 포함되어 있는 경우(따라서 최상위 필드가 비라틴으로 채워짐), Didit은 음역 과정을 실행하고 라틴 폴백으로 `first_name_latin`, `last_name_latin`, `middle_name_latin`, `full_name_latin`, `place_of_birth_latin` 및 `address_latin`을 제공합니다.

```json theme={null}
{
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "extra_fields": {
    "first_name_non_latin": "Айна"
  }
}
```

이 샘플에서는 문서의 "Surname (Cyrillic)" 필드가 라틴 문자로 반환되었기 때문에 `last_name_non_latin`이 없습니다. 즉, 추출할 실제 비라틴 문자로 된 성이 존재하지 않았습니다.

## 예시

### Approved — 정상 스페인 신분증 (모든 필드)

```json theme={null}
{
  "id_verifications": [
    {
      "status": "Approved",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "personal_number": "SAMPLE-PER-12345",
      "portrait_image": "https://<media-host>/.../portrait.jpg?signature=...",
      "front_image": "https://<media-host>/.../front.jpg?signature=...",
      "front_video": "https://<media-host>/.../front.mp4?signature=...",
      "back_image": "https://<media-host>/.../back.jpg?signature=...",
      "back_video": "https://<media-host>/.../back.mp4?signature=...",
      "full_front_image": "https://<media-host>/.../full_front.jpg?signature=...",
      "full_back_image": "https://<media-host>/.../full_back.jpg?signature=...",
      "front_image_camera_front": null,
      "back_image_camera_front": null,
      "front_image_camera_front_face_match_score": null,
      "back_image_camera_front_face_match_score": null,
      "front_image_quality_score": {
        "focus_score": 85.3,
        "brightness_score": 92.1,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 84.6
      },
      "back_image_quality_score": {
        "focus_score": 79.1,
        "brightness_score": 90.5,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 81.5
      },
      "date_of_birth": "1990-01-01",
      "age": 35,
      "expiration_date": "2031-06-02",
      "date_of_issue": "2021-06-02",
      "issuing_state": "ESP",
      "issuing_state_name": "Spain",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "gender": "M",
      "address": "Avda de Madrid 34",
      "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
      "place_of_birth": "Madrid",
      "marital_status": "SINGLE",
      "nationality": "ESP",
      "extra_fields": {},
      "mrz": {
        "document_number": "SAMPLE-DOC-12345",
        "surname": "DOE",
        "name": "JOHN",
        "birth_date": "900101",
        "expiry_date": "310602"
      },
      "parsed_address": {
        "street_1": "Avda de Madrid 34",
        "street_2": null,
        "city": "Madrid",
        "region": "Madrid",
        "country": "ES",
        "postal_code": "28822",
        "address_type": "Avda",
        "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
        "document_location": { "latitude": 40.4168, "longitude": -3.7038 },
        "raw_results": {
          "geometry": {
            "location": { "lat": 40.4168, "lng": -3.7038 },
            "location_type": "ROOFTOP"
          }
        },
        "is_best_match": true
      },
      "extra_files": [],
      "warnings": [],
      "node_id": "id_primary",
      "matches": []
    }
  ]
}
```

### In Review — QR 코드가 있어야 하는 문서에서 QR이 감지되지 않음

요약본입니다. 실제 응답에는 항상 위에 표시된 전체 필드 세트가 포함됩니다.

```json theme={null}
{
  "id_verifications": [
    {
      "status": "In Review",
      "node_id": "id_primary",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "warnings": [
        {
          "feature": "ID_VERIFICATION",
          "risk": "QR_NOT_DETECTED",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "QR not detected",
          "long_description": "The system couldn't find or read the QR code on the document. This could be due to poor image quality or an unsupported document type.",
          "node_id": "id_primary"
        }
      ]
    }
  ]
}
```

## 보안 참고 사항

문서 이미지 및 동영상에 대해 반환되는 서명된 URL은 일시적이며, 제한된 유효 기간이 지나면 만료됩니다. 단기간만 유효한 것으로 취급하십시오. 필요한 항목은 즉시 다운로드하고 캐시하거나 공개적으로 노출하지 마십시오. 일반적으로 애플리케이션에는 `status`, 몇 가지 인적 사항 필드 및 경고만 필요합니다. 향후 침해 위험을 최소화할 수 있도록 가능한 한 적은 데이터만 저장하십시오.

## 관련 항목

* [신분증 인증 경고](https://docs.didit.me/ko/core-technology/id-verification/warnings-id-verification.md) — 전체 경고 열거형, 원인 및 해결 방법.
* [문서 모니터링](https://docs.didit.me/ko/core-technology/id-verification/document-monitoring-id-verification.md) — Didit이 위변조 및 세션 간 중복을 검사하는 방법.
* [지원되는 문서](https://docs.didit.me/ko/core-technology/id-verification/supported-documents-id-verification.md) — 지원되는 문서 유형 및 국가.
* [문서 하위 유형](https://docs.didit.me/ko/core-technology/id-verification/document-subtypes-id-verification.md) — 미국 상업용 대 일반 운전면허증 감지를 포함한 전체 `document_subtype` 코드 목록.
* [Webhook](https://docs.didit.me/ko/integration/webhooks.md) — 보고서를 수신하기 위해 `session.status.updated` 수신 대기.
* [데이터 모델 — 신분증 인증](https://docs.didit.me/ko/reference/data-models.md#신분증-인증) — 모든 필드가 포함된 표준 스키마.


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