Langsung ke konten utama
POST
curl

Ikhtisar

Mengaktifkan atau menonaktifkan pemantauan AML berkelanjutan untuk entitas bisnis 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 bisnis yang dipilih, berapa yang memerlukan skrining AML baru, biaya skrining sekali bayar, dan biaya pemantauan tahunan. Uji coba tidak menulis apa pun. Estimasi menggunakan nama kolom yang sama dengan endpoint pengguna, jadi users_total adalah jumlah bisnis yang dipilih.

Cara pemilihan diproses

  • Satu skrining yang dipantau per bisnis. Perusahaan yang telah diverifikasi beberapa kali dipantau dan ditagih satu kali. Menonaktifkan pemantauan akan mematikan pemantauan di semua skrining milik bisnis tersebut.
  • Bisnis tanpa skrining AML akan diskrining terlebih dahulu. Didit membuat verifikasi AML baru untuk bisnis tersebut (dapat dilihat di tab Verifikasi bisnis), ditagih sebagai skrining AML biasa, dan mengaktifkan pemantauan padanya. Skrining menggunakan nama legal bisnis (atau nama tampilan) dan negaranya. Bisnis yang tidak memiliki nama sama sekali dilaporkan sebagai skipped_no_identity_data dan tidak dihilangkan secara diam-diam.
  • 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 sehingga Anda tahu berapa jumlah yang perlu diisi saldo.
  • Perpanjangan tahunan. Bisnis yang baru dipantau ditagih harga pemantauan tahunan pada tanggal perpanjangan berikutnya, yaitu tanggal yang ditampilkan Console di kolom Pemantauan berkelanjutan. Menonaktifkan pemantauan akan menghentikan perpanjangan; tidak ada pengembalian dana untuk periode yang sudah ditagih.

Pemilihan dan ukuran batch

Pilih bisnis dengan vendor_data_list, didit_internal_id_list, atau keduanya; kedua daftar digabungkan dengan OR. Satu permintaan menerima paling banyak 1000 pengenal dari kedua daftar. Pengenal yang tidak cocok dengan bisnis mana pun di aplikasi Anda dikembalikan di unmatched persis seperti yang dikirim, dan tidak pernah menyebabkan permintaan gagal: pilihan yang tidak cocok dengan apa pun akan selesai sebagai tugas kosong (total: 0) dengan semua pengenal tercantum, sesuai dengan konvensi endpoint penghapusan batch.

Sinkron atau di latar belakang

Pilihan 20 bisnis atau kurang diproses secara sinkron dan panggilan mengembalikan 200 beserta tugas yang sudah selesai. Pilihan yang lebih besar mengembalikan 202 dengan tugas PENDING; lakukan polling pada Dapatkan Tugas Pemantauan AML hingga status berubah menjadi COMPLETED atau FAILED. Dalam kedua kasus, tugas memuat satu entri results untuk setiap bisnis beserta hasilnya di kolom outcome.

Webhook

Mengubah pemantauan tidak mengirimkan webhook tersendiri. Setelah pemantauan aktif, skrining ulang tetap mengirimkan event status.updated dan data.updated seperti yang dijelaskan di Pemantauan AML Berkelanjutan.

Izin

Setiap kunci API aktif milik aplikasi dapat memanggil endpoint ini. Kunci API Didit bersifat terbatas pada aplikasi, bukan berdasarkan peran: peran dan izin di Console menentukan apa yang dapat dilakukan seseorang di Console, dan aturan tersebut 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 bisnis 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 bisnis yang akan dialihkan statusnya, dicocokkan persis seperti yang dikirimkan.

didit_internal_id_list
string<uuid>[]

ID internal Didit dari bisnis 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