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

# 사용자 문서 API: 신분증, 주소 증명, 첨부 파일

> Didit 사용자 엔티티의 신분증, 주소 증명, 첨부 파일의 수집 항목, 조회 방법, 콘솔 업로드 방법을 안내합니다.



사용자 문서 프롬프트
        프롬프트를 클립보드에 복사



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

붙여넣을 곳

사용자가 인증 중에 업로드한 모든 문서는 해당 User 엔티티에 영구적으로 연결됩니다. 이 페이지에서는 수집되는 항목, 문서를 조회하는 방법, 문서를 수동으로 추가 업로드하는 방법을 설명합니다.## Didit이 수집하는 항목| 문서 유형 | 수집 시점 | 추출 필드 |
| - | - | - |
| **정부 발급 신분증** (여권, 국가 신분증, 운전면허증, 체류 허가증) | [신분증 인증](https://docs.didit.me/ko/core-technology/id-verification/overview.md) 단계 | 이름, 생년월일, 문서 번호, 발급 국가, 만료일, MRZ(있는 경우) |
| **셀피 / 라이브니스 프레임** | [라이브니스](https://docs.didit.me/ko/core-technology/liveness/overview.md) 단계 | 가장 큰 얼굴 크롭, 패시브 라이브니스 점수 |
| **주소 증명(POA)** | [POA](https://docs.didit.me/ko/core-technology/proof-of-address/overview.md) 단계 | 이름, 주소, 발급 기관, 문서 날짜 |
| **NFC 칩 읽기** | [NFC 인증](https://docs.didit.me/ko/core-technology/nfc-verification/overview.md) 단계 | 칩 데이터, ICAO 인증서 체인, OCR과의 일치 여부 |
| **추가 문서** | 분석가 요청 또는 사용자 지정 워크플로 단계 | 해당하는 경우 OCR, 그 외에는 원본 그대로 저장 |[지원 문서 유형](https://docs.didit.me/ko/core-technology/id-verification/supported-documents-id-verification.md)에서 국가 × 문서 유형의 전체 매트릭스를 확인할 수 있습니다(220+ 국가의 14,000+ 문서).## 문서 조회문서는 사용자에게 직접 연결되지 않고, 문서를 수집한 **세션**에 연결됩니다. 사용자의 모든 문서를 조회하려면 다음 단계를 따르십시오.**1. 사용자의 세션 목록 조회**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. 각 세션의 결정 조회**각 세션 결정에는 수집된 문서의 URL이 포함됩니다.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```응답의 `id_verification.document_images`, `proof_of_address.document_images`, `liveness.images` 필드를 확인합니다.**3. 서명된 URL 사용**응답에 포함된 이미지 URL은 수명이 짧은 서명된 URL입니다. 사용하는 동안 클라이언트에 캐시하거나, 만료되면 결정을 다시 조회하십시오.## PDF 보고서 생성세션에서 수집된 모든 항목(문서 포함)을 사람이 읽기 쉬운 형태로 내보내려면 다음을 사용합니다.**`GET /v3/session/{session_id}/generate-pdf/`**세션 세부 정보, 기능 결과, 포함된 문서 이미지가 담긴 PDF를 반환합니다. 컴플라이언스 감사, SAR 첨부, 규제 제출에 유용합니다.## 콘솔에서 문서 업로드컴플라이언스 담당자는 사용자 또는 활성 세션에 추가 문서를 업로드할 수 있습니다.1. *Users → \[user] → Documents → Upload document*로 이동합니다.
2. 문서 유형(ID, POA, 사용자 지정)을 선택합니다.
3. 파일을 업로드합니다. 지원되는 유형의 경우 OCR이 자동으로 실행됩니다.
4. 문서는 가장 최근 세션에 첨부됩니다. 또는 보완 세션을 새로 만들 수 있습니다.> [!NOTE]
>
> 문서 업로드 UI는 콘솔에서만 사용할 수 있습니다. 사용자에게 문서를 직접 첨부하는 공개 API 엔드포인트는 없습니다. 모든 문서 수집의 진입점으로 세션을 사용하십시오.## 문서 상호 대조세션에서 여러 문서 유형을 수집하면 Didit이 이들을 상호 대조합니다.- **신분증 ↔ 라이브니스**: 신분증의 얼굴이 라이브니스 셀피와 일치하는지 확인합니다.
- **신분증 ↔ 주소 증명**: 주소 증명에 적힌 이름이 신분증에서 추출한 이름과 일치하는지 확인합니다.
- **신분증 ↔ NFC**: MRZ 또는 시각 데이터가 NFC 칩 데이터와 일치하는지 확인합니다.불일치는 세션 결정에 경고로 표시되며, 수동 검토를 트리거하도록 설정할 수 있습니다.## 문서 모니터링 및 재인증문서 유효성을 지속적으로 확인해야 하는 사용 사례(예: 만료된 신분증)의 경우:- **문서 만료일**은 검증된 모든 신분증에서 추적됩니다. 세션 결정에서 `expiration_date` 필드를 조회하십시오.
- **문서 모니터링**은 기본으로 켜져 있으며 자동으로 동작합니다. 따로 활성화할 필요가 없습니다. 신분증의 만료일이 지나면 `"Approved"` 세션은 `"Kyc Expired"`로 바뀌고, 신분증 인증 결과에 `DOCUMENT_EXPIRED` 경고가 추가되며, `status.updated` webhook이 발생합니다. 만료일이 지나기 전에는 경고가 전송되지 않습니다.
- **모니터링 끄기**: [신분증 인증 설정](https://docs.didit.me/ko/core-technology/id-verification/overview.md)에서 해당 국가와 문서 유형의 **Expiration mode**를 **Allow expired**로 설정하십시오. 기본값인 **Reject expired**가 모니터링을 수행하는 모드입니다. **Allow expired**로 승인된 문서는 모니터링되지 않습니다.
- **재인증**: 같은 `vendor_data`를 대상으로 새 세션을 시작하여 문서를 갱신하십시오.## 문서 지리적 위치 확인[ID 문서 지리적 위치 확인](https://docs.didit.me/ko/core-technology/id-verification/document-geolocation-id-verification.md) 검사는 제출자의 IP 위치와 신분증의 발급 국가를 비교합니다. 결과는 세션 결정에 첨부됩니다.## 개인정보 보호 및 보존- 모든 문서는 저장 시 암호화됩니다.
- 이미지는 수명이 짧은 서명된 URL을 통해서만 접근할 수 있습니다.
- 보존 기간은 애플리케이션의 [데이터 보존](https://docs.didit.me/ko/console/data-retention.md) 정책을 따릅니다.
- 사용자는 삭제를 요청할 권리가 있습니다. 삭제하면 이미지, OCR 추출 결과, NFC 데이터가 모두 제거됩니다.## 다음 단계> [card] [신분증 인증](https://docs.didit.me/ko/core-technology/id-verification/overview.md)
>
> 신분증 촬영과 OCR의 작동 방식을 설명합니다.> [card] [주소 증명](https://docs.didit.me/ko/core-technology/proof-of-address/overview.md)
>
> POA 문서 수집을 설명합니다.> [card] [세션 결정](https://docs.didit.me/ko/sessions-api/retrieve-session.md)
>
> GET /v3/session/{id}/decision/ 참조 문서입니다.


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