문서 업로드 및 인식 문제 해결하기

대부분의 문서 업로드와 OCR 문제는 이미지 품질, 뒷면 이미지 누락, 허용되지 않은 하위 유형, 또는 원본이 아닌 사본 때문에 발생합니다. 각각을 해결하는 방법을 안내합니다.

작성: Didit 지원팀 · 2026년 9월 15일 업데이트

문서 업로드가 실패하거나 주요 필드가 올바르게 추출되지 않는다면, 거의 항상 몇 가지 알려진 원인 중 하나입니다. 아래 순서대로 확인해 보세요.

#먼저 확인할 것: 문서가 애초에 허용되는가

이미지 품질 문제를 조사하기 전에, 워크플로가 해당 국가의 정확한 문서 하위 유형을 허용하는지부터 확인하세요. 허용되지 않은 하위 유형은 인식 문제처럼 보이지만 실제로는 그렇지 않은 방식으로 실패하며, 한 명이 아니라 그 형식을 가진 모든 사용자에게 실패합니다. 문서가 거부되는 흔한 이유는 하위 유형입니다를 참고하세요.

#흐리거나 어둡거나 노출 과다인 이미지

Didit은 문서를 처리하기 전에 이미지 품질을 확인하며, 너무 흐리거나 너무 어둡거나 너무 밝으면 사용자에게 사진을 다시 찍도록 요청합니다. 사용자에게 다음을 안내하세요.

• 직접적인 눈부심 없이 고르고 밝은 조명을 사용하세요
• 카메라를 흔들리지 않게 잡고 초점이 맞을 때까지 기다린 뒤 촬영하세요
• 문서의 네 모서리가 모두 화면 안에 보이도록 하세요
• 문서를 비닐 커버에서 꺼내세요. 반사광이 자동 촬영을 방해합니다

사용자가 다시 촬영할 수 있는 횟수는 제한되어 있으며, 마지막으로 허용된 시도에서는 이미지가 그대로 승인되어 영구적으로 막히지는 않지만, 품질이 낮은 촬영은 여전히 일부 필드를 읽을 수 없게 만들 수 있습니다. 세션의 경고에서 IMAGE_TOO_BLURRY, IMAGE_TOO_DARK, IMAGE_TOO_BRIGHT를 확인해 원인을 확인하세요.

흐린 문서가 통과하고 심지어 승인되고 있다면, 기준이 귀하의 위험 허용도에 비해 너무 낮은 것입니다. 워크플로의 신분증 확인 단계에 있는 두 가지 설정으로 해결됩니다.

• 최소 이미지 품질(품질 슬라이더): 모든 문서 사진은 촬영되는 순간 품질 모델로 채점되며, 최소값 미만의 촬영은 즉시 거부되고 재촬영이 요청됩니다. 기본값은 의도적으로 관대합니다. 올리면 33점을 받은 흐린 카드 뒷면이 검사에 도달하지 않습니다.
• 촬영 이미지 검토 화면(고급 아래): 방금 찍은 사진을 사용자에게 보여 주고 업로드 전에 확인하거나 다시 스캔하도록 요청합니다. 카메라 스캔에만 적용되며, 업로드는 이미 파일 미리보기가 있습니다.

품질 점수 자체는 세션 보고서에 있으므로, 우려됐던 세션들을 살펴보고 그 바로 위로 임계값을 잡을 수 있습니다.

#항목이 감지되지 않았거나 잘못 읽힘(이름, 생년월일, 문서 번호)

OCR이 특정 필드를 추출하지 못해도, 그 자체만으로는 보통 세션이 거부되지 않습니다. 기본적으로는 사람이 확인할 수 있도록 수동 검토로 넘어갑니다.

특정 문서 유형이나 특정 언어에서 이런 일이 자주 발생한다면, 워크플로의 선호 문자 형식 설정을 확인하세요. 추출된 이름을 라틴 문자로 정규화할지, 문서의 원래 문자 그대로 유지할지 선택할 수 있습니다. 이 설정이 맞지 않으면 키릴 문자, 아랍 문자, 그리스 문자, 한자로 된 문서에서 이름 필드가 깨지거나 누락되는 흔한 원인이 됩니다.

추출된 값이 틀린 경우(한 글자가 다른 성, 이름 항목에 들어간 주소)에는 잘못 읽힌 이름이나 항목 수정하기를 참고하세요. 지원팀이 대신 편집할 수는 없지만, 사용자 데이터 검토 단계, update-data API, 재제출 각각으로 고칠 수 있습니다.

#스크린샷, 인쇄물, 화면을 찍은 사진은 거부됩니다

Didit은 실물 문서를 실시간으로 촬영한 원본 사진을 요구하며, 스크린샷, 스캔본, 인쇄된 사본, 다른 화면에 띄운 문서를 찍은 사진은 인정하지 않습니다. 문서 라이브니스 검사는 정확히 이런 경우를 잡아내도록 설계되어 있으며, 세션에 플래그를 표시하거나 거부합니다. 사용자에게 실물 문서를 직접 촬영하도록 안내하세요.

이는 의도된 동작입니다. 사진의 사진을 허용하면 문서를 확인하는 것 자체의 가치가 대부분 사라지기 때문입니다.

화면 캡처 감지기는 키보드, 무늬 있는 책상, 카드 뒤의 모니터 같은 복잡한 배경에서 찍은 진짜 문서에 가끔 반응할 수 있습니다. 이미지를 확인했고 문서가 분명히 진짜라면 직접 세션을 승인하세요. 이 태그가 검토로 보내지는 이유가 바로 사람이 그 판단을 내리도록 하기 위해서입니다. 각 문서 라이브니스 신호(화면 캡처, 인쇄 사본, 초상 교체)는 단계의 위조 설정에 자체 검토 및 거절 임계값이 있으므로, 어느 하나가 귀하의 트래픽에 너무 민감하다면 조정할 수 있습니다.

#뒷면 이미지 누락

신분증과 운전면허증은 양면 문서입니다. Didit은 추출을 완료하려면 앞면과 뒷면 이미지가 모두 필요합니다. 이런 문서 유형에서 앞면 이미지만 제출되었다면, 세션에는 필요한 데이터가 없게 됩니다.

사용자가 뒷면 촬영 단계에서 계속 막힌다면, 해당 국가에서 그 문서의 뒷면이 실제로 읽을 수 있는 데이터를 담고 있는지 확인하세요. 아무 내용도 없는 뒷면을 요구하면 사용자는 아무 이득 없이 한 단계에서 실패하게 됩니다.

#카메라가 아예 열리지 않음

문서 문제처럼 보이지만 실제로는 환경 문제입니다.

• 인앱 브라우저. 다른 앱(예: 채팅 앱)에 내장된 브라우저 안에서 열린 링크는 카메라 접근 권한을 얻지 못하는 경우가 많습니다. 같은 링크를 휴대폰의 기본 브라우저에서 열면 해결됩니다.
• 이전에 권한이 거부됨. 한 번 사이트의 카메라 접근을 거부하면 브라우저가 이를 기억합니다. 사이트 설정에서 다시 권한을 허용해야 하며, 플로우가 다시 요청할 수는 없습니다.
• 카메라가 이미 사용 중. 다른 탭이나 앱이 카메라를 점유하고 있으면 접근이 막힙니다. 일부 기기에서는 마이크 권한을 허용할 때도 카메라가 함께 점유될 수 있습니다.

#플로우의 텍스트가 깨져 보임

사용자가 문서가 아니라 화면 인터페이스에서 글자가 뒤섞이거나 이상하게 보인다고 하면, 대개 브라우저의 페이지 번역 확장 프로그램이 화면을 다시 쓰고 있는 것이 원인입니다. 해당 페이지의 번역 기능을 끄도록 안내하세요. 플로우 자체가 이미 여러 언어를 지원합니다. 인증 언어 설정하기를 참고하세요.

#OCR은 몇 개 언어를 지원하나요?

Didit의 OCR은 문서 및 국가 커버리지의 일부로 130개 이상의 언어로 된 문서를 읽습니다. 이는 인증 화면 자체의 언어와는 별개이며, 화면 언어는 별도로 지정하지 않는 한 사용자의 브라우저 설정에 따라 자동으로 결정됩니다.

#그래도 해결되지 않나요?

해당 인증 건의 세션 ID와 함께 지원팀에 문의하세요. 세션 ID가 있으면 설명하신 이미지와 경고를 팀이 정확히 확인할 수 있어 특정 사례를 조사하는 가장 빠른 방법입니다.