Langsung ke konten utama
POST
curl

Ikhtisar

Mengaktifkan atau menonaktifkan pemantauan AML berkelanjutan untuk entitas Pengguna yang dipilih, persis seperti tindakan Pemantauan AML Berkelanjutan di Business Console. Console dan endpoint ini menjalankan operasi dasar yang sama, sehingga aturan, penagihan, dan hasilnya identik. Kirim estimate_only: true terlebih dahulu untuk melihat berapa banyak pengguna yang dipilih, berapa banyak yang memerlukan skrining AML baru, biaya skrining satu kali, dan biaya pemantauan tahunan. Simulasi tidak menulis apa pun.

Kapan digunakan

  • Onboarding terprogram: aktifkan pemantauan untuk pengguna yang Anda impor atau buat melalui API tanpa melakukan skrining ulang secara manual.
  • Offboarding: hentikan pemantauan, beserta perpanjangan tahunannya, untuk pengguna yang sudah meninggalkan platform Anda.
  • Kontrol biaya: lihat dampak biaya yang tepat dari suatu pilihan sebelum Anda memutuskannya.

Cara pemrosesan pilihan

  • Satu skrining terpantau per pengguna. Pengguna yang telah melakukan verifikasi beberapa kali dipantau dan ditagih satu kali. Menonaktifkan pemantauan berarti pemantauan dimatikan untuk semua skrining milik pengguna tersebut.
  • Pengguna tanpa skrining AML akan diskrining terlebih dahulu. Didit membuat verifikasi AML baru untuk mereka (terlihat di tab Verifikasi pengguna), ditagih sebagai skrining AML biasa, lalu mengaktifkan pemantauan pada skrining tersebut. Ini memerlukan nama lengkap, tanggal lahir, dan negara pengguna. Pengguna yang tidak memiliki salah satu data tersebut dilaporkan sebagai skipped_no_identity_data, bukan diabaikan secara diam-diam.
  • Pengguna yang diblokir dilewati (skipped_blocked). Aplikasi sandbox tidak pernah membuat skrining (skipped_sandbox).
  • Saldo diperiksa di awal. Pengaktifan ditolak dengan 403 jika saldo Anda tidak mencukupi estimasi, dan respons menyertakan estimasi tersebut agar Anda tahu berapa banyak yang perlu diisi saldo.
  • Perpanjangan tahunan. Pengguna yang baru dipantau dikenai biaya pemantauan tahunan pada tanggal perpanjangan berikutnya, yaitu tanggal yang ditampilkan Console di kolom Pemantauan berkelanjutan. Menonaktifkan pemantauan menghentikan perpanjangan; ini tidak mengembalikan dana untuk periode yang sudah ditagih.

Pemilihan dan ukuran batch

Pilih pengguna dengan vendor_data_list, didit_internal_id_list, atau keduanya; kedua daftar digabungkan dengan operator OR. Satu permintaan menerima paling banyak 1000 identifier dari kedua daftar. Identifier yang tidak cocok dengan pengguna mana pun di aplikasi Anda dikembalikan di unmatched, persis seperti yang Anda kirim, dan tidak pernah menggagalkan permintaan: pilihan yang tidak cocok dengan siapa pun akan selesai sebagai job kosong (total: 0) dengan semua identifier tercantum, sesuai konvensi endpoint penghapusan batch.

Inline atau di latar belakang

Pilihan 20 pengguna atau kurang diproses secara inline dan panggilan mengembalikan 200 dengan job yang sudah selesai. Pilihan yang lebih besar mengembalikan 202 dengan job PENDING; lakukan polling ke Get AML Monitoring Job hingga status menjadi COMPLETED atau FAILED. Dalam kedua kasus, job memuat satu entri results per pengguna beserta outcome-nya.

Webhook

Mengubah status pemantauan tidak mengirim webhook tersendiri. Setelah pemantauan aktif, skrining ulang tetap memicu event status.updated dan data.updated yang dijelaskan di Continuous AML Monitoring.

Izin

Kunci API aktif apa pun milik aplikasi dapat memanggil endpoint ini. Kunci API Didit terikat pada aplikasi, bukan pada peran: peran dan izin di Console menentukan apa yang dapat dilakukan seseorang di Console, dan itu tidak dievaluasi untuk lalu lintas Management API.

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.

Body

application/json

Pilih pengguna dengan vendor_data_list, didit_internal_id_list, atau keduanya (kedua daftar digabungkan dengan OR). Maksimal 1000 pengidentifikasi per permintaan di kedua daftar.

is_enabled
boolean
wajib

true untuk mengaktifkan pemantauan, false untuk menonaktifkannya.

estimate_only
boolean
default:false

Jika true, mengembalikan estimasi biaya dan tidak melakukan penulisan data - tanpa skrining, tanpa penagihan, tanpa membuat job.

vendor_data_list
string[]

Pengenal Anda sendiri untuk pengguna yang akan dialihkan statusnya, dicocokkan persis seperti yang dikirimkan.

didit_internal_id_list
string<uuid>[]

ID internal Didit dari pengguna yang akan dialihkan statusnya - didit_internal_id yang dikembalikan oleh endpoint pembuatan, pengambilan, dan daftar.

Respons

Estimasi (jika estimate_only bernilai true) atau pekerjaan yang telah selesai untuk pilihan yang diproses secara inline.

Pratinjau biaya. Dikembalikan secara langsung saat estimate_only bernilai true (tidak ada yang ditulis).

users_total
integer
wajib

Profil yang cocok dengan pilihan.

already_enabled
integer
wajib

Profil yang sudah dipantau (tidak ada tindakan saat mengaktifkan; ini adalah profil yang dimatikan saat dinonaktifkan).

with_existing_aml
integer
wajib

Profil yang skrining AML-nya yang sudah ada akan dialihkan ke dipantau (tanpa skrining baru).

needing_screening
integer
wajib

Profil tanpa skrining AML apa pun yang akan diskrining terlebih dahulu (ditagih sebagai skrining AML reguler).

skipped_no_identity_data
integer
wajib

Profil yang tidak dapat diskrining karena data identitas tidak tersedia.

skipped_blocked
integer
wajib

Pengguna terblokir yang akan dilewati (selalu 0 untuk bisnis).

estimated_screening_cost_usd
number
wajib

Biaya sekali bayar untuk skrining baru.

Contoh:

0.2

estimated_annual_monitoring_cost_usd
number
wajib

Biaya pemantauan tahunan dari profil yang akan dipantau.

Contoh:

0.07

balance_sufficient
boolean
wajib

Apakah saldo organisasi mencukupi untuk skrining ditambah tahun pertama pemantauan.

unmatched
string[]
wajib

Pengenal permintaan yang tidak cocok dengan profil apa pun di aplikasi ini, persis seperti yang dikirim.

Terakhir diubah pada 7 November 2026