기업 확인(KYB) API: 법인 등기 및 UBO

Didit의 기업 확인(KYB)을 사용하면 기업과 법인을 플랫폼에 온보딩하기 전에 검증할 수 있습니다. 시스템은 법인 등기부 조회를 자동화하고, 실소유자와 임원을 식별하며, 모든 당사자를 AML 감시 목록과 대조하고, 증빙 문서를 수집합니다. 이 모든 과정은 하나의 워크플로 안에서 이루어집니다. 검증이 완료된 각 회사는 기업 프로필로 관리되며, 세션 전반의 결과가 집계됩니다. 이 Didit Academy 강의는 기업 확인의 처음부터 끝까지를 다룹니다. KYB 대시보드, 등기부 확인, 주주와 UBO, AML 스크리닝, 그리고 회사 대표자가 자신의 화면에서 보게 되는 내용을 살펴봅니다. Didit KYB를 처음 사용하신다면 10분 만에 전체 과정을 살펴볼 수 있는 빠른 시작부터 시작한 뒤, 프로덕션 패턴은 통합 가이드에서 확인하십시오. 사용자, 차단 목록, 가져오기 및 내보내기와 연결되는 기본 기업 엔티티 모델은 기업을 참고하십시오.

작동 방식

기업 세션 생성

KYB 워크플로로 세션을 생성하여 기업 인증을 시작합니다. 워크플로 유형이 KYB이면 Didit가 기업 세션을 자동으로 생성합니다:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

세션 유형은 워크플로에 따라 결정되므로 추가 필드가 필요하지 않습니다. KYB 워크플로는 기업 전용 기능을 활성화한 기업 세션을 자동으로 생성합니다.

회사 등록 정보 조회

Didit는 Lite, Shareholders, UBOs 등급으로 공식 법인 등기부를 조회합니다. 각 등급의 요금은 국가별로 책정되며, 등기부 조회 요금을 참고하십시오. Lite에서는 다음 정보를 가져옵니다:

데이터	설명
회사명	등록된 법적 명칭
등록번호	공식 회사 등록 번호
국가	설립 국가
상태	활동 중, 해산, 말소 등
회사 유형	Ltd, LLC, PLC, SA, GmbH 등
설립일	회사가 등록된 날짜
등록 주소	공식 등록 사무소 주소
납세자 번호	세무 식별 번호(제공되는 경우)

등기부 데이터는 입력된 정보와 상호 대조하여 불일치 사항을 찾아냅니다.

주요 인물 - UBO, 주주, 이사 및 대표자

시스템은 통합 주요 인물 모델에 따라 기업과 관련된 모든 개인 및 법인 주체를 식별합니다:

UBO: 최종적으로 회사를 소유하거나 지배하는 개인으로, 지분율과 의결권 비율을 포함합니다
주주(개인 및 법인): 각자의 지분율과 함께 표시됩니다
이사, 대표자, 회사 서기, 권한 있는 서명자 및 기타 임원 역할: 각자의 구체적인 역할 태그와 함께 표시됩니다
법인 소유 계층: 소유권 체인의 모회사로, 필요에 따라 중첩된 KYB를 사용할 수 있습니다

한 사람이 여러 역할 태그를 가질 수 있습니다(예: 이사이자 주주). 각 역할은 워크플로에서 개별적으로 설정합니다. 즉, 어떤 역할에 KYC가 필요한지, 어떤 KYC 워크플로를 사용할지, 최종 사용자가 인증을 건너뛸 수 있는지를 정합니다. 자세한 내용은 주요 인물과 소유 구조에서 확인하십시오.

AML 스크리닝

식별된 모든 당사자는 전 세계 AML 감시 목록과 자동으로 대조됩니다:

기업 AML: 기업 주체를 제재, 부정적 언론 보도, 규제 집행 목록과 대조합니다
개인 AML: 각 주요 인물(UBO, 주주, 이사, 대표자 등)을 개별적으로 대조합니다
사용자 인증과 동일한 이중 점수 위험 시스템(일치 점수 + 위험 점수)을 사용합니다

문서 수집

증빙 문서를 수집하고 검증합니다:

문서 유형	예시
설립 증명서	회사 설립 증명서
정관	내규, 회사 설립 각서
주소 증명	등록 주소에 대한 공과금 고지서, 은행 거래 내역서
주주 명부	공식 주주 명부
재무제표	연간 결산서, 감사 보고서
세무 증명서	세무 등록 또는 세무 준수 증명서
사용자 지정 문서	귀사의 컴플라이언스 절차에서 요구하는 추가 문서

검토 과정에서 분석가는 기업에 추가 문서를 요청할 수 있습니다.

검토 및 결정

기업 세션에는 모든 검사 결과를 바탕으로 한 전체 상태가 부여됩니다:

상태	의미
승인됨	모든 검사를 통과하여 회사가 인증됨
검토 중	하나 이상의 검사에 수동 검토가 필요함
거부됨	중대한 검사가 실패함(예: 해산된 회사, 제재 대상 주체)

분석가는 Business Console에서 수집된 모든 데이터를 검토하고, 댓글을 추가하고, 추가 문서를 요청하며, 최종 결정을 내릴 수 있습니다.

기업 세션 수명 주기

각 기업 확인은 기업 세션 안에서 실행되며, 세션은 다음 상태를 거치며 진행 상황을 추적합니다:

상태	설명
`"Not Started"`	세션은 생성되었으나 확인이 시작되지 않은 상태
`"In Progress"`	확인이 진행 중인 상태. 등기 조회, AML 스크리닝 또는 문서 수집이 진행 중입니다
`"Approved"`	모든 검사를 통과한 상태. 회사가 확인되었습니다
`"Declined"`	중요한 검사에 실패한 상태(예: 해산된 회사, 제재 대상 법인)
`"In Review"`	하나 이상의 검사에 수동 검토가 필요한 상태
`"Resubmitted"`	이전에 거부된 세션이 업데이트된 데이터로 다시 제출된 상태

각 세션에는 고유한 session_id, 순차적인 session_number, 호스팅 인증 링크용 session_token이 있습니다. vendor_data 식별자와 함께 세션을 생성하면 Didit이 해당 기업 프로필에 자동으로 연결합니다.

기능 상태

기업 확인은 각 구성 요소의 상태를 독립적으로 추적합니다:

기능	설명
등기 조회	법인 등기부 조회 및 데이터 추출
기업 AML	제재 및 감시 목록을 기준으로 한 회사 단위 AML 스크리닝
문서	문서 수집, OCR 및 교차 대조
주요 인물	실소유자 및 임원 식별, AML 및 KYC

각 기능의 상태는 "Not Finished", "Approved", "Declined", "In Review", "Resub Requested" 중 하나일 수 있습니다. 세션 전체 상태는 개별 기능 상태를 종합합니다. 세션은 필수 기능이 모두 통과한 경우에만 "Approved"가 됩니다.

webhook 이벤트

기업 세션은 다음 webhook 이벤트를 생성합니다:

이벤트	트리거
`status.updated`	세션 상태가 변경됨. KYB 세션의 페이로드에는 `session_kind: "business"`가 포함됩니다.
`data.updated`	검토자가 콘솔에서 등기 데이터 또는 주요 인물을 수정했거나, 등기부에서 변경 사항을 보고함. 페이로드에 `session_kind: "business"`가 포함됩니다. 진행 상황은 `status.updated`를 기준으로 확인하세요.
`business.status.updated`	연결된 기업 엔터티의 상태(`ACTIVE` / `FLAGGED` / `BLOCKED`)가 변경됨.
`business.data.updated`	연결된 기업 엔터티의 프로필 필드 또는 누적 카운터가 변경됨.

webhook 페이로드에는 사용자 인증 이벤트와 구별하기 위해 session_kind: "business"와 business_session_id가 포함됩니다. 서명 검증 및 전송 세부 정보는 webhook 문서를 참고하세요.

주요 기능

기능	설명
자동 등기 조회	지원 국가의 공식 법인 등기부를 Lite, Shareholders 또는 UBOs 등급으로 조회합니다. 국가별 요금이 적용됩니다
UBO 식별	지분율을 포함한 실소유 구조를 자동으로 추출합니다
임원 스크리닝	이사, 회사 서기 및 기타 임원을 식별하고 확인합니다
기업 AML	회사 법인을 제재 및 감시 목록과 대조하여 스크리닝합니다
개인 AML	식별된 모든 UBO와 임원을 개별적으로 스크리닝합니다
KYC 연결	식별된 각 인물을 신원 확인을 위해 사용자 인증(KYC) 세션에 연결합니다
문서 수집	업로드 추적을 포함한 구조화된 문서 요청
OCR 교차 검증	업로드된 문서에서 데이터를 추출하고 등기 데이터와 교차 대조합니다
기업 프로필	확인된 각 회사의 프로필을 자동으로 생성하고 세션을 통합합니다
기능 수준 상태	등기, AML, 문서, 주요 인물에 대해 독립적으로 상태를 추적합니다
위험 평가	각 검사에 경고 태그를 표시하고, 워크플로 작업을 통해 회사 상태, AML 결과, 소유 구조 검토 결과를 최종 결과로 전환합니다
webhook	webhook을 통해 세션 수명 주기와 데이터 업데이트 이벤트를 실시간으로 수신합니다

기업 세션과 사용자 세션 비교

기능	사용자 세션	기업 세션
대상	개인	회사 또는 법인
세션 종류	`user` (기본값)	`business`
핵심 검사	신분증, 라이브니스, 얼굴 대조, AML	등기 조회, UBO, 임원, 기업 AML
추가 검사	전화번호, 이메일, 주소 증명, NFC	문서 수집, 개인 AML, KYC 연결
webhook 페이로드	표준 세션 이벤트	`session_kind: "business"` 및 `business_session_id` 포함

다음 단계

기업 프로필

프로필, 태그, 일괄 작업으로 여러 세션에 걸쳐 회사를 추적하세요.

회사 데이터

등기 조회, 회사 상태, 데이터 교차 대조.

소유 구조

UBO 식별, 법인 주주, 소유 체인.

임원 및 이사

이사 식별, 역할, KYC 연결.

AML 스크리닝

회사 및 개인 단위 AML 검사.

문서

문서 수집, 요청, OCR 검증.

시작하기

기능

기업 프로필

레퍼런스

콘솔

기업 확인(KYB) API: 법인 등기 및 UBO

작동 방식

기업 세션 수명 주기

기능 상태

webhook 이벤트

주요 기능

기업 세션과 사용자 세션 비교

다음 단계

기업 프로필

회사 데이터

소유 구조

임원 및 이사

AML 스크리닝

문서

​작동 방식

​기업 세션 수명 주기

​기능 상태

​webhook 이벤트

​주요 기능

​기업 세션과 사용자 세션 비교

​다음 단계

기업 프로필

회사 데이터

소유 구조

임원 및 이사

AML 스크리닝

문서

작동 방식

기업 세션 수명 주기

기능 상태

webhook 이벤트

주요 기능

기업 세션과 사용자 세션 비교

다음 단계