Webhook Entitas Didit: Event Pengguna & Bisnis

Setiap perubahan pada status atau data profil entitas User atau Business mengirimkan webhook agar sistem Anda dapat merespons secara real time. Gunakan webhook entitas untuk menyinkronkan data profil, meneruskan pemblokiran ke sistem lain, atau memicu alur kepatuhan hilir.

Katalog event

Event	Pemicu
`user.status.updated`	Status entitas User berubah (`ACTIVE` ↔ `FLAGGED` ↔ `BLOCKED`)
`user.data.updated`	Kolom profil entitas User berubah (nama, tanggal lahir, foto, penghitung agregat, metadata)
`business.status.updated`	Status entitas Business berubah
`business.data.updated`	Kolom profil entitas Business berubah (nama legal, nomor registrasi, negara, penghitung)

activity.created diterima di subscribed_events dan tercakup oleh penguji Try Webhook, tetapi Didit saat ini tidak mengirimkannya untuk trafik produksi. Jangan membangun pencerminan linimasa berdasarkan event ini.

Didit juga mengirimkan event sesi, transaksi, dan sesi bisnis yang merujuk ke kolom entitas. Lihat:

Webhook KYB: event sesi bisnis
Webhook Pemantauan Transaksi: event transaksi
Referensi webhook: verifikasi tanda tangan, percobaan ulang, dan tujuan

Bentuk payload

Webhook entitas bersifat datar: tidak ada pembungkus data dan tidak ada kunci event. Baca webhook_type untuk merutekan event.

{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "user.status.updated",
  "timestamp": 1776333600,
  "created_at": 1776333594,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "BLOCKED",
  "previous_status": "ACTIVE"
}

Kolom	Deskripsi
`vendor_user_id` / `vendor_business_id`	Pengenal Didit untuk entitas. Event `business.*` menggunakan `vendor_business_id`.
`vendor_data`	Pengenal Anda untuk entitas.
`status`	`ACTIVE`, `FLAGGED` atau `BLOCKED`.
`previous_status`	Hanya pada `*.status.updated`.
`changed_fields` dan `changes`	Hanya pada `*.data.updated`.
`created_at`	Detik Unix saat entitas terakhir diperbarui.
`timestamp`	Detik Unix saat Didit mengirimkan webhook.

`user.status.updated` / `business.status.updated`

Dikirim pada setiap perubahan status. Payload memuat status dan previous_status. Payload tidak menjelaskan alasan perubahan status: buka entitas di konsol jika Anda memerlukan penyebabnya.

`user.data.updated` / `business.data.updated`

Dikirim ketika kolom profil berubah. changed_fields mencantumkan kolom yang berubah, dan changes berisi nilai previous dan current untuk setiap kolom.

{
  "event_id": "5d1e8f9a-0c32-4b6a-a7b6-2b9d6f0a3c41",
  "webhook_type": "user.data.updated",
  "timestamp": 1776333700,
  "created_at": 1776333694,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "ACTIVE",
  "changed_fields": ["full_name", "session_count"],
  "changes": {
    "full_name": { "previous": null, "current": "John Doe" },
    "session_count": { "previous": 2, "current": 3 }
  }
}

Kolom yang dapat muncul di changed_fields adalah:

User: vendor_data, display_name, full_name, date_of_birth, metadata, portrait_image, issuing_states, approved_emails, approved_phones, features, session_count, approved_count, declined_count, in_review_count, first_session_at, last_session_at.
Business: vendor_data, display_name, metadata, legal_name, registration_number, country_code, session_count, approved_count, declined_count, in_review_count, features, first_session_at, last_session_at.

Gunakan changed_fields dan changes untuk menyinkronkan hanya kolom yang berubah.

Pengiriman, percobaan ulang, dan penandatanganan

Semua webhook entitas mengikuti kontrak pengiriman standar:

Ditandatangani dengan HMAC-SHA256 di header X-Signature-V2 (direkomendasikan), menggunakan secret_shared_key dari tujuan. X-Signature dan X-Signature-Simple yang sudah tidak digunakan lagi juga dikirim, bersama X-Timestamp.
Dicoba lagi hingga 2 kali, setelah sekitar 1 menit dan sekitar 4 menit, ketika endpoint Anda merespons 5xx atau 404, mengalami timeout, atau gagal terhubung. Referensi webhook memuat kebijakan lengkapnya.
Idempoten: setiap webhook memiliki event_id yang unik dalam payload; lakukan deduplikasi di sisi Anda.

Lihat Referensi webhook untuk pengaturan tujuan dan contoh kode verifikasi tanda tangan.

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Entity sync",
    "url": "https://yourapp.com/webhooks/didit",
    "subscribed_events": [
      "user.status.updated",
      "user.data.updated",
      "business.status.updated",
      "business.data.updated"
    ]
  }'

Langkah selanjutnya

Referensi webhook

Tujuan, tanda tangan, percobaan ulang, dan verifikasi.

Buat tujuan

Daftarkan endpoint webhook baru.

Operasi pengguna

Perubahan yang memicu webhook pengguna.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Webhook Entitas Didit: Event Pengguna & Bisnis

Katalog event

Bentuk payload

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

Pengiriman, percobaan ulang, dan penandatanganan

Berlangganan

Langkah selanjutnya

Referensi webhook

Buat tujuan

Operasi pengguna

​Katalog event

​Bentuk payload

​user.status.updated / business.status.updated

​user.data.updated / business.data.updated

​Pengiriman, percobaan ulang, dan penandatanganan

​Berlangganan

​Langkah selanjutnya

Referensi webhook

Buat tujuan

Operasi pengguna

Katalog event

Bentuk payload

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

Pengiriman, percobaan ulang, dan penandatanganan

Berlangganan

Langkah selanjutnya