> ## 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.

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

> Didit의 기업 확인 API로 법인 등기 조회, UBO 식별, 임원 스크리닝, AML 검사를 수행하세요. 국가 및 등급별 건당 $2.00부터, 계약 없이 이용 가능.

Didit의 기업 확인(KYB)을 사용하면 기업과 법인을 플랫폼에 온보딩하기 전에 검증할 수 있습니다. 시스템은 법인 등기부 조회를 자동화하고, 실소유자와 임원을 식별하며, 모든 당사자를 AML 감시 목록과 대조하고, 증빙 문서를 수집합니다. 이 모든 과정은 하나의 워크플로 안에서 이루어집니다. 검증이 완료된 각 회사는 [기업 프로필](https://docs.didit.me/ko/business-verification/business-profiles.md)로 관리되며, 세션 전반의 결과가 집계됩니다.

이 Didit Academy 강의는 기업 확인의 처음부터 끝까지를 다룹니다. KYB 대시보드, 등기부 확인, 주주와 UBO, AML 스크리닝, 그리고 회사 대표자가 자신의 화면에서 보게 되는 내용을 살펴봅니다.

[기업 확인(KYB) 처음부터 끝까지 - Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1)

Didit KYB를 처음 사용하신다면 10분 만에 전체 과정을 살펴볼 수 있는 [빠른 시작](https://docs.didit.me/ko/business-verification/quickstart.md)부터 시작한 뒤, 프로덕션 패턴은 [통합 가이드](https://docs.didit.me/ko/business-verification/integration-guide.md)에서 확인하십시오. 사용자, 차단 목록, 가져오기 및 내보내기와 연결되는 기본 기업 엔티티 모델은 [기업](https://docs.didit.me/ko/entities/businesses/overview.md)을 참고하십시오.

## 작동 방식

**1. 기업 세션 생성**

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

```bash theme={null}
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 워크플로는 기업 전용 기능을 활성화한 기업 세션을 자동으로 생성합니다.

**2. 회사 등록 정보 조회**

Didit는 **Lite**, **Shareholders**, **UBOs** 등급으로 공식 법인 등기부를 조회합니다. 각 등급의 요금은 국가별로 책정되며, [등기부 조회 요금](https://docs.didit.me/ko/getting-started/kyb-registry-pricing.md)을 참고하십시오. Lite에서는 다음 정보를 가져옵니다:

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

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

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

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

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

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

**4. AML 스크리닝**

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

* **기업 AML**: 기업 주체를 제재, 부정적 언론 보도, 규제 집행 목록과 대조합니다
* **개인 AML**: 각 주요 인물(UBO, 주주, 이사, 대표자 등)을 개별적으로 대조합니다
* 사용자 인증과 동일한 [이중 점수 위험 시스템](https://docs.didit.me/ko/core-technology/aml-screening/overview.md)(일치 점수 + 위험 점수)을 사용합니다

**5. 문서 수집**

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

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

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

**6. 검토 및 결정**

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

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

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

## 기업 세션 수명 주기

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

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

각 세션에는 고유한 `session_id`, 순차적인 `session_number`, 호스팅 인증 링크용 `session_token`이 있습니다. `vendor_data` 식별자와 함께 세션을 생성하면 Didit이 해당 [기업 프로필](https://docs.didit.me/ko/business-verification/business-profiles.md)에 자동으로 연결합니다.

## 기능 상태

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

| 기능 | 설명 |
| - | - |
| **등기 조회** | 법인 등기부 조회 및 데이터 추출 |
| **기업 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` | 연결된 [기업 엔터티](https://docs.didit.me/ko/entities/businesses/overview.md)의 상태(`ACTIVE` / `FLAGGED` / `BLOCKED`)가 변경됨. |
| `business.data.updated` | 연결된 기업 엔터티의 프로필 필드 또는 누적 카운터가 변경됨. |

webhook 페이로드에는 사용자 인증 이벤트와 구별하기 위해 `session_kind: "business"`와 `business_session_id`가 포함됩니다. 서명 검증 및 전송 세부 정보는 [webhook](https://docs.didit.me/ko/integration/webhooks.md) 문서를 참고하세요.

## 주요 기능

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

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

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

## 다음 단계

> [card] [기업 프로필](https://docs.didit.me/ko/business-verification/business-profiles.md)
>
> 프로필, 태그, 일괄 작업으로 여러 세션에 걸쳐 회사를 추적하세요.

> [card] [회사 데이터](https://docs.didit.me/ko/business-verification/company-data.md)
>
> 등기 조회, 회사 상태, 데이터 교차 대조.

> [card] [소유 구조](https://docs.didit.me/ko/business-verification/ownership.md)
>
> UBO 식별, 법인 주주, 소유 체인.

> [card] [임원 및 이사](https://docs.didit.me/ko/business-verification/officers.md)
>
> 이사 식별, 역할, KYC 연결.

> [card] [AML 스크리닝](https://docs.didit.me/ko/business-verification/aml.md)
>
> 회사 및 개인 단위 AML 검사.

> [card] [문서](https://docs.didit.me/ko/business-verification/documents.md)
>
> 문서 수집, 요청, OCR 검증.


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