Langsung ke konten utama
POST
Python
Kirim identifier yang diketik dan atribut identitas yang diklaim, pilih pemeriksaan yang akan dijalankan, lalu periksa setiap hasil secara terpisah. Gunakan Rencanakan Pemeriksaan Penipuan terlebih dahulu untuk memeriksa persyaratan input dan perkiraan biaya.

Pilih profil

Kunci profile_version agar default yang dipilih dan kebijakan keputusan terlihat jelas. Profil default adalah standard, versi 2026-08-27. Versi 2026-09-14 menambahkan pengayaan sosial email dan nomor telepon yang bersifat opsional, serta mencatat setiap pemeriksaan yang selesai sebagai sesi Verifikasi Pengguna bawaan. Pada versi tersebut, add-on berbayar bersifat opt-in. Versi 2026-09-14.1 juga mengaktifkan pencarian identifier jaringan penipuan global untuk organisasi di paket Enterprise yang berbagi secara global. Versi 2026-09-14.2 menambahkan pemeriksaan referensi opsional dari swafoto ke CPF untuk Brasil. Versi sebelumnya tetap mempertahankan perilaku aslinya. Profil yang berlaku saat ini mendukung risiko email, risiko nomor telepon, risiko IP, Validasi Database yang memenuhi syarat, dan riwayat jaringan privat aplikasi Anda. Pengikatan identitas berbasis swafoto memerlukan versi 2026-09-14.2. Jika dipilih pada versi sebelumnya, respons akan mengembalikan not_available_in_profile_version.

Klaim identitas dan konteks

Letakkan email, nomor telepon, dan pengidentifikasi pemerintah di subject.identifiers. Pengidentifikasi pemerintah memerlukan negara penerbitnya; penerbit mungkin juga diperlukan jika nomornya hanya unik dalam suatu wilayah. Letakkan nama, tanggal lahir, kewarganegaraan, dan alamat di subject.attributes. Data ini adalah klaim untuk dibandingkan jika sumber yang dipilih mendukungnya, bukan fakta terverifikasi hanya karena data tersebut dikirim. Gunakan context untuk alamat IP, user agent, tujuan, negara, dan pernyataan persetujuan yang diperlukan dari upaya verifikasi. Ini memisahkan informasi tentang upaya verifikasi dari informasi tentang orang tersebut. Untuk pemeriksaan biometrik yang didukung, berikan subject.selfie sebagai JPEG, PNG, atau WebP yang dienkode base64, hingga 6 MB. Data URI gambar yang sesuai juga diterima. Jangan kirim gambar referensi, URL jarak jauh, atau kunci penyimpanan.

Swafoto dan pengidentifikasi yang diklaim

Pilih biometric_identity, kirim identifier tax_number Brasil dan swafoto, lalu pastikan context.consent_obtained. Pemeriksaan referensi memeriksa apakah swafoto tersebut milik pemegang CPF yang diklaim. Jika persetujuan tidak ada, respons akan mengembalikan consent_required, dan jika negaranya tidak didukung, respons akan mengembalikan unsupported_region. Modul ini memiliki harga per pemeriksaan yang didasarkan pada tarif Validasi Database organisasi Anda; periksa paket Anda sebelum menjalankannya. Ketika referensi memberikan jawaban, identity_relationship.result berupa match, mismatch, atau inconclusive. Jawaban inconclusive memerlukan peninjauan dan tidak pernah diperlakukan sebagai mismatch. Hasilnya hanya menetapkan hubungan antara swafoto dan CPF. Hasil ini tidak memvalidasi nama atau tanggal lahir yang dikirim, tidak membuktikan liveness, dan tidak mencari wajah di internet atau jaringan penipuan global. Nama dan tanggal lahir tetap berupa klaim kecuali sumber lain yang dipilih memberikan bukti untuk kolom tersebut. Timeout dan error sumber adalah hasil yang tidak tersedia dan tidak ditagih. Jawaban inconclusive yang telah selesai ditagih dengan tarif pemeriksaan referensi yang sama. Swafoto tidak disertakan dalam hasil dan tidak disimpan sebagai media sesi oleh pemeriksaan ini.

Pilih pemeriksaan

checks.include memilih modul, dan checks.exclude lebih diutamakan. Daftar include yang kosong secara eksplisit menonaktifkan semua pekerjaan opsional; normalisasi tetap berjalan. Jika include dihilangkan, digunakan default profil yang dikunci. Pengayaan sosial email dan nomor telepon dipilih secara terpisah dengan email_social dan phone_social. Keduanya memerlukan identifier yang valid dan cocok, dan tidak mengirim OTP.

Baca hasil tanpa mencampuradukkannya

Setiap modul melaporkan status eksekusi, alasan, dan unit yang dapat ditagih. not_requested, excluded_by_caller, missing_required_input, dan source_unavailable menggambarkan hasil yang berbeda. Sumber yang tidak tersedia bukan ketidakcocokan identitas maupun hasil risiko nol. attribute_evidence menggambarkan bukti tingkat kolom, sedangkan risk memisahkan dimensi identitas, kontak, perangkat, perilaku, dan jaringan penipuan. Email, perangkat, atau identifier lain yang sama adalah koneksi yang teramati, bukan bukti bahwa dua akun dimiliki oleh orang yang sama atau bahwa terjadi penipuan. recommendation adalah rekomendasi pemeriksaan tersebut; rekomendasi ini tidak mengubah status catatan lain. Hasil pengayaan sosial muncul di enrichment, dengan hasil yang tidak tersedia dibedakan dari hasil yang selesai.

Jaringan penipuan global

Pilih networks_cross_org untuk melakukan kueri terhadap identifier email, telepon, dan dokumen yang diberi namespace dengan benar yang didukung di jaringan bersama. Pencarian ini memerlukan paket Enterprise dan mode berbagi organisasi Anda diatur ke global. Tanpa keduanya, paket melaporkan modul dengan available: false dan availability_reason: "entitlement_required", dan pemeriksaan yang memilih modul ini melewatinya dengan status skipped dan alasan entitlement_required. Alasan yang sama berlaku jika Networks tidak diaktifkan untuk organisasi Anda. Aplikasi sandbox tidak dibatasi oleh paket atau mode berbagi: dengan identifier yang didukung, modul berjalan dan mengembalikan hasil sampel yang kosong. Pencarian menggunakan anggaran baca yang sudah ada milik organisasi dan mencatat log audit atas pembacaan tersebut. Tidak ada biaya per pencarian. Merencanakan pemeriksaan tidak melakukan kueri ke indeks bersama dan tidak menggunakan anggaran bacanya. network.cross_organization berisi signals_checked dan insights gabungan yang diungkapkan saat pemeriksaan selesai. Setiap insight berisi tipe sinyal, kelas hasil, jumlah kontributor, bucket kebaruan, dan kategori industri hanya jika pengungkapan diaktifkan. Data ini tidak pernah mengidentifikasi organisasi lain, akun, orang, atau verifikasi lain. Hasil di bawah ambang batas pengungkapan dihilangkan; daftar kosong tidak membuktikan tidak adanya riwayat penipuan. Sinyal bersama yang diungkapkan memicu rekomendasi peninjauan, bukan penolakan otomatis atau kecocokan identitas. Pencarian yang tidak tersedia melaporkan alasannya secara terpisah dari pencarian yang selesai tetapi kosong. Jika organisasi Anda kemudian kehilangan akses lintas-organisasi, misalnya setelah perubahan paket atau ketika berbagi tidak lagi global, pengambilan hasil, percobaan ulang, dan detail sesi menyembunyikan agregat bersama beserta bukti risiko turunannya. Rekomendasi asli tetap menjadi keputusan historis; pembacaan tidak mengubah status verifikasi.

Sesi, percobaan ulang, dan biaya

check_id mengambil hasil tersimpan melalui Dapatkan Fraud Check. Jika ada, request_id mengidentifikasi sesi verifikasi aslinya. Versi 2026-09-14, 2026-09-14.1, dan 2026-09-14.2 selalu membuat sesi tersebut, termasuk ketika hanya riwayat jaringan privat yang dipilih. Menggunakan kembali client_reference dengan isi permintaan yang sama mengembalikan hasil asli tanpa eksekusi atau biaya tambahan selama pemeriksaan tersebut masih ada. Isi berbeda dengan referensi yang sama mengembalikan 409. Jika eksekusi masih berjalan, coba lagi permintaan yang sama setelah interval Retry-After pada respons. Menghapus verifikasi terkait juga menghapus hasil Fraud Check; pengambilan selanjutnya mengembalikan 404. Pemeriksaan yang dihapus selama eksekusi tidak dapat menerbitkan hasil yang sudah selesai. Harga berasal dari tarif prabayar atau kontrak organisasi Anda yang berlaku saat ini. Modul yang tidak tersedia dan yang dilewati tidak ditagih, dan riwayat jaringan privat tidak dikenakan biaya per pemeriksaan. Pemeriksaan sandbox menggunakan respons sampel tanpa panggilan pemasok berbayar maupun biaya.

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

subject
object
wajib
client_reference
string

Referensi Anda sendiri untuk pemeriksaan ini. Berfungsi ganda sebagai kunci idempotensi: menggunakannya kembali dengan isi permintaan yang sama akan mengembalikan pemeriksaan asli tanpa menjalankan atau menagih modul lagi; menggunakannya kembali dengan isi permintaan yang berbeda akan mengembalikan 409.

Required string length: 1 - 255
profile
string
default:standard

ID profil orkestrasi. Default ke profil standard Didit.

Required string length: 1 - 64
profile_version
string

Sematkan versi profil yang dibekukan. Secara default menggunakan versi profil saat ini.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

Respons

check_id
string<uuid>
wajib
client_reference
string | null
wajib
processing_status
enum<string>
wajib
  • pending - Tertunda
  • running - Berjalan
  • completed - Selesai
  • failed - Gagal
Opsi yang tersedia:
pending,
running,
completed,
failed
profile_id
string
wajib
profile_version
string
wajib
created_at
string<date-time>
wajib
completed_at
string<date-time> | null
wajib
inputs
object[]
wajib
modules
object[]
wajib
attribute_evidence
object[]
wajib
compound_evidence
object[]
wajib
risk
object[]
wajib
network
object
wajib
recommendation
enum<string>
wajib
  • approve - Setujui
  • review - Tinjau
  • reject - Tolak
Opsi yang tersedia:
approve,
review,
reject
next_action
enum<string>
wajib
  • none - Tidak Ada
  • manual_review - Peninjauan Manual
  • step_up - Peningkatan Verifikasi
  • resubmit_capture - Kirim Ulang Pengambilan
Opsi yang tersedia:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
wajib
coverage
object
wajib
usage
object[]
wajib
request_id
string<uuid>

Sesi verifikasi native dibuat untuk pemeriksaan ini.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
Terakhir diubah pada 7 November 2026