Langsung ke konten utama
GET
curl
Payload di dalam request_body adalah yang dijelaskan dalam Webhooks, dan header-nya adalah yang dibahas dalam verifikasi tanda tangan. Untuk mengirim ulang pengiriman, gunakan Kirim ulang pengiriman webhook sesi.

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, pengguna (KYC) atau bisnis (KYB): session_id yang dikembalikan oleh POST /v3/session/. Server mencari ID tersebut di kedua jenis sesi.

Harus berupa UUID yang valid. Rute ini hanya cocok dengan UUID yang terbentuk dengan benar, sehingga nilai yang salah format akan ditolak oleh router URL sebelum kode aplikasi apa pun berjalan dan responsnya berupa halaman HTML 404, bukan envelope JSON {"detail": ...} yang ditunjukkan di bawah.

webhook_uuid
string<uuid>
wajib

UUID pengiriman: uuid dari entri yang dikembalikan oleh GET /v3/session/{sessionId}/webhooks/. Pengiriman ini harus dimiliki oleh sesi di path tersebut.

Respons

Pengiriman, beserta header dan body permintaannya.

Satu upaya pengiriman webhook yang dicatat untuk suatu sesi verifikasi, dengan header dan body permintaan yang persis dikirimkan oleh Didit.

uuid
string<uuid>
wajib

ID pengiriman. Gunakan sebagai {webhook_uuid} untuk mengambil atau mengirim ulang pengiriman ini.

session_id
string<uuid>
wajib

Sesi tempat pengiriman tersebut berada (sesi dalam jalur).

request_url
string<uri> | null
wajib

URL tujuan pengiriman.

response_status
integer | null
wajib

Status HTTP yang dikembalikan endpoint Anda. null saat pengiriman berada dalam antrean dan belum dicoba. Ketika tidak ada jawaban HTTP yang diterima, Didit mencatat statusnya sendiri: 504 ketika endpoint Anda tidak menjawab dalam 5 detik, 503 untuk kegagalan koneksi, 400 ketika URL ditolak karena tidak aman (misalnya alamat privat atau internal), dan 404 untuk kesalahan permintaan lainnya. 400 ke atas dihitung sebagai pengiriman gagal.

status
string | null
wajib

Status sesi saat event dibuat, misalnya In Progress, Approved, atau Declined.

webhook_type
enum<string>
wajib

Nama event webhook yang didukung. Gunakan string persis ini di subscribed_events; nilai yang tidak didukung akan ditolak.

Opsi yang tersedia:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
request_header
string
wajib

Teks JSON (string) dari header permintaan yang dikirim Didit: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp, dan User-Agent. Parse teks ini dengan parser JSON. Teks ini memuat tanda tangan, tidak pernah rahasia penandatanganan.

request_body
string
wajib

Teks JSON (string) dari payload persis yang dikirim Didit, kunci diurutkan, termasuk event_id dan timestamp. Parse teks ini dengan parser JSON; lihat Bentuk payload. Untuk kunci dengan cakupan tanpa media: read, URL media di dalamnya bernilai null; tanpa sessions: write, token sesi dan tautan verifikasi yang di-hosting bernilai null. Body yang diubah dengan cara tersebut tidak lagi cocok dengan tanda tangannya. Didit tidak merekam body respons yang dikembalikan endpoint Anda.

created_at
string<date-time>
wajib

Waktu ketika pengiriman dibuat.

Terakhir diubah pada 7 November 2026