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

​

Didit이 수집하는 항목

​

문서 조회

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

​

PDF 보고서 생성

​

콘솔에서 문서 업로드

1. Users → [user] → Documents → Upload document로 이동합니다.
2. 문서 유형(ID, POA, 사용자 지정)을 선택합니다.
3. 파일을 업로드합니다. 지원되는 유형의 경우 OCR이 자동으로 실행됩니다.
4. 문서는 가장 최근 세션에 첨부됩니다. 또는 보완 세션을 새로 만들 수 있습니다.

​

문서 상호 대조

• 신분증 ↔ 라이브니스: 신분증의 얼굴이 라이브니스 셀피와 일치하는지 확인합니다.
• 신분증 ↔ 주소 증명: 주소 증명에 적힌 이름이 신분증에서 추출한 이름과 일치하는지 확인합니다.
• 신분증 ↔ NFC: MRZ 또는 시각 데이터가 NFC 칩 데이터와 일치하는지 확인합니다.

​

문서 모니터링 및 재인증

• 문서 만료일은 검증된 모든 신분증에서 추적됩니다. 세션 결정에서 expiration_date 필드를 조회하십시오.
• 문서 모니터링은 기본으로 켜져 있으며 자동으로 동작합니다. 따로 활성화할 필요가 없습니다. 신분증의 만료일이 지나면 "Approved" 세션은 "Kyc Expired"로 바뀌고, 신분증 인증 결과에 DOCUMENT_EXPIRED 경고가 추가되며, status.updated webhook이 발생합니다. 만료일이 지나기 전에는 경고가 전송되지 않습니다.
• 모니터링 끄기: 신분증 인증 설정에서 해당 국가와 문서 유형의 Expiration mode를 Allow expired로 설정하십시오. 기본값인 Reject expired가 모니터링을 수행하는 모드입니다. Allow expired로 승인된 문서는 모니터링되지 않습니다.
• 재인증: 같은 vendor_data를 대상으로 새 세션을 시작하여 문서를 갱신하십시오.

​

문서 지리적 위치 확인

​

개인정보 보호 및 보존

• 모든 문서는 저장 시 암호화됩니다.
• 이미지는 수명이 짧은 서명된 URL을 통해서만 접근할 수 있습니다.
• 보존 기간은 애플리케이션의 데이터 보존 정책을 따릅니다.
• 사용자는 삭제를 요청할 권리가 있습니다. 삭제하면 이미지, OCR 추출 결과, NFC 데이터가 모두 제거됩니다.

​

다음 단계