> ## 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 상태 참조: 세션, 기능 및 AML

> Didit KYB 세션, 기능, 법인 등기부 조회 및 AML 스크리닝의 정확한 상태 문자열과 기능명입니다. 확인 건당 $2.00부터, 국가 및 등급별 요금.

기업 확인(KYB)은 **세션**, 개별 **기능**, **레지스트리 조회** 결과, **AML 결과**의 여러 수준에서 상태를 추적합니다. 이 페이지는 모든 상태에 대한 참조 문서입니다.

API는 `"In Progress"`, `"Not Finished"`처럼 대소문자를 구분하는 정확한 문자열로 상태 값을 반환하며, webhook에도 같은 문자열이 전달됩니다. 대문자 이름이 아니라 이 문자열과 정확히 일치하는지 확인하십시오.

## 세션 상태

기업 확인(KYB) 세션의 전체 상태입니다. 가장 자주 분기 처리에 사용하게 될 필드입니다.

| 상태 | 의미 |
| - | - |
| `"Not Started"` | 세션은 생성되었으나 기업이 호스팅 링크를 열지 않았습니다. |
| `"In Progress"` | 호스팅 흐름이 진행 중입니다. 레지스트리 조회, 문서 업로드 또는 AML 스크리닝이 진행되고 있습니다. |
| `"Awaiting User"` | 최종 사용자의 작업을 기다리고 있습니다. 일반적으로 주요 인물 제출 또는 재제출 요청에 대한 응답입니다. 사용자가 대기 중인 작업을 완료하면 자동으로 전환됩니다. |
| `"Approved"` | 필수 기능이 모두 통과되었습니다. 기업이 확인되었습니다. |
| `"Declined"` | 중요한 검사가 실패했습니다(해산된 회사, 제재 대상 법인, 차단 목록 등록). 또는 워크플로 규칙이 거부했습니다. |
| `"In Review"` | 하나 이상의 기능에 수동 검토가 필요합니다. |
| `"Resubmitted"` | 이전에 거부되었거나 재제출이 요청된 세션이 업데이트된 데이터와 함께 다시 제출되었습니다. |
| `"Abandoned"` | 기업이 흐름을 끝까지 완료하지 않았습니다(시간 초과). |
| `"Expired"` | 기업이 완료하기 전에 세션이 만료되었습니다. |

> [!NOTE]
>
> `"Awaiting User"`는 일시적인 상태입니다. 세션을 이 상태에서 수동으로 옮길 필요는 없습니다. 최종 사용자가 대기 중인 작업(예: 주요 인물 목록 제출 또는 요청된 문서 재업로드)을 완료하면 Didit이 세션을 다시 평가하고, 결과에 따라 `"In Review"`, `"Approved"`, `"Declined"` 중 하나로 자동 전환합니다.

## 기능 상태

각 KYB 기능은 고유한 상태를 가지며, 이 상태가 모여 세션 상태를 구성합니다.

| 상태 | 의미 |
| - | - |
| `"Not Finished"` | 기능이 아직 시작되지 않았거나 실행 중입니다. |
| `"Approved"` | 기능을 통과했습니다. |
| `"Declined"` | 기능이 실패했습니다(치명적). |
| `"In Review"` | 기능에 분석가의 검토가 필요합니다. |
| `"Resub Requested"` | 기업이 이 기능에 대해 다시 제출해야 합니다(예: 문서 재업로드). |
| `"Awaiting User"` | 기능이 최종 사용자의 작업을 기다리고 있습니다. 사용자가 주요 인물을 제출해야 할 때 주요 인물 기능에 적용됩니다. 제출되면 자동으로 전환됩니다. |

### KYB 기능 이름

다음은 KYB 세션의 `features` 값이자 webhook에 사용되는 값입니다.

* `KYB_REGISTRY`: 법인 등기부 조회
* `AML`: 기업 단위 AML 스크리닝
* `KYB_DOCUMENTS`: 문서 수집 및 OCR
* `KYB_KEY_PEOPLE`: 주요 인물, 즉 실소유자(UBO), 주주, 이사, 대리인 및 기타 임원

## 레지스트리 상태(제공자 제공)

공신력 있는 등기 출처에서 가져온 기업의 공식 상태입니다. 관할 지역별 등기부가 보고한 법인의 법적 또는 규제상 지위를 반영하므로, 정확한 값은 출처에 따라 다릅니다. KYB 판정 결과의 `company.registry_status` 아래에 표시됩니다.

| 상태 | 의미 |
| - | - |
| `ACTIVE` | 기업이 활동 중이며 정상 상태입니다. |
| `DISSOLVED` | 기업이 해산되었습니다. |
| `DEREGISTERED` | 기업의 등록이 말소되었습니다. |
| `STRUCK_OFF` | 기업이 등기부에서 제외되었습니다. |
| `CLOSED` | 기업이 폐쇄되었습니다. |
| `INACTIVE` | 기업이 비활동 상태입니다(영업 중이 아님). |
| `AUTHORISED` | 인가를 받았습니다(주로 규제 대상 기관). |
| `APPOINTED_REPRESENTATIVE` | 다른 인가 기관의 지정 대리인입니다. |
| `UNAUTHORISED` | 이전에는 인가를 받았으나 현재는 인가가 없습니다. |
| `NO_LONGER_AUTHORISED` | 인가가 취소되었습니다. |
| `SEE_FULL_DETAILS` | 상태를 직접 확인해야 합니다. |

> [!NOTE]
>
> `registry_status`는 등기부의 원시 값을 반영하므로, 제품 로직을 구동하기 위해 관할 지역과 무관하게 일관된 지표가 필요하다면 아래의 `verification_status`를 사용하십시오.

## 기업 확인 상태

기업 조회 결과마다 제공되는, 비즈니스 관점의 표준화된 상태입니다. 국가와 출처에 따라 다른 등기 및 기업 상태를 하나의 일관된 지표로 정규화하여, 제품 내에서 바로 해석할 수 있습니다. KYB 판정 결과의 `company.verification_status` 아래에 표시됩니다.

| 상태 | 의미 |
| - | - |
| `verified` | 기업이 활동 중이며 유효해 보입니다. |
| `failed` | 기업이 비활동 상태이거나 해산되었거나, 문제가 확인되었습니다. |
| `unknown` | 정보가 부족하거나 상태가 모호합니다. |

## 기업 조회 상태

외부 또는 공식 등기부에서 특정 기업 레코드를 가져오는 진행 상황을 나타냅니다. 해당 기업에 대해 가져온 정보가 얼마나 완전한지 판단하는 데 사용하십시오. KYB 판정 결과의 `company.fetch_status` 아래에 표시됩니다.

| 상태 | 의미 |
| - | - |
| `pending` | 현 단계에서는 기업 정보가 일부 또는 기본 수준으로만 조회되었습니다. |
| `resolved` | 공식 출처에서 전체 기업 데이터가 완전하게 조회되었습니다. |

## AML 확인 상태

스크리닝(기업 또는 개인)마다 반환됩니다.

| 상태 | 의미 |
| - | - |
| `"Approved"` | 임계값을 넘는 적중 결과가 없습니다. |
| `"Declined"` | 심각도가 높은 적중 결과가 있습니다(확정된 제재 또는 PEP 일치). |
| `"In Review"` | 분석가 검토가 필요한 적중 결과가 있습니다. |
| `"Not Finished"` | 스크리닝이 완료되지 않았습니다. |

## 결정이 설명되는 방식

KYB 결정에는 단일 사유 코드 문자열이 포함되지 않습니다.
각 기능 배열(`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`)에는 `KYB_*` 및 AML 태그가 담긴 `warnings[]`가 포함되며, `decision_trace`에는 결정에 이른 과정이 기록됩니다.
[KYB 경고](https://docs.didit.me/ko/business-verification/warnings.md)에서 태그를 확인하고, 세션 상태와 함께 기록하십시오.

검토자가 플랫폼 자체 집계 결과와 다르게 상태를 직접 설정하면, 결정에 `overridden_at` 시각과 플랫폼이 설정했을 `automatic_status`를 담은 `status_override`가 포함됩니다.
[응답 스키마](https://docs.didit.me/ko/business-verification/response-schema.md)를 참조하십시오.

## 다음 단계

> [card] [응답 스키마](https://docs.didit.me/ko/business-verification/response-schema.md)
>
> payload에서 각 상태가 표시되는 위치입니다.

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

> [card] [webhook](https://docs.didit.me/ko/business-verification/webhooks.md)
>
> 상태가 변경될 때 발생하는 이벤트입니다.


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