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

# 문서 만료 모니터링: 지속적인 KYC

> Didit 문서 모니터링은 기본 활성화되어 인증된 문서의 만료일이 지나면 승인됨 세션이 Kyc Expired 상태로 전환되고 webhook이 트리거됩니다.

문서 모니터링은 자동으로 실행됩니다. 인증 중에 문서에 인쇄된 만료일을 판독하면, 신분증 인증 결과와 함께 저장됩니다. 해당 날짜가 지나면 Didit은 이를 인증했던 세션을 `"Approved"`에서 `"Kyc Expired"`로 변경합니다. 직접 활성화할 필요가 없으며, 날짜가 지나기 전에는 별도의 경고가 전송되지 않습니다.

1. **최초 인증**: 평소와 같이 세션 중에 문서를 검증하고, 문서에 인쇄된 만료일을 판독하여 신분증 인증 결과와 함께 저장합니다.
2. **지속적인 확인**: Didit은 승인된 세션을 해당 날짜와 지속적으로 비교합니다.
3. **상태 업데이트**: 날짜가 지나면 `"Approved"` 세션이 `"Kyc Expired"`로 변경되고, 새 상태가 포함된 `status.updated` webhook이 발생하며, 신분증 인증 결과에 `DOCUMENT_EXPIRED` 경고가 표시됩니다.
4. **사전 경고 없음**: 상태 변경 자체가 신호 역할을 합니다. 날짜가 지나기 전에는 경고가 전송되지 않으므로, 사전에 확인해야 할 사항은 없습니다.

![신분증 만료 및 KYC 컴플라이언스 상태를 추적하는 Didit 문서 모니터링 대시보드](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/document-monitoring.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=f79d6c22b93560352e437354b70ed706)

## 주요 기능

* **자동 실행되며, 활성화할 항목이 없습니다.** 모든 애플리케이션이 모니터링 대상이며, 켜야 하는 모니터링 설정은 없습니다.
* **문서 자체의 만료일에 의해 트리거됩니다.** 승인일로부터 계산되는 기간이 아닙니다. 승인 후 수년 뒤에 만료되는 문서도 다음 주에 만료되는 문서와 동일하게 처리됩니다. 만료일이 판독되지 않은 문서는 모니터링할 날짜가 없습니다.
* **국가 및 문서 유형별 단일 제어 설정.** **Expiration mode**에 따라 문서 모니터링 여부가 결정됩니다(아래 참조).
* **상태 및 webhook을 통해 알림이 전달됩니다.** 세션의 상태가 기준 정보이며, `status.updated`를 통해 상태 전환이 전송됩니다.

> [!NOTE]
>
> 더 자세한 내용이 필요하신가요? 속성 및 값의 전체 목록은 [*API Reference*](https://docs.didit.me/ko/sessions-api/retrieve-session.md)에서 확인하세요.

## 유일한 제어 설정: Expiration mode

국가 및 문서 유형의 **Expiration mode**는 모니터링에 영향을 미치는 유일한 설정입니다. Business Console의 *신분증 인증 → 국가 및 문서 유형별 추가 설정*에서 찾을 수 있으며, [신분증 인증](https://docs.didit.me/ko/core-technology/id-verification/overview.md)에 설명되어 있습니다.

| Expiration mode | 캡처 시 | 승인 후 |
| - | - | - |
| **Reject expired**(기본값) | 만료일이 이미 지난 문서는 플래그가 지정되고 거부됩니다. | 모니터링됨: 해당 날짜가 지나면 세션이 `"Kyc Expired"`로 변경됩니다. |
| **Allow expired** | 만료일이 지난 문서에는 플래그가 지정되지 않으며 차단되지도 않습니다. | 모니터링되지 않음: 세션이 `"Approved"` 상태로 유지됩니다. |

> [!TIP]
>
> 다른 곳에서 만료된 문서를 허용하지 않고 특정 시장이나 문서 유형만 모니터링에서 제외하려면, 해당 국가 및 문서 유형에 대해서만 **Allow expired**를 설정하세요.

## 활용 사례

#### 규제 준수(컴플라이언스)

* 승인된 사용자의 신분증 유효 기간이 조용히 만료되지 않도록 방지
* 고정된 일정이 아닌, 문서가 만료될 때 사용자 재인증 진행
* 각 문서가 언제 인증되었는지, 어떤 만료일을 기준으로 인증되었는지를 검토자에게 표시

#### 위험 관리

* 다음 검토 주기 전에 신분증이 만료된 사용자를 파악
* 어떤 승인된 세션이 `"Kyc Expired"`로 변경되었는지, 변경된 지 얼마나 되었는지 확인

#### 운영 효율성

* 수동 문서 검토가 필요했던 확인 작업을 자동화
* 폴링 대신 webhook을 통해 재인증을 트리거


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