> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 실소유자(UBO) API: 법인 등기부 기반 실소유자 추출

> Didit는 법인 등기부에서 최종 실소유자(UBO)를 추출하고 소유 체인, 지분율, AML 스크리닝까지 제공합니다. 국가 및 등급별 건당 $2.00부터.

회사를 최종적으로 소유하고 통제하는 사람이 누구인지 확인하는 것이 KYB의 핵심입니다. Didit은 가능한 경우 등기부에서 소유 구조를 가져오고, 기업 관리자가 호스팅 흐름에서 이를 확인하고 보완할 수 있게 하며, 이후 각 주요 인물에 대해 역할을 고려한 인증을 실행합니다.

## 실소유자(UBO)

**최종 실소유자(UBO, Ultimate Beneficial Owner)**는 법인을 최종적으로 소유하거나 통제하는 자연인입니다. UBO는 세션 결정 결과의 `key_people_checks[].registry.beneficial_owners[]`(등기부 기반)와 `key_people_checks[].submitted.parties[]`(사용자 제출 기반)에 나타나며, 주주나 이사 같은 다른 역할은 같은 목록에 함께 표시됩니다.

## 각 주요 인물에 대해 수집하는 데이터

호스팅 흐름은 기본 필드 세트와 워크플로에서 설정한 추가 커스텀 필드를 수집합니다. 기본 필드는 다음과 같습니다.

| 필드 | 개인 | 회사 |
| - | :-: | :-: |
| `name` 또는 `first_name` + `last_name` | ✅ 필수 | ✅ 필수 (`company_name`) |
| `email` | ✅ 필수 | ✅ 필수 |
| `nationality` / 국가 | ✅ 필수 | ✅ 필수 |
| `role` (당사자당 하나 이상) | ✅ 필수 | ✅ 필수 |
| `ownership_percent` / `voting_percent` (역할별) | 선택 | 선택 |
| `date_of_birth` | 선택 | — |
| `phone_number` | 선택 | — |
| `position` (자유 입력 직함) | 선택 | — |
| `registration_number` | — | 선택 |
| `entity_type` | `person` | `company` |

`entity_type`은 당사자가 자연인인지 법인인지에 따라 자동으로 설정됩니다.

### 커스텀 필드

워크플로에서는 개인별 또는 회사별로 추가 필드를 원하는 만큼 요구할 수 있습니다. 이 필드는 Business Console의 KYB 워크플로에서 설정하며, 결정 응답의 각 당사자 `custom_fields` 객체에 담깁니다. 자산 출처 진술, 세무상 거주지, 내부 고객 ID, 업종별 공시 사항 같은 정보에 커스텀 필드를 사용하십시오.

## 법인 주주와 중첩 지분 구조

주주가 자연인이 아니라 법인인 경우 Didit은 다음 정보를 기록합니다.

* 회사명과 등록번호.
* 해당 법인 주주가 보유한 지분율.
* 설립 국가.

이를 통해 여러 계층을 거쳐 최종 자연인까지 지분 구조를 추적할 수 있습니다.

### 법인 UBO에 대한 중첩 KYB

워크플로에서 법인 UBO에 대한 중첩 KYB를 활성화하면, 각 법인 당사자는 자체 하위 KYB 세션을 시작합니다. 해당 회사는 최상위 수준에서 실행하는 것과 같은 프로세스로 인증을 받으며, 그 결과는 상위 세션에 다시 반영됩니다. 기본적으로 꺼져 있으며, 워크플로별로 선택해 활성화합니다.

## 소유 임계값

대부분의 관할권은 **25% 이상**의 지분을 보유한 자를 UBO로 분류합니다. 임계값은 워크플로별로 설정할 수 있습니다.

| 관할권 | 일반적인 UBO 임계값 |
| - | - |
| EU (AMLD) | 25% 이상의 소유 또는 통제 |
| UK | 25% 이상의 주식 또는 의결권 |
| USA (CTA) | 25% 이상의 소유 또는 실질적 통제 |
| Singapore | 25% 이상의 주식 또는 의결권 |

임계값은 *Workflows → \[KYB workflow] → Risk → UBO threshold*에서 설정합니다. 워크플로는 임계값을 충족하는 UBO가 없을 때(널리 분산된 상장 기업에서 흔합니다) 이를 표시하거나 검토 대상으로 보내도록 설정할 수도 있습니다.

## 의결권과 경제적 권리

소유 공시에서는 두 가지 유형의 통제를 구분합니다.

| 권리 | 의미 |
| - | - |
| **경제적(소유) 비율** | 회사의 경제적 가치 또는 배당권에서 차지하는 비율 |
| **의결권 비율** | 주주 결의에서 행사할 수 있는 의결권 비율 |

이 두 비율은 보통 같지만, 회사가 복수 의결권 주식이나 우선주를 발행하면 달라질 수 있습니다. Didit은 두 비율을 모두 기록합니다. 규칙과 임계값은 둘 중 어느 쪽으로든 확인할 수 있습니다. 대부분의 관할권은 *둘 중 어느 하나라도* 25% 이상이면 UBO 공시를 요구합니다.

## 지분 체인을 통한 실효 지분

소유가 법인 주주를 거쳐 이어지는 경우, 하위 자연인의 실효 지분은 체인을 따라 각 비율을 곱하여 계산합니다.

### 예시: 3계층 체인

```
Acme Corp (target)
  └─ 60% → Acme Holdings Ltd
              └─ 75% → Jane Doe (natural person)
  └─ 40% → John Smith (natural person)
```

계산된 UBO:

* **Jane Doe**: Acme Corp에 대한 실효 지분 = 60% × 75% = **45%** (UBO).
* **John Smith**: Acme Corp에 대한 실효 지분 = **40%** (UBO).

25% UBO 임계값에서는 Jane과 John이 모두 공시됩니다. 50% 임계값에서는 어느 누구도 기준을 충족하지 않으며, Didit은 이를 투명성 문제로 표시합니다.

## 역할 설정이 인증을 결정하는 방식

각 역할은 KYB 워크플로마다 개별적으로 설정합니다. 활성화 여부, KYC 필요 여부, 해당 역할에 사용할 KYC 워크플로, 최종 사용자가 건너뛸 수 있는지 여부를 설정할 수 있습니다. 주요 인물이 제출되면 다음과 같이 처리됩니다.

1. Didit은 제출된 당사자의 역할을 워크플로의 역할 설정과 대조합니다.
2. 인증이 필요하도록 표시된 역할에 대해서는 하위 인증 세션이 시작됩니다.
   * **개인 당사자** → 하위 사용자 인증(KYC) 세션. 역할별 KYC 워크플로 또는 기본 워크플로를 사용합니다.
   * **법인 UBO**(중첩 KYB가 활성화된 경우) → 하위 기업 확인(KYB) 세션.
3. 건너뛸 수 있도록 표시된 역할의 경우, 최종 사용자에게 "인증 건너뛰기" 옵션이 표시되며 사용자는 이를 선택해 인증을 생략할 수 있습니다. 건너뛴 당사자는 기록되지만 상위 세션을 차단하지 않습니다.
4. 워크플로의 소유 임계값 미만인 당사자는, 해당 역할이 원래 인증을 요구하더라도 개별 인증을 시작하지 않습니다.

모든 설정은 Business Console의 *Workflows → \[KYB workflow] → Key People*에서 구성합니다.

## 주주 및 UBO 모니터링

> [!NOTE]
>
> 등기부 모니터링은 **곧 출시 예정**입니다. 2026년 9월 7일 기준으로 확인한 스테이징 리테일 카탈로그의 어느 국가에서도 모니터링이 활성화되어 있지 않습니다. 회사당 연 USD 2.00으로 설정되어 있지만, 가격이 표시되어 있다고 해서 해당 기능을 사용할 수 있다는 뜻은 아닙니다. 아래 내용은 출시 후 제공될 서비스를 설명합니다.

**주주** 또는 **UBO** 등급으로 확인된 회사는 **지속적인 등기부 모니터링** 대상이 될 수 있습니다. 등기부는 회사 상태, 임원, 소유 구조, 등록 주소의 변경 사항을 전달하며, 변경이 있을 때마다 Didit은 다음을 수행합니다:

* 기업 세션을 *승인됨*에서 *검토 중*으로 되돌리고, 변경 내용을 세션에 기록합니다;
* `trigger: "kyb_registry_change"`가 포함된 `data.updated` [webhook](https://docs.didit.me/ko/business-verification/webhooks.md)을 보냅니다;
* 회사의 등기부 기록을 최신 상태로 유지합니다.

모니터링은 **해당 국가가 허용하는 경우에만 이용할 수 있습니다**. 등기부 제공자가 해당 관할권에 대한 감시 서비스를 제공해야 합니다. 전체 목록은 [지속적인 모니터링 지원 국가 표](https://docs.didit.me/ko/business-verification/supported-countries.md#지속적인-등기부-모니터링)에서 확인할 수 있습니다. Lite 등급으로 확인된 회사나 목록에 없는 국가의 회사는 등록되지 않으며, 기업 페이지에 그 이유가 표시됩니다.

워크플로마다 *Workflows → KYB Registry Check → Advanced → Continuous registry monitoring*에서 활성화합니다. 비용은 **회사당 연 \$2.00**이며, 등록 시와 매년 갱신 시에 청구됩니다. 갱신 시 지갑 잔액이 부족하면 미결제 상태로 계속 실행되지 않고 해당 회사의 모니터링이 중단됩니다. 기업 페이지에서 언제든지 취소할 수 있습니다(*KYB Registry Check → Registry monitoring*).

## 등기부 정보와 사용자 제출 정보 대조

응답은 `key_people_checks[]` 아래에서 두 출처를 나란히 보여 줍니다:

* `registry.officers[]`와 `registry.beneficial_owners[]`: 제공자가 공개한 정보입니다.
* `submitted.parties[]`: 기업 관리자가 흐름을 통해 명시적으로 제출한 정보이며, `source: "USER"`를 가집니다.

분석가는 콘솔에서 두 항목을 시각적으로 비교하여 누락된 UBO, 공개되지 않은 추가 당사자, 지분율이 서로 맞지 않는 경우를 찾아냅니다. 자동 비교 엔드포인트는 없으며, 이름, 역할, 해당되는 경우 지분을 기준으로 매칭하여 직접 대조할 수 있습니다.

## AML 스크리닝

식별된 모든 주요 인물은 등기부 측과 제출 측 모두에서 전 세계 AML 감시 목록에 대해 자동으로 스크리닝됩니다. 회사 수준과 개인 수준 AML 확인이 어떻게 결합되는지는 [기업 AML 스크리닝](https://docs.didit.me/ko/business-verification/aml.md)을 참조하세요.

## 다음 단계

> [card] [주요 인물](https://docs.didit.me/ko/business-verification/key-people.md)
>
> 주요 인물 플로우를 처음부터 끝까지 다룹니다.

> [card] [임원 및 대표자](https://docs.didit.me/ko/business-verification/officers.md)
>
> 주요 인물 모델 안의 거버넌스 역할입니다.

> [card] [위험 평가](https://docs.didit.me/ko/business-verification/risk-assessment.md)
>
> KYB 결과를 결정하는 요인입니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.