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

# Peringatan Skrining AML & Kode Alert

> Pahami kode peringatan skrining AML Didit seperti POSSIBLE_MATCH_FOUND, atur ambang batas, dan tindakan saat data KYC tidak lengkap.

## Gambaran umum

Skrining AML menghasilkan sejumlah kecil tag peringatan pada larik `warnings[]` di setiap entri dalam `aml_screenings[]`. Dua tag di bawah ini adalah **satu-satunya** peringatan AML yang dihasilkan Didit — semua hal lain yang Anda lihat pada kecocokan (hit) dikodekan dalam kolom milik hit itu sendiri (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) alih-alih sebagai peringatan. Baik sesi alur kerja maupun API AML mandiri menghasilkan `POSSIBLE_MATCH_FOUND` dengan cara yang sama.

Status yang dikembalikan pada rekaman AML (`Approved`, `In Review`, `Declined`) diturunkan dari `score` agregat dan ambang batas Anda — peringatan menandai kondisi yang sama sehingga Anda dapat meresponsnya secara terprogram. Lihat [Skor risiko AML](https://docs.didit.me/id/core-technology/aml-screening/aml-risk-score.md) untuk mengetahui bagaimana ambang batas dipetakan ke status.

## Peringatan yang dihasilkan

| Risiko | Penyebab | `log_type` | Memengaruhi status | Remediasi yang disarankan |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | `score` agregat bernilai bukan nol dan berada di atas `aml_score_approve_threshold` (default `80`) — setidaknya satu hit kemungkinan kecocokan melewati rentang risiko Anda. (API AML mandiri juga menghasilkannya saat skor sama persis dengan ambang batas.) | `warning`; dieskalasi ke `error` jika skor juga melebihi `aml_score_review_threshold` (default `100`). | `In Review` saat skor berada di atas ambang batas persetujuan; `Declined` saat skor berada di atas ambang batas peninjauan. | Tinjau setiap hit di `hits[]`. Gunakan endpoint status hit AML untuk menandai hit sebagai `Confirmed Match`, `False Positive`, atau `Inconclusive`. Pembaruan hit akan memicu webhook `data.updated` tetapi tidak menghitung ulang status AML — tetapkan status akhir melalui endpoint status AML atau peninjauan konsol. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Satu atau beberapa kolom `full_name`, `date_of_birth`, atau `issuing_state` tidak ada pada rekaman KYC. Tidak ada panggilan skrining berbayar yang dilakukan. | `warning` | Memaksa status `In Review`. | Isi kolom yang hilang pada rekaman KYC. AML akan dijalankan ulang secara otomatis setelah ketiganya tersedia — log peringatan lama akan dihapus dan tidak diperlukan pemicuan ulang manual. |

Peringatan disimpan dengan `feature: "AML"` dan mengikuti bentuk [objek peringatan](https://docs.didit.me/id/reference/data-models.md#objek-peringatan) standar.

## Pengaturan yang dapat dikonfigurasi

Kontrol AML per node alur kerja (juga diterima sebagai opsi pada API AML mandiri):

* **`aml_score_approve_threshold`** — default `80`. Skor bukan nol di atasnya menghasilkan `POSSIBLE_MATCH_FOUND` dan mengarahkan pemeriksaan AML ke `In Review`. Skor pada atau di bawahnya **tidak** menghasilkan peringatan dalam alur kerja sesi, berapa pun jumlah hit-nya.
* **`aml_score_review_threshold`** — default `100`. Skor di atasnya secara otomatis menolak pemeriksaan AML (dengan nilai default `100`, ini tidak pernah terpicu sampai Anda menurunkannya).
* **`aml_match_score_threshold`** — default `93`. Klasifikasi per-hit: hit dengan `match_score` di bawah nilai ini berstatus awal `False Positive` dan dikecualikan dari skor agregat; pada atau di atas nilai ini berstatus awal `Unreviewed`.
* **Bobot skor kecocokan** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, default `60` / `25` / `15` (total harus berjumlah 100). Lihat [Skor kecocokan AML](https://docs.didit.me/id/core-technology/aml-screening/aml-match-score.md).
* **Pemantauan AML Berkelanjutan** — saat diaktifkan, AML melakukan skrining ulang terhadap subjek saat set data berubah dan mengirimkan ulang laporan ditambah webhook `status.updated` (status berubah) atau `data.updated` (hit berubah).

> [!NOTE]
>
> Saat `COULD_NOT_PERFORM_AML_SCREENING` terpicu, pemeriksaan AML tetap berada di `In Review` sampai kolom identitas yang hilang dilengkapi. Begitu Didit menerima nama lengkap, tanggal lahir, dan negara bagian penerbit, AML akan dijalankan ulang secara otomatis dan peringatan akan dihapus — tidak diperlukan pemicuan ulang manual.

## Contoh

### `POSSIBLE_MATCH_FOUND` (skor di atas ambang batas persetujuan)

```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` (kolom KYC tidak lengkap)

```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"
    }
  ]
}
```

## Terkait

* [Laporan AML](https://docs.didit.me/id/core-technology/aml-screening/report-aml-screening.md) — bentuk respons lengkap, kolom hit, semantik status
* [Skor risiko AML](https://docs.didit.me/id/core-technology/aml-screening/aml-risk-score.md) — cara penghitungan skor agregat
* [Skor kecocokan AML](https://docs.didit.me/id/core-technology/aml-screening/aml-match-score.md) — keyakinan per-hit
* [Pemantauan AML Berkelanjutan](https://docs.didit.me/id/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — siklus hidup pemantauan
* [Model data — Skrining AML](https://docs.didit.me/id/reference/data-models.md#skrining-aml) — skema kanonikal, termasuk [Objek peringatan](https://docs.didit.me/id/reference/data-models.md#objek-peringatan)

### Jenis peringatan


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