> ## 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: 법인 서류 검증

> KYB에서 설립 증명서, 정관, 재무제표 등 기업 문서를 수집하고 OCR로 판독해 교차 검증하세요. 법인 등기부 검증 포함. 등기부 조회와 요금을 별도로 책정합니다.

기업 확인에는 등기부에서 확인할 수 있는 정보 이상으로 회사 정보를 검증하기 위한 구조화된 문서 수집이 포함됩니다.

## 요금

KYB 문서 수집 요금은 **워크플로 단계당 \$0.20**이며, 해당 단계에서 업로드하는 문서 수와는 무관합니다. 같은 단계에서 문서를 다시 업로드해도 추가 요금은 부과되지 않습니다. 별도의 문서 수집 단계에는 각각 요금이 부과됩니다.

## 문서 그룹

문서는 기업 확인에 필요한 증거 범주에 따라 네 개의 구조화된 그룹으로 나뉩니다. Didit이 분류할 수 없는 문서를 담는 기타 그룹도 있습니다.

| 그룹 (`document_group`) | 설명 | 인식되는 문서 하위 유형 |
| - | - | - |
| **법적 존재** (`LEGAL_PRESENCE`) | 회사가 법적으로 존재함을 증명하는 문서 | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **회사 세부정보** (`COMPANY_DETAILS`) | 회사의 현재 세부 정보를 설명하는 문서 | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **소유 구조** (`OWNERSHIP_STRUCTURE`) | 소유 체계를 증명하는 문서 | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **대표자 권한** (`REPRESENTATIVES_AUTHORIZATION`) | 회사를 대신해 행동할 권한을 증명하는 문서 | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **기타** (`OTHER`) | Didit이 확실하게 분류할 수 없는 문서 | `UNKNOWN` |

각 그룹은 다음 그룹별 카운터로 진행 상황을 추적합니다: `total`, `approved`, `pending`, `declined`, `in_review`, `other`, `missing`. 기업 세션의 전체 문서 상태는 모든 그룹을 종합한 값입니다.

## 문서 유형

| 범주 | 예시 |
| - | - |
| **설립 문서** | 설립증명서, 정관, 설립 규약 |
| **소유권 문서** | 주주 명부, 주식 증서, UBO 선언서 |
| **주소 문서** | 등록 주소의 공과금 고지서, 은행 거래내역서 또는 임대차 계약서 |
| **재무 문서** | 연간 결산서, 감사 보고서, 재무제표 |
| **세무 문서** | 세무 등록증, 납세 증명서 |
| **규제 문서** | 면허, 허가증, 규제 승인서 |
| **맞춤 문서** | 컴플라이언스 절차에서 요구하는 추가 문서 |

## 문서 워크플로

**1. 자동 요청**

워크플로 구성에 따라 Didit이 기업 확인에 필요한 문서를 자동으로 식별합니다. 필요한 문서 유형이 기업이 업로드할 수 있도록 제시됩니다.

**2. 업로드**

문서는 호스팅 인증 흐름, Business Console 또는 자체 프런트엔드에서 [문서 업로드](https://docs.didit.me/ko/sessions-api/kyb-upload-documents.md) 엔드포인트를 사용해 업로드할 수 있습니다. 지원되는 형식은 PDF, JPG, JPEG, PNG, TIFF, WebP 또는 이들을 담은 ZIP 아카이브입니다. PDF는 최대 50 MB, 사진은 압축 전 최대 6 MB까지 업로드할 수 있습니다. 비밀번호로 보호된 PDF는 API로 업로드할 때 `document_passwords`에 비밀번호를 전송해야 합니다.

**3. OCR 추출**

Didit은 OCR을 사용해 업로드된 문서에서 구조화된 데이터를 추출합니다:

* 증명서에서 회사명과 등록번호
* 공과금 고지서에서 주소 데이터
* 명세서에서 재무 수치
* 주주 명부에서 이름과 역할

**4. 교차 참조**

추출된 데이터는 다음과 대조됩니다:

* 기업 조회에서 얻은 등기부 데이터
* 세션 생성 시 제공된 정보
* 업로드된 다른 문서의 데이터

일관되지 않은 내용은 분석가 검토 대상으로 표시됩니다.

**5. 검토**

분석가는 Business Console에서 업로드된 문서를 검토하고 진위를 확인한 뒤, 문서별로 승인 또는 거부합니다.

## 분석가의 문서 요청

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

1. Business Console에서 기업 세션으로 이동합니다
2. **문서 요청**을 클릭하고 문서 유형과 설명을 입력합니다
3. 기업에 알림이 전송되며, 기업은 요청된 문서를 업로드할 수 있습니다
4. 업로드 전까지 해당 문서는 세션에 **요청됨** 상태로 표시됩니다

이를 통해 분석가는 기업 세션 전체를 거부하지 않고도 추가 증거를 수집할 수 있습니다.

## 문서 상태

각 문서와 집계 `document_verifications[]` 검사는 표준 KYB 기능 상태 집합을 사용합니다:

| 상태 | 설명 |
| - | - |
| `"Not Finished"` | 문서가 아직 처리 중입니다(업로드 진행 중, OCR 실행 중 또는 교차 검증 대기 중). |
| `"Approved"` | 문서가 검토되어 승인되었습니다. |
| `"Declined"` | 문서가 검토되어 거부되었습니다. |
| `"In Review"` | 문서에 분석가의 수동 확인이 필요합니다. |
| `"Resub Requested"` | 분석가가 재제출을 요청했습니다. 세션이 진행되려면 기업이 이 문서를 다시 업로드해야 합니다. |

## 교차 검증 결과

문서가 처리되면 Didit은 OCR로 추출한 데이터를 Key People 흐름에서 제출된 **사용자 제공 데이터**(및 등기부 검토 중 확인된 데이터) 및 다른 업로드 문서의 데이터와 교차 참조합니다. 교차 검증은 다음과 같은 구조화된 결과를 생성합니다.

| 범주 | 설명 |
| - | - |
| **중요 필드** | 문서 데이터와 사용자 제공 데이터가 일치하지 않는 필드입니다. 분석가의 검토가 필요합니다. 각 필드에는 문서 값, 사용자 제공 값, 신뢰도 점수가 표시됩니다. |
| **비중요 필드** | 조치가 필요하지 않을 수 있는 사소한 불일치나 형식 차이가 있는 필드입니다(예: 회사명의 약어 차이). |
| **인물 중복** | 문서에 언급된 인물과 사용자가 제출한 인물을 비교한 분석입니다. 누락되었거나 추가된 인물을 강조하여 보여 줍니다. |

교차 검증 결과는 문서 미리보기와 함께 [Business Console](https://docs.didit.me/ko/business-verification/console.md)에 표시되므로, 분석가는 일치하는 항목과 확인이 필요한 항목을 한눈에 파악할 수 있습니다.

## API로 문서 조회하기

문서는 기업 확인(KYB) 세션에 첨부됩니다. 세션 결정을 통해 문서를 가져오십시오.

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

응답에는 `document_verifications[]` 배열이 포함됩니다. 각 항목에는 `status`, `node_id`, `items[]`(각각 서명된 `file_url`, `document_group`, `document_subtype`, OCR 추출 결과 포함), `groups`, `required_groups`가 있습니다. 전체 구조는 [응답 스키마](https://docs.didit.me/ko/business-verification/response-schema.md#document_verifications)를 참조하십시오.

## 다음 단계

> [card] [응답 스키마](https://docs.didit.me/ko/business-verification/response-schema.md)
>
> 페이로드에서 문서가 나타나는 위치입니다.

> [card] [Business console](https://docs.didit.me/ko/business-verification/console.md)
>
> 분석가로서 문서를 검토하는 방법입니다.


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