메인 콘텐츠로 건너뛰기
Every Business entity has 주요 인물, 즉 회사에 대해 법적 책임을 지거나 실질적으로 소유하는 자연인입니다. Didit은 KYB 과정에서 이들을 식별하며, 각 인물을 개인 KYC를 위해 User 엔티티에 연결할 수 있도록 합니다.

주요 인물의 범위

전체 역할 분류와 소유 체인 계산에 대해서는 KYB 임원 및 소유 구조 페이지를 참조하십시오.

주요 인물이 기업에 연결되는 방식

1

등기부에서 식별

KYB 과정에서 Didit은 법인 등기부를 조회하여 등재된 모든 임원과 주주를 추출합니다. 각 인물은 기업 확인(KYB) 세션에 연결된 주요 인물 레코드가 됩니다.
2

사용자 추가(고객 입력)

워크플로에는 “주요 인물” 단계가 포함될 수 있으며, 이 단계에서 기업 관리자는 등기부에 없는 인물(예: 법인 신고서로 확인된 UBO)을 추가합니다.
3

기업 엔티티에 통합

기업의 주요 인물 목록은 등기부에서 추출된 당사자와 사용자가 추가한 당사자를 합친 것이며, 신원을 기준으로 중복이 제거됩니다.
각 주요 인물에는 source 필드가 있습니다:
  • REGISTRY: 공식 등기부에서 추출됨.
  • USER: KYB 흐름 중 기업 관리자가 추가함.

주요 인물을 User 엔티티에 연결하기

주요 인물(일반적으로 UBO 및 이사)에 대해 KYC가 필요한 경우, 해당 당사자를 User 엔티티에 연결할 수 있습니다: 다음의 경우에 링크가 생성됩니다:
  • User 엔티티와 동일한 vendor_data를 사용하여 해당 당사자에 대한 사용자 인증(KYC) 세션이 실행될 때.
  • 분석가가 기업 당사자를 기존 User와 수동으로 연결할 때.
연결되면 User의 KYC 상태가 기업의 주요 인물 보기에 반영됩니다.

주요 인물 조회하기

기업 상세 페이지의 콘솔에서 주요 인물 탭에는 다음이 표시됩니다:
  • 각 당사자의 이름, 역할, 지분율, 출처(등기부 또는 사용자 추가)
  • 연결된 User의 KYC 상태
  • 인물별 AML 스크리닝 상태
  • 연결된 문서(이사 신분증, UBO 신고서)
프로그래밍 방식으로는 주요 인물 정보가 기업 확인(KYB) 세션 결정의 key_people_checks[] 배열에 나타나며, 다음 두 개의 버킷으로 나뉩니다:
  • registry.officers / registry.beneficial_owners: 등기부 조회를 통해 발견된 당사자입니다.
  • submitted.parties: 주요 인물 흐름에서 기업 관리자가 추가한 당사자입니다(source: USER).
  • ubo_kyc_summary: UBO KYC 진행 상황을 집계한 값입니다.
이전 방식의 평면 officers[] 및 beneficial_owners[] 배열은 하위 호환성을 위해 다음 한 번의 릴리스까지 응답에 계속 포함됩니다. 새 연동에서는 위의 두 버킷 구조를 사용하십시오. 각 필드에 대해서는 KYB 응답 스키마를 참조하십시오.

법인 주주

주주가 개인이 아닌 법인인 경우, Didit은 소유 체인을 재귀적으로 탐색하여 최종 실소유자를 식별합니다. 법인 당사자는 선택적으로 하위 기업 확인(KYB) 세션을 트리거할 수 있습니다. 다층 소유 체인의 작업 예시는 소유 구조 페이지를 참조하십시오.

주요 인물 웹훅

주요 인물의 변경 사항은 상위 세션 이벤트를 통해 전달됩니다:
  • data.updated (session_kind: "business" 포함): 주요 인물을 포함한 세션 데이터가 업데이트되었습니다.
  • status.updated (session_kind: "business" 포함): 그 결과 세션 상태가 변경되었습니다.
페이로드는 KYB 웹훅을 참조하십시오.

다음 단계

임원

이사 식별 및 역할 분류.

소유 구조

UBO, 법인 주주 및 체인 계산.

주요 인물 워크플로

주요 인물을 수집하는 KYB 단계.
마지막 수정일 2026년 11월 7일