> ## 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 스크리닝 API: 제재 및 정치적 주요 인물(PEP)

> Didit으로 1,300개 이상의 글로벌 제재, PEP 및 감시 목록 데이터베이스에서 사용자를 실시간 검사하세요. 약정 없이 호출당 $0.20, 이중 점수 위험 시스템을 제공합니다.

Didit AML 스크리닝은 1,300+개의 글로벌 제재, PEP, 감시 목록 출처 및 부정적 언론 보도를 대상으로 인물을 실시간으로 확인하며, 모든 잠재적 일치 항목을 두 가지 점수와 함께 반환합니다. 일치 항목이 동일 인물일 가능성을 나타내는 일치 점수와 등재된 엔티티가 얼마나 위험한지를 나타내는 위험 점수입니다.

AML 스크리닝 연동 프롬프트
        프롬프트를 클립보드에 복사



      
      

\<pre>

\````# Goal
Integrate Didit AML Screening (PEP, sanctions, warnings, adverse media) into your app. Pick ONE mode.

\# Mode A — Session-based
Run AML as a step inside a verification session. Decisions, ongoing monitoring, and audit history are bound to the session and surfaced in the Business Console.

1\. Add the AML feature to the workflow (Business Console or POST /v3/workflows/). Configure thresholds: aml_match_score_threshold, aml_score_approve_threshold, aml_score_review_threshold, and the weights aml_name_weight + aml_dob_weight + aml_country_weight (must sum to 100).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `aml_screenings[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you want a one-shot AML check decoupled from a hosted KYC flow.

POST https://verification.didit.me/v3/aml/
x-api-key: YOUR_API_KEY
Content-Type: application/json

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/aml/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"full_name": "Javier Ejemplo Modelo",
"entity_type": "person",
"date_of_birth": "1974-01-01",
"nationality": "ES",
"include_adverse_media": true,
"vendor_data": "user-1234"
}'
\```
Returns: { request_id, aml: { status, screening_id, hits: [...], warnings: [...] } }.

\# Important policy rules
\- aml_name_weight + aml_dob_weight + aml_country_weight must equal exactly 100 — request rejected with HTTP 400 otherwise.
\- include_adverse_media=true increases latency to ~25s; use a client timeout of at least 45s.
\- include_ongoing_monitoring=true keeps the entity under daily re-screening at **$0.07 per year per screened entity** (billing alert) and requires save_api_request=true (HTTP 400 otherwise). Disable from the Business Console.

\# Status enum (per aml_screenings[].status / aml.status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.AML)
warnings[] risk codes include:
POSSIBLE_MATCH_FOUND, MATCH_FOUND, HIGH_RISK_COUNTRY, ADVERSE_MEDIA_HIT, SANCTIONED_ENTITY, PEP_MATCH, ONGOING_MONITORING_ENABLED.
Full catalogue: /core-technology/aml-screening/warnings-aml-screening.

\# Failure modes to handle
\- HTTP 400 — weights don't sum to 100; ongoing_monitoring without save_api_request.
\- HTTP 403 — out of credits.
\- status="Declined" — at least one hit's risk_score ≥ aml_score_review_threshold and crossed the decline boundary.
\- status="In Review" — risk_score between approve and review thresholds; route to manual queue.
\- Adverse-media timeout — the upstream provider was slow; the result returns without adverse-media hits (still actionable).

\# See also
\- Canonical schema: /reference/data-models#aml-screening
\- Per-feature report: /core-technology/aml-screening/report-aml-screening
\- Risk catalogue: /core-technology/aml-screening/warnings-aml-screening
\- Ongoing monitoring: /core-technology/aml-screening/continuous-monitoring-aml-screening
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

붙여넣을 곳

인증 결과 확인에 관한 Academy 강의 8:40부터 실제 세션에서의 제재, PEP, 부정적 언론 보도 등 AML 스크리닝을 다룹니다.[AML 스크리닝: 제재, PEP 및 부정적 언론 보도 — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=520\&rel=0\&playsinline=1)![OFAC, EU, UN 제재 및 PEP 목록을 포함한 Didit AML 스크리닝 감시 목록 소스 표](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-list-table.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b254abf5bb564018e15588ef7c56f92e)## 주요 개념: 일치 점수 vs 위험 점수Didit은 AML 스크리닝에 **2중 점수 시스템**을 사용합니다:### 일치 점수 (신원 신뢰도)- **질문:** 이 일치 항목이 스크리닝 중인 대상자와 동일 인물인가?
- **요소:** 이름 유사도, 생년월일, 국가/국적, 문서 번호
- **목적:** 일치 항목을 **오탐** 또는 **검토 안 됨**(일치 가능성 있음)으로 분류
- **임계값:** 일치 점수 임계값(기본값: 93)### 위험 점수 (엔티티 위험 수준)- **질문:** 실제 일치 항목인 경우 이 엔티티는 얼마나 위험한가?
- **요소:** 국가 위험도, 카테고리(PEP/제재 등), 범죄 기록
- **목적:** **최종 AML 상태**(승인됨/검토 중/거부됨) 결정
- **임계값:** 승인 임계값(기본값: 80) 및 검토 임계값(기본값: 100)```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           AML SCREENING FLOW                                │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  STEP 1: Screen against watchlists                                          │
│     └── Returns potential matches (match score ≥ 75% included)              │
│                                                                             │
│  STEP 2: For each match, calculate MATCH SCORE                              │
│     └── Match Score = (Name × W1) + (DOB × W2) + (Country × W3)             │
│                                                                             │
│  STEP 3: Classify match by match score                                      │
│     ├── Match Score < 93 → FALSE POSITIVE (excluded from risk)              │
│     └── Match Score ≥ 93 → UNREVIEWED (included in risk)                    │
│                                                                             │
│  STEP 4: For unreviewed matches, calculate RISK SCORE                       │
│     └── Risk Score = (Country × 30%) + (Category × 50%) + (Criminal × 20%)  │
│                                                                             │
│  STEP 5: Determine AML STATUS (highest risk score among non-FP matches)     │
│     ├── Risk Score < 86 → APPROVED                                          │
│     ├── 86 ≤ Risk Score ≤ 100 → IN REVIEW                                   │
│     └── Risk Score > 100 → DECLINED                                         │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
```## 일치 검토 상태각 AML 일치 항목에는 일치 점수를 기반으로 검토 상태가 할당됩니다:| 상태 | 설명 | 할당 시점 |
| - | - | - |
| **오탐** | 일치 항목이 동일 인물이 아닐 가능성이 높음 | 일치 점수 \< 임계값 (자동 할당) |
| **검토 안 됨** | 검토가 필요한 일치 가능 항목 | 일치 점수 ≥ 임계값 (자동 할당) |
| **확인된 일치** | 동일 인물임이 확인된 일치 항목 | 컴플라이언스 담당자가 수동으로 설정 |
| **결론 없음** | 일치 항목이 동일 인물인지 확인할 수 없음 | 컴플라이언스 담당자가 수동으로 설정 |> [!NOTE]
>
> ### **팁:** 콘솔에서 AML 개요를 확인하거나 특정 일치 항목을 클릭하여 세부 정보를 확인해 일치 검토 상태를 변경할 수 있습니다.## 주요 기능### 1. 종합적인 데이터 추출- **정확한 추출**: 고급 OCR 기술을 사용하여 사용자가 제공한 정보나 신분증 문서에서 데이터를 추출합니다.
- **퍼지 로직**: 이름 변형 및 철자 오류를 고려하여 데이터를 빠짐없이 수집합니다.### 2. 광범위한 감시 목록 적용 범위다음을 포함한 여러 범주를 대상으로 스크리닝합니다.- **제재 목록**: 정부 및 국제 기관의 목록입니다.
- **정치적 주요 인물(PEP)**: 주요 공직을 맡고 있는 개인입니다.
- **범죄 기록**: 글로벌 및 현지 범죄 데이터베이스를 포함합니다.
- **부정적 언론 보도**: 금융 범죄 및 기타 위험에 관한 뉴스 기사 및 보도입니다.
- **맞춤형 감시 목록**: 고객의 특정 요구 사항에 따라 구성할 수 있습니다.### 3. 고급 일치 알고리즘- **퍼지 매칭**: 이름이나 세부 정보의 미세한 변형을 포착하여 정확한 일치를 보장합니다.
- **다양한 데이터 요소**: 철저한 스크리닝을 위해 성명, 생년월일, 국적 및 기타 식별자를 활용합니다.
- **골든 키 로직**: 확실한 식별을 위해 점수보다 우선 적용될 수 있는 문서 번호 매칭입니다.### 4. 2개 점수 기반 위험 평가각 일치 항목은 두 가지 점수를 받습니다.| 점수 | 목적 | 분류 |
| - | - | - |
| **일치 점수** (0-100) | 동일 인물인가? | 오탐 vs 미검토 |
| **위험 점수** (0-100) | 이 대상이 얼마나 위험한가? | 최종 AML 상태 결정 |**일치 검토 상태 (일치 점수 기준):**- **오탐**: 일치 점수가 임계값 미만 - 동일 인물이 아닐 가능성이 높음
- **미검토**: 일치 점수가 임계값 이상 - 검토 필요**최종 AML 상태 (오탐이 아닌 일치 항목 중 가장 높은 위험 점수 기준):**- **승인됨**: 미검토 상태의 모든 일치 항목의 위험 점수가 낮음
- **검토 중**: 미검토 상태의 일치 항목 중 하나 이상의 위험 점수가 중간 또는 높음
- **거부됨**: 미검토 상태의 일치 항목 중 하나 이상의 위험 점수가 매우 높음### 5. 상세한 부정적 언론 보도 스크리닝다음을 포함한 광범위한 부정적 언론 보도 범주를 대상으로 스크리닝합니다.- **금융 범죄**: 자금 세탁, 횡령 등.
- **폭력 범죄**: 폭행, 살인 및 관련 범죄.
- **테러**: 테러 활동 가담 또는 지원.
- **마약**: 마약 밀매 및 관련 범죄.
- **사기**: 다양한 유형의 사기 및 기만 행위.
- **규제 위반**: 규제 준수 요건 위반.### 6. 맞춤형 스크리닝 파라미터- **민감도 조정**: 조직의 위험 감수 성향에 따라 스크리닝 민감도를 구성합니다.
- **맞춤형 감시 목록**: 특정 요구 사항을 충족하기 위해 스크리닝 프로세스에 포함할 감시 목록과 범주를 선택합니다.### 구성 가능한 임계값다양한 임계값을 설정하여 보안 수준을 맞춤 조정할 수 있습니다.**일치 점수 구성:**| 설정 | 기본값 | 설명 |
| - | - | - |
| 일치 점수 임계값 | 93 | 이 값 미만의 일치 항목은 오탐, 이상은 미검토로 분류됩니다 |
| 성명 가중치 | 60 | 일치 점수에서 성명에 대한 가중치 |
| 생년월일 가중치 | 25 | 일치 점수에서 생년월일에 대한 가중치 |
| 국가 가중치 | 15 | 일치 점수에서 국가에 대한 가중치 |**위험 점수 임계값 (최종 상태):**| 설정 | 기본값 | 설명 |
| - | - | - |
| 승인 임계값 | 80 | 위험 점수가 이 값 미만이면 승인됨 |
| 검토 임계값 | 100 | 위험 점수가 이 값을 초과하면 거부됨이며, 두 임계값 사이면 검토 중으로 분류됨 |![승인됨, 검토 중 및 거부됨 상태에 대한 Didit AML 위험 점수 임계값](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-risk-score.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=297acc5d98dcd0f038597c4f2d953f46)> [!NOTE]
>
> 이러한 임계값은 조직의 위험 허용 범위와 보안 요구 사항에 따라 조정할 수 있습니다.## 작동 방식AML 스크리닝 프로세스는 정상적인 사용자의 대기 시간을 최소화하면서 잠재적 위험을 효율적으로 식별합니다.**1. 데이터 추출**시스템은 사용자가 제공한 데이터 또는 업로드된 신분증 서류에서 관련 정보를 추출합니다.| 입력 | 방식 |
| - | - |
| **신분증 서류** | 정확한 데이터 추출을 위한 고급 OCR 기술 |
| **사용자 제공 데이터** | 직접 입력(성명, 생년월일, 국적, 문서 번호) |
| **퍼지 로직** | 이름 변형 및 오탈자 고려 |**2. 감시 목록 스크리닝**추출된 데이터를 **1,300+개 글로벌 감시 목록** 및 데이터베이스와 실시간으로 교차 검증합니다:- **제재 목록** — 정부 및 국제기구(OFAC, EU, UN 등)
- **정치적 주요 인물(PEP)** — 주요 공적 역할을 맡은 개인
- **범죄 기록** — 글로벌 및 로컬 범죄 데이터베이스
- **부정적 언론 보도** — 금융 범죄 관련 뉴스 기사 및 보고서
- **맞춤형 감시 목록** — 요구사항에 맞게 구성 가능**3. 일치 점수 계산**잠재적 일치 건마다 시스템이 **신원 신뢰도 점수**(동일인일 확률)를 계산합니다.| 요소 | 기본 가중치 | 설명 |
| - | :-: | - |
| **이름 유사도** | 60% | 변형을 고려한 퍼지 매칭 |
| **생년월일** | 25% | 생년월일의 정확한 일치 여부 또는 부분 비교 |
| **국가/국적** | 15% | 출신 국가 비교 |- 일치 점수 **임계값 미만**(기본값: 93) → **오탐**으로 분류
- 일치 점수 **임계값 이상** → **미검토**(일치 가능성 있음)로 분류
- **골든 키**: 확실한 식별을 위해 문서 번호 일치 시 100%로 덮어쓸 수 있음**4. 위험 점수 계산**오탐이 아닌 일치 건에 대해 시스템이 해당 주체의 **위험 수준**을 계산합니다:| 요소 | 가중치 | 설명 |
| - | :-: | - |
| **카테고리** | 50% | PEP 등급, 제재 유형, 범죄 심각도 |
| **국가 위험** | 30% | 연관 국가의 위험 등급 |
| **범죄 기록** | 20% | 범죄 이력 유무 및 심각도 |**5. 최종 상태 결정**오탐이 아닌 모든 일치 건 중 **가장 높은 위험 점수**를 기준으로 결정합니다:| 위험 점수 | 상태 | 작업 |
| :-: | - | - |
| 승인 임계값 미만 | **승인됨** | 자동 통과, 신뢰할 만한 위험 없음 |
| 임계값 사이 | **검토 중** | 수동 컴플라이언스 검토 대상 지정 |
| 검토 임계값 초과 | **거부됨** | 고위험, 자동 거부 |**전체** 일치 건이 오탐인 경우, 결과는 **승인됨**(신뢰할 만한 일치 항목 없음)입니다.**6. 결과 생성**완전한 투명성을 갖춘 상세 보고서가 생성됩니다:- 각 일치 항목의 세부 내역이 포함된 **일치 점수** 및 **위험 점수**
- 일치 분류(오탐 vs. 미검토 vs. 확인됨)
- 적발된 모든 건에 대한 소스 데이터베이스 및 카테고리 세부정보
- **API 응답**, **webhook** 또는 **Business Console**을 통한 결과 전송
- 설정된 위험 점수 임계값에 기반한 자동 결정## AML 일치 데이터 레퍼런스API 응답으로 반환되는 각 AML 일치 항목에는 일치하는 개체에 대한 상세 정보가 포함되어 있습니다. 아래는 주요 필드와 해당 필드의 사용 가능한 값입니다.### 데이터셋 카테고리각 일치 항목의 `datasets` 필드는 해당 개체가 어떤 컴플라이언스 데이터베이스 카테고리에서 발견되었는지를 나타냅니다. 가능한 값은 다음과 같습니다.| 값 | 설명 |
| - | - |
| `PEP` | 정치적 주요 인물(PEP, 일반) |
| `PEP Level 1` | 국가 원수, 고위 정치인, 대법관 |
| `PEP Level 2` | 국회의원, 대사, 군 고위 간부 |
| `PEP Level 3` | 지방 정부 공무원, 중간 직급 공무원 |
| `PEP Level 4` | PEP 개인의 친척 및 밀접한 관계자(RCA) |
| `Sanctions` | 국제 및 국가 제재 목록 (OFAC, EU, UN 등) |
| `Adverse Media` | 금융 범죄 관련 부정적 언론 보도 기사 및 보고서 |
| `Warnings and Regulatory Enforcement` | 규제 경고, 집행 조치 및 컴플라이언스 알림 |
| `Fitness and Probity` | 금융 규제 당국의 적격성 및 청렴성 등록부 |
| `SIP` | 특별 관심 인물(SIP) 목록 |
| `SIE` | 특별 관심 단체(SIE) 목록 |
| `Insolvency` | 지급 불능 및 파산 등록부 |### 제재 일치 항목`sanction_matches` 배열에는 개체가 발견된 각 제재 목록에 대한 세부 정보가 포함되어 있습니다. 주요 필드는 다음과 같습니다.| 필드 | 유형 | 설명 |
| - | - | - |
| `list_name` | `string[]` | 제재 목록 이름 |
| `matched_name` | `string` | 제재 목록에 표시된 이름 |
| `description` | `string` | 제재 항목에 대한 설명 |
| `reason` | `string` | 개체가 제재를 받은 자유 형식 텍스트로 된 사유입니다. 이는 열거형(enum)이 아니며, 제재 당국에서 직접 제공되어 등재의 구체적인 근거를 설명합니다(예: "Executive Order 13224 (Terrorism)", "Support for actions undermining Ukraine's sovereignty"). |
| `legal_basis` | `string[]` | 제재의 법적 근거 |
| `sanction_program` | `string[]` | 개체가 등재된 제재 프로그램 |
| `sanctioning_authority` | `string[]` | 제재를 부과한 당국 |
| `listed_on` | `string[]` | 개체가 등재된 날짜 |
| `source_url` | `string` | 출처 URL |### 경고 일치 항목`warning_matches` 배열에는 경고, 규제 집행 및 관련 목록의 일치 세부 정보가 포함되어 있습니다. `additional_data` 필드에는 구조화된 케이스 정보가 포함된 `data.case_details` 배열이 포함될 수 있습니다.#### 경고 케이스 유형`additional_data.data.case_details[]` 내의 `case_type` 필드는 경고 케이스의 성격을 설명합니다. 알려진 값은 다음과 같습니다.| 값 | 설명 |
| - | - |
| `Accusation` | 공식 고발 또는 혐의 |
| `Arrest` | 체포 기록 |
| `Bribery` | 뇌물 관련 케이스 |
| `Criminal` | 일반 형사 케이스 |
| `Fraud` | 사기 관련 케이스 |
| `Illegal Fundraising` | 불법 자금 조달 활동 |
| `Non-conviction Terror` | 유죄 판결 없는 테러 관련 등재 |
| `Proclaimed Offender` | 공식적으로 공표된 범죄자 |
| `Regulatory Enforcement` | 규제 집행 조치 |
| `Terrorism` | 테러 관련 케이스 |
| `Terrorism-related` | 테러 활동 관련 |
| `Terrorism-related listing` | 테러와 관련하여 등재됨 |


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