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

# AML 스크리닝 경고 및 알림 코드

> Didit의 AML 경고 코드(POSSIBLE_MATCH_FOUND, COULD_NOT_PERFORM_AML_SCREENING)를 확인하세요. KYC 데이터 누락 시 임계값 및 재실행 동작을 구성할 수 있습니다.

## 개요

AML 스크리닝은 `aml_screenings[]`의 각 항목에 있는 `warnings[]` 배열에 소수의 경고 태그를 생성합니다. 아래의 두 태그는 Didit이 생성하는 **유일한** AML 경고입니다. 일치 항목에서 확인되는 다른 모든 정보는 경고가 아닌 해당 항목 자체의 필드(`risk_view`, `match_score`, `risk_score`, `sanction_matches[]` 등)에 인코딩됩니다. 워크플로 세션과 독립형 AML API 모두 동일한 방식으로 `POSSIBLE_MATCH_FOUND`를 생성합니다.

AML 레코드에 반환되는 상태(`Approved`, `In Review`, `Declined`)는 종합 `score` 및 설정한 임계값에서 도출되며, 경고는 동일한 조건에 태그를 지정하여 프로그래밍 방식으로 대응할 수 있도록 합니다. 임계값이 상태에 매핑되는 방식은 [AML 위험 점수](https://docs.didit.me/ko/core-technology/aml-screening/aml-risk-score.md)를 참조하십시오.

## 생성되는 경고

| 위험 | 원인 | `log_type` | 상태 영향 | 권장 해결 조치 |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | 종합 `score`가 0이 아니며 `aml_score_approve_threshold`(기본값 `80`)를 초과합니다. 즉, 하나 이상의 일치 가능 항목이 위험 구간을 넘어섰습니다. (독립형 AML API에서는 점수가 임계값과 정확히 같을 때도 생성됩니다.) | `warning`. 점수가 `aml_score_review_threshold`(기본값 `100`)도 초과하면 `error`로 격상됩니다. | 점수가 승인 임계값을 초과하면 `In Review`, 검토 임계값을 초과하면 `Declined`가 됩니다. | `hits[]`의 각 일치 항목을 검토합니다. AML 적중 항목 상태 endpoint를 사용하여 일치 항목을 `Confirmed Match`, `False Positive` 또는 `Inconclusive`로 표시합니다. 일치 항목 업데이트는 `data.updated` webhook을 트리거하지만 AML 상태를 재계산하지는 않습니다. AML 상태 endpoint 또는 콘솔 검토를 통해 최종 상태를 설정하십시오. |
| `COULD_NOT_PERFORM_AML_SCREENING` | KYC 레코드에 `full_name`, `date_of_birth`, `issuing_state` 중 하나 이상이 누락되었습니다. 과금 대상 스크리닝 호출은 수행되지 않습니다. | `warning` | 강제로 `In Review`가 됩니다. | KYC 레코드의 누락된 필드를 채웁니다. 세 가지 항목이 모두 입력되면 AML이 자동으로 다시 실행되며, 이전 경고 로그가 제거되고 수동으로 다시 트리거할 필요가 없습니다. |

경고는 `feature: "AML"`과 함께 저장되며 표준 [경고 객체](https://docs.didit.me/ko/reference/data-models.md#경고-객체) 형태를 따릅니다.

## 구성 가능한 설정

워크플로 노드별 AML 제어 옵션(독립형 AML API에서도 옵션으로 허용됨):

* **`aml_score_approve_threshold`** — 기본값 `80`. 이 값을 초과하는 0이 아닌 점수는 `POSSIBLE_MATCH_FOUND`를 생성하고 AML 확인을 `In Review`로 라우팅합니다. 세션 워크플로에서는 일치 항목 수와 관계없이 이 값 이하의 점수에 대해 경고를 생성하지 **않습니다**.
* **`aml_score_review_threshold`** — 기본값 `100`. 이 값을 초과하는 점수는 AML 확인을 자동으로 거부합니다(기본값이 `100`인 경우 값을 낮추지 않는 한 트리거되지 않음).
* **`aml_match_score_threshold`** — 기본값 `93`. 일치 항목별 분류 기준: `match_score`가 이 값 미만인 일치 항목은 `False Positive`로 시작하여 종합 점수에서 제외되며, 이 값 이상인 항목은 `Unreviewed`로 시작합니다.
* **일치 점수 가중치** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, 기본값 `60` / `25` / `15`(합계는 반드시 100이어야 함). [AML 일치 점수](https://docs.didit.me/ko/core-technology/aml-screening/aml-match-score.md)를 참조하십시오.
* **지속적인 모니터링** — 활성화하면 데이터셋이 변경될 때 AML이 대상을 다시 스크리닝하고 보고서를 다시 전송하며 `status.updated`(상태 변경 시) 또는 `data.updated`(일치 항목 변경 시) webhook을 전송합니다.

> [!NOTE]
>
> `COULD_NOT_PERFORM_AML_SCREENING`이 발생하면 누락된 신원 필드가 제공될 때까지 AML 확인이 `In Review` 상태로 유지됩니다. Didit이 성명, 생년월일 및 발급 주/지역을 확보하면 AML이 자동으로 다시 실행되고 경고가 해제되므로 수동으로 다시 트리거할 필요가 없습니다.

## 예시

### `POSSIBLE_MATCH_FOUND`(승인 임계값을 초과하는 점수)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}
```

### `COULD_NOT_PERFORM_AML_SCREENING`(KYC 필드 누락)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}
```

## 관련 항목

* [AML 보고서](https://docs.didit.me/ko/core-technology/aml-screening/report-aml-screening.md) — 전체 응답 형태, 일치 항목 필드, 상태 의미
* [AML 위험 점수](https://docs.didit.me/ko/core-technology/aml-screening/aml-risk-score.md) — 종합 점수 계산 방식
* [AML 일치 점수](https://docs.didit.me/ko/core-technology/aml-screening/aml-match-score.md) — 일치 항목별 신뢰도
* [지속적인 AML 모니터링](https://docs.didit.me/ko/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — 모니터링 수명 주기
* [데이터 모델 — AML 스크리닝](https://docs.didit.me/ko/reference/data-models.md#aml-스크리닝) — [경고 객체](https://docs.didit.me/ko/reference/data-models.md#경고-객체)를 포함한 표준 스키마

### 경고 유형


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