> ## 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 및 국가 차단

> vendor_data 또는 국가로 Didit 기업 엔터티를 차단하는 방법, 차단 확인 방식, 차단을 추가하거나 제거하는 콘솔 및 API 경로를 설명합니다.

Blocklists prevent a business that has failed your compliance checks, or one located in a dangerous jurisdiction, from running new Business Verification (KYB) sessions or transacting on your platform. — 차단 목록은 규정 준수 검사를 통과하지 못한 기업이나 위험 관할권에 위치한 기업이 플랫폼에서 새로운 기업 확인(KYB) 세션을 실행하거나 거래하는 것을 방지합니다.

## 기업에 지원되는 식별자 유형

| 유형 | 키 | 일치 조건 |
| - | - | - |
| 기업 | `BUSINESS` | 새 세션 또는 거래가 차단된 `vendor_data`를 사용할 때 |
| 국가 | (별도 설정) | 기업의 국가가 위험 국가 목록과 일치할 때 |
| IP | `IP_ADDRESS` | 제출자의 IP(또는 CIDR 범위)가 일치할 때 |
| 기기 지문 | `DEVICE_FINGERPRINT` | 제출자의 기기가 일치할 때 |
| 주소 | `WALLET_ADDRESS` | 기업과 연결된 암호화폐 지갑이 일치할 때 |
| 은행 계좌 | `BANK_ACCOUNT` | IBAN 또는 은행 계좌가 일치할 때 |

> [!NOTE]
>
> 얼굴 및 문서 차단 목록은 기업 수준이 아니라 **개인**(사용자) 수준에서 작동합니다. 이사 또는 UBO(실소유자)를 차단하려면 이들을 사용자로 차단하세요. 그러면 해당 인물이 관여한 모든 기업의 주요 인물 검토에 반영됩니다.

## 차단은 어떻게 이루어지나요

> [!NOTE]
>
> 거부된 기업 확인(KYB) 세션은 기업을 차단하지 않습니다. 세션은 `Declined` 상태로 끝나고, 기업은 `ACTIVE` 상태를 유지하며, 목록 항목도 기록되지 않습니다. 차단은 수동 단계입니다. [차단 목록 페이지](https://docs.didit.me/ko/console/blocklist-users.md)에서 항목을 추가하거나 [Lists API](https://docs.didit.me/ko/management-api/lists/overview.md)를 사용하세요. `BUSINESS` 항목(`vendor_data`)을 추가하면 기업의 상태도 `BLOCKED`로 설정됩니다.

**1. 자동 — 위험 국가인 경우**

기업의 설립 국가가 설정된 위험 국가 목록에 있으면 기업 확인(KYB) 세션이 거부됩니다.

**2. 자동 — 제재 대상 법인인 경우**

거부 임계값을 넘는 법인 AML 일치 항목이 있으면 세션이 거부됩니다. 이때 목록 항목은 기록되지 않으므로, 이후에도 기업의 `vendor_data`를 거부하려면 직접 기업을 차단하세요.

**3. 수동 — 콘솔에서**

분석가가 *Businesses → \[business] → Actions → Add to blocklist* 경로에서 기업을 차단합니다.

**4. 프로그래밍 방식 — Lists API 사용**

[Lists API](https://docs.didit.me/ko/management-api/lists/overview.md)를 사용해 기업 차단 목록에 항목을 직접 추가하세요.

## 위험 국가

각 애플리케이션에는 기본 **위험 국가** 목록이 포함되어 있습니다(*Settings → Blocklist → Countries*에서 설정할 수 있습니다). 기본 포함 ISO 코드 예시는 `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`입니다(변경될 수 있으며, 기본 목록은 FATF 및 OFAC 지침을 따릅니다).

`country_code`가 일치하는 기업이 생성되면 다음과 같이 처리됩니다:

* 기업 확인(KYB) 세션이 거부됩니다.
* 세션 링크가 발급되지 않습니다.
* 기업 엔티티가 `BLOCKED` 상태로 생성됩니다.

## API로 기업을 차단 목록에 추가하기

[Lists API](https://docs.didit.me/ko/management-api/lists/overview.md)를 사용해 프로그래밍 방식으로 차단 목록 항목을 추가하세요:

1. `entry_type=business`와 `is_system=true` 필터를 적용해 [모든 목록 조회](https://docs.didit.me/ko/management-api/lists/list.md)를 실행하여 시스템 기업 차단 목록을 찾습니다.
2. 해당 목록에 [항목 생성](https://docs.didit.me/ko/management-api/lists/create-entry.md)하면서 `value`는 기업의 `vendor_data`로 설정합니다. 감사 목적으로 선택 사항인 `display_label`과 `comment`를 함께 입력할 수 있습니다.

## 거래 시점의 적용

차단된 기업은 거래 모니터링에 자동으로 반영됩니다:

* **차단된 신청 기업**이 포함된 거래는 자동으로 거부됩니다.
* **차단된 거래 상대방 기업**이 포함된 거래는 규칙 설정에 따라 플래그가 지정되거나 거부됩니다.

"Sanctioned counterparty"와 같은 사전 설정 규칙은 이러한 일치 항목에 대해 트리거됩니다.

## 차단 목록에서 기업 제거하기

* **콘솔**: *Blocklist → Businesses → row actions → Remove*.
* **API**: 목록 UUID와 항목 UUID를 사용해 [항목 삭제](https://docs.didit.me/ko/management-api/lists/delete-entry.md) 엔드포인트를 사용하세요.

제거해도 기업의 `status`는 자동으로 바뀌지 않습니다. 기업을 `ACTIVE`로 되돌리려면 `PATCH /v3/businesses/{vendor_data}/update-status/`를 사용하세요.

## 감사 추적

추가와 제거는 모두 [감사 로그](https://docs.didit.me/ko/console/audit-logs.md)에 기록되며, 다음 정보가 포함됩니다:

* 작업자(사용자 이메일 또는 `'system'`, `'api'`).
* 타임스탬프.
* 선택 사항인 코멘트.
* 자동 생성된 경우 관련 세션 참조.

## 다음 단계

> [card] [Lists API](https://docs.didit.me/ko/management-api/lists/overview.md)
>
> 전체 차단 목록 API 참조.

> [card] [콘솔 차단 목록](https://docs.didit.me/ko/console/blocklist-users.md)
>
> UI에서 차단 목록을 관리하세요.

> [card] [운영](https://docs.didit.me/ko/entities/businesses/operations.md)
>
> 기업 상태를 변경하세요.


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