잘못 읽힌 이름이나 항목 수정하기

OCR이 성을 잘못 읽었거나, 주소를 이름 자리에 넣었거나, 항목을 "unknown"으로 남겼습니다. 지원팀이 대신 편집할 수는 없지만, 고치는 방법은 세 가지입니다 - 사용자 데이터 검토 단계, update-data API, 신분증 단계 재제출.

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

Short answer

Didit 지원팀은 세션의 값을 편집할 수 없습니다. 대신 세 가지 방법으로 직접 수정할 수 있습니다. 사용자가 플로 안에서 데이터를 확인하고 수정하게 하거나(사용자 데이터 검토), update-data API로 항목을 직접 패치하거나, 이미지 품질 기준을 높인 뒤 신분증 단계의 재제출을 요청하는 것입니다. 거의 모든 오독은 촬영 품질이 낮아서 생깁니다.

한 글자가 틀린 이름, "로드되지 않은" 성, 이름이 unknown으로 표시되는 세션, 이름 항목에 들어간 주소는 모두 같은 문제입니다. 추출이 충분히 좋지 않은 이미지에서, 또는 모델이 읽지 않는 문서 면에서 실행된 것입니다. 세션의 데이터는 모델이 읽은 것이고, Didit은 고객 데이터를 수작업으로 바꾸지 않습니다. 기록의 소유자는 귀하의 팀이며, 모든 변경은 귀하에게 추적 가능해야 합니다.

#먼저 왜 일어났는지 이해하기

세션을 열고 문서 이미지와 경고를 확인하세요.

  • 흐리거나 어둡거나 반사가 있거나 일부가 잘린 이미지. 단연 가장 흔한 원인입니다. 세션에는 보통 낮은 이미지 품질 점수나 IMAGE_TOO_BLURRY 경고가 있습니다. 문서 업로드 및 판독 문제 해결을 참고하세요.
  • 실시간 촬영이 아닌 업로드된 파일. 업로드는 스크린샷이거나 압축된 사진인 경우가 많아 카메라 스캔보다 훨씬 자주 잘못 읽힙니다.
  • 비라틴 문자. 키릴, 아랍, 그리스, 한자, 한글 이름은 워크플로의 문자 형식 설정이 기대와 다르면(원문자 대 라틴 음역) 뒤섞이거나 비어서 돌아올 수 있습니다.
  • 모델이 아직 읽지 못하는 문서 면. 일부 국가 신분증은 Didit이 학습하지 않은 레이아웃으로 뒷면에 데이터를 담고 있습니다. 이 경우 앞면은 읽히고 뒷면은 접수되지만 추출되지 않습니다. 매핑을 추가할 수 있도록 지원팀에 견본을 보내 주세요.

#고치는 세 가지 방법

  1. 사용자가 플로 안에서 수정하게 하기(새 세션에 가장 적합)

    워크플로의 신분증 확인 단계에서 고급 아래의 사용자 데이터 검토를 켜세요. 촬영 후 사용자가 추출된 항목을 보고 결과가 결정되기 전에 판독 오류를 수정할 수 있습니다. 지정한 중요 필드(이름, 생년월일, 문서 번호)의 편집은 선택한 조치(검토 또는 거절)를 취하므로 수정이 조용히 지나가지 않습니다. 원인을 근본에서 해결하며 팀의 작업이 필요 없습니다.

  2. 세션을 직접 패치하기(기존 세션용)

    변경할 항목만 넣어 PATCH /v3/session/{session_id}/update-data/를 호출하세요. first_name, last_name, date_of_birth, document_number, expiration_date, issuing_state 및 기타 추출 항목입니다. full_name은 자동으로 다시 계산됩니다. 세션은 승인됨, 거절됨, 검토 중 또는 KYC 만료 상태여야 하고, 변경 시 data.updated 웹훅이 발생하며, 감사 추적에 어떤 항목이 누구에 의해 변경되었는지 기록됩니다. 유료 호출입니다. 주소 증명 항목과 KYB 등록부 데이터용 대응 엔드포인트도 있습니다. 참고: 세션 데이터 업데이트.

  3. 새로 촬영 요청하기(이미지가 문제일 때)

    어떤 항목도 신뢰할 수 없을 만큼 이미지가 나쁘다면 신분증 확인 단계의 재제출을 요청하세요. 사용자는 같은 링크를 받고 그 단계만 반복합니다. 그 전에 단계의 최소 이미지 품질 슬라이더를 올리고 촬영 이미지 검토 화면 활성화를 고려하세요. 재촬영이 첫 시도만큼 나쁘지 않도록 하기 위해서입니다. 누군가 검증을 다시 시도하게 하기를 참고하세요.

Note

신분증 단계 재제출은 문서 이미지를 교체하고 그에 의존하는 검사(얼굴 매칭, AML 이름 스크리닝, 데이터베이스 검증)를 통상 가격으로 다시 실행합니다. API로 항목을 패치하면 아무것도 다시 실행되지 않습니다. 잘못된 이름이 이미 AML이나 등록부 결과를 만들었다면 수정된 데이터로 해당 검사를 다시 실행하세요. 독립 API가 바로 이를 위해 존재합니다.

#패치가 하지 않는 것

  • 세션의 상태를 바꾸지 않습니다. 이름을 수정한 거절 세션은 팀이 달리 결정할 때까지 거절 상태로 남습니다.
  • 문서를 다시 검증하지 않습니다. 수정은 귀하의 주장이며 감사 로그에 그렇게 기록됩니다.
  • 같은 사람의 다른 세션에 소급 적용되지 않습니다.

#재발 방지

  • 신분증 확인 단계의 최소 이미지 품질을 올리고 촬영 이미지 검토 화면을 켜서 사용자가 업로드 전에 사진을 확인하게 하세요.
  • 실서비스 트래픽에서는 파일 업로드보다 카메라 스캔을 우선하세요.
  • 비라틴 문자 시장에서는 문자 형식을 의도적으로 설정하세요.
  • 특정 문서 유형이 일관되게 잘못 읽힌다면 익명화한 견본 두세 개를 지원팀에 보내 모델을 업데이트할 수 있게 하세요.