Langsung ke konten utama
PATCH
curl

Fungsi ini

Skrining AML menghasilkan daftar hit, yaitu kecocokan potensial dengan daftar sanksi, database PEP, daftar pantauan, dan media negatif. Setiap hit memiliki review_status (keputusannya) yang awalnya bernilai Unreviewed atau False Positive, bergantung pada skor kecocokan. Endpoint ini memungkinkan tim Anda (atau otomatisasi Anda) mencatat keputusan untuk setiap hit tanpa mengubah keputusan sesi secara keseluruhan. Temukan hit beserta ID-nya di keputusan sesi, yaitu array hits pada pemeriksaan AML. Di sana, id setiap hit adalah hit_id yang Anda kirimkan ke endpoint ini. Format id hit adalah hit_ diikuti 24 karakter heksadesimal, dan tetap sama saat subjek diskrining ulang. id hit dalam format sebelumnya masih diterima. Respons selalu menyebut hit dengan id terkini.

Status tinjauan

Keputusan peninjau dipertahankan selama skrining ulang pemantauan berkelanjutan. Hit yang Anda tandai False Positive tetap memiliki status tersebut saat penyedia melakukan skrining ulang terhadap entitas.

Perbarui satu hit

PATCH /v3/session/{sessionId}/update-aml-hit-status/
Untuk sesi dengan beberapa pemeriksaan AML (alur kerja graf), tambahkan ?node_id=feature_aml_1 ke URL atau sertakan "node_id" di isi permintaan untuk menargetkan pemeriksaan tertentu.

Perbarui banyak hit sekaligus

PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/ Kirimkan hit_updates, yaitu daftar pasangan { hit_id, review_status }. Operasi ini bersifat semua atau tidak sama sekali: jika ada hit_id yang tidak ditemukan, permintaan mengembalikan 404 dan tidak ada hit yang diubah.
Panggilan massal yang berhasil memicu satu webhook data.updated dan mencatat satu entri aktivitas yang mencakup semua perubahan.

Yang terjadi setelah pembaruan

  • Webhook: event data.updated dipicu pada sesi.
  • Jejak audit: perubahan dicatat pada jejak tinjauan sesi beserta pelakunya (kunci API atau pengguna), dan dapat dilihat di linimasa aktivitas konsol.
  • Status langkah AML keseluruhan tidak berubah: mengubah keputusan sebuah hit tidak dengan sendirinya mengubah status langkah AML atau keputusan sesi. Untuk mengubah status langkah AML (Approved / Declined / In Review), gunakan update-feature-status. Untuk mengubah keputusan sesi, gunakan update-status.

Dukungan KYC dan KYB

Endpoint ini berlaku untuk sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Didit menemukan sessionId di kedua jenis sesi tersebut. Untuk KYB, skrining AML dijalankan pada perusahaan dan pihak kunci, dan setiap pemeriksaan AML menampilkan hit masing-masing.

Izin

Memerlukan izin write:sessions, dengan kunci API klien (x-api-key) atau header otorisasi pengguna.

Kesalahan

Terkait

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

sessionId
string<uuid>
wajib

UUID sesi verifikasi. Menerima ID sesi pengguna (KYC) dan bisnis (KYB) — layanan mencari ID tersebut di kedua jenis sesi.

Contoh:

"11111111-2222-3333-4444-555555555555"

Parameter Query

node_id
string

ID node graf alur kerja. Hanya diperlukan jika sesi memiliki beberapa pemeriksaan AML (satu per node); abaikan untuk sesi dengan AML tunggal.

Contoh:

"feature_aml_1"

Body

application/json
hit_id
string
wajib

id dari hit dalam array hits pemeriksaan AML (hit_...). ID hit yang dikembalikan dalam format sebelumnya masih diterima.

Contoh:

"hit_7c1e9a40b2d35f86e0a4c912"

review_status
enum<string>
wajib

Status peninjauan baru untuk temuan tersebut.

Opsi yang tersedia:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Contoh:

"False Positive"

node_id
string

ID node graf opsional. Gunakan ID ini (di sini atau sebagai parameter kueri) saat sesi memiliki beberapa pemeriksaan AML.

Contoh:

"feature_aml_1"

Respons

Status peninjauan hit diperbarui.

message
string
wajib

Selalu Hit status updated successfully.

hit_id
string
wajib

id dari hit yang diperbarui, sebagaimana dikembalikan oleh keputusan sesi, juga saat permintaan menyebutkan hit berdasarkan id dalam format sebelumnya.

review_status
enum<string>
wajib

Status peninjauan yang sekarang disimpan pada hasil kecocokan.

Opsi yang tersedia:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Terakhir diubah pada 7 November 2026