Mulai
Integrasi / SDK
Verifikasi Pengguna
Verifikasi Bisnis
Pemantauan Transaksi
Log Perubahancurl -X PATCH 'https://verification.didit.me/v3/webhook/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"face_retention_policy": "retain_until_user_deleted", "face_retention_days": 365}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.update_config(
face_retention_policy="retain_until_user_deleted",
face_retention_days=365,
biometric_consent_mode="auto",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.updateConfig({
face_retention_policy: "retain_until_user_deleted",
face_retention_days: 365,
biometric_consent_mode: "auto",
});
console.log(result);import me.didit.Didit;
import me.didit.types.WebhooksUpdateConfigParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().updateConfig(WebhooksUpdateConfigParams.builder()
.faceRetentionPolicy(WebhooksUpdateConfigParams.FaceRetentionPolicy.of("retain_until_user_deleted"))
.faceRetentionDays(365L)
.biometricConsentMode(WebhooksUpdateConfigParams.BiometricConsentMode.of("auto"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->updateConfig([
'face_retention_policy' => 'retain_until_user_deleted',
'face_retention_days' => 365,
'biometric_consent_mode' => 'auto',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.update_config(
face_retention_policy: "retain_until_user_deleted",
face_retention_days: 365,
biometric_consent_mode: "auto"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Webhooks.UpdateConfigAsync(new WebhooksUpdateConfigParams
{
FaceRetentionPolicy = new WebhooksUpdateConfigParamsFaceRetentionPolicy("retain_until_user_deleted"),
FaceRetentionDays = 365,
BiometricConsentMode = new WebhooksUpdateConfigParamsBiometricConsentMode("auto"),
});
Console.WriteLine(JsonSerializer.Serialize(result));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/webhook/"
payload := strings.NewReader("{\n \"face_retention_policy\": \"retain_until_user_deleted\",\n \"face_retention_days\": 365,\n \"biometric_consent_mode\": \"auto\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"webhook_url": "https://yourapp.com/webhooks/didit",
"webhook_version": "v3",
"secret_shared_key": "dGhpcy1pcy10aGUtYXBwLWxldmVsLXNlY3JldC0wMDA",
"capture_method": "MOBILE",
"data_retention_months": 24,
"face_retention_policy": "retain_until_user_deleted",
"face_retention_days": 365,
"biometric_consent_mode": "auto",
"available_events": [
{
"value": "status.updated",
"label": "Session status updated"
},
{
"value": "data.updated",
"label": "Session data updated"
},
{
"value": "user.status.updated",
"label": "User status updated"
},
{
"value": "user.data.updated",
"label": "User data updated"
},
{
"value": "business.status.updated",
"label": "Business status updated"
},
{
"value": "business.data.updated",
"label": "Business data updated"
},
{
"value": "activity.created",
"label": "Activity created"
},
{
"value": "transaction.created",
"label": "Transaction created"
},
{
"value": "transaction.status.updated",
"label": "Transaction status updated"
},
{
"value": "travel_rule.status.updated",
"label": "Travel Rule Status Updated"
},
{
"value": "workflow.compliance_changed",
"label": "Workflow Compliance Changed"
}
],
"allowed_return_hosts": [
"shop.example.com"
],
"endpoints": [
{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"secret_shared_key": "dGhpcy1pcy1hbi1leGFtcGxlLXNlY3JldC0wMDAwMDA",
"subscribed_events": [
"status.updated",
"data.updated"
],
"created_at": "2026-01-04T08:00:00.000000Z",
"updated_at": "2026-04-22T14:09:11.523671Z"
}
]
}API Update Konfigurasi Webhook
Ubah webhook tingkat aplikasi di Didit, rotasi rahasianya, atur retensi data dan templat biometrik, serta daftarkan host pengembalian dompet Digital ID.
curl -X PATCH 'https://verification.didit.me/v3/webhook/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"face_retention_policy": "retain_until_user_deleted", "face_retention_days": 365}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.update_config(
face_retention_policy="retain_until_user_deleted",
face_retention_days=365,
biometric_consent_mode="auto",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.updateConfig({
face_retention_policy: "retain_until_user_deleted",
face_retention_days: 365,
biometric_consent_mode: "auto",
});
console.log(result);import me.didit.Didit;
import me.didit.types.WebhooksUpdateConfigParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().updateConfig(WebhooksUpdateConfigParams.builder()
.faceRetentionPolicy(WebhooksUpdateConfigParams.FaceRetentionPolicy.of("retain_until_user_deleted"))
.faceRetentionDays(365L)
.biometricConsentMode(WebhooksUpdateConfigParams.BiometricConsentMode.of("auto"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->updateConfig([
'face_retention_policy' => 'retain_until_user_deleted',
'face_retention_days' => 365,
'biometric_consent_mode' => 'auto',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.update_config(
face_retention_policy: "retain_until_user_deleted",
face_retention_days: 365,
biometric_consent_mode: "auto"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Webhooks.UpdateConfigAsync(new WebhooksUpdateConfigParams
{
FaceRetentionPolicy = new WebhooksUpdateConfigParamsFaceRetentionPolicy("retain_until_user_deleted"),
FaceRetentionDays = 365,
BiometricConsentMode = new WebhooksUpdateConfigParamsBiometricConsentMode("auto"),
});
Console.WriteLine(JsonSerializer.Serialize(result));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/webhook/"
payload := strings.NewReader("{\n \"face_retention_policy\": \"retain_until_user_deleted\",\n \"face_retention_days\": 365,\n \"biometric_consent_mode\": \"auto\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"webhook_url": "https://yourapp.com/webhooks/didit",
"webhook_version": "v3",
"secret_shared_key": "dGhpcy1pcy10aGUtYXBwLWxldmVsLXNlY3JldC0wMDA",
"capture_method": "MOBILE",
"data_retention_months": 24,
"face_retention_policy": "retain_until_user_deleted",
"face_retention_days": 365,
"biometric_consent_mode": "auto",
"available_events": [
{
"value": "status.updated",
"label": "Session status updated"
},
{
"value": "data.updated",
"label": "Session data updated"
},
{
"value": "user.status.updated",
"label": "User status updated"
},
{
"value": "user.data.updated",
"label": "User data updated"
},
{
"value": "business.status.updated",
"label": "Business status updated"
},
{
"value": "business.data.updated",
"label": "Business data updated"
},
{
"value": "activity.created",
"label": "Activity created"
},
{
"value": "transaction.created",
"label": "Transaction created"
},
{
"value": "transaction.status.updated",
"label": "Transaction status updated"
},
{
"value": "travel_rule.status.updated",
"label": "Travel Rule Status Updated"
},
{
"value": "workflow.compliance_changed",
"label": "Workflow Compliance Changed"
}
],
"allowed_return_hosts": [
"shop.example.com"
],
"endpoints": [
{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"secret_shared_key": "dGhpcy1pcy1hbi1leGFtcGxlLXNlY3JldC0wMDAwMDA",
"subscribed_events": [
"status.updated",
"data.updated"
],
"created_at": "2026-01-04T08:00:00.000000Z",
"updated_at": "2026-04-22T14:09:11.523671Z"
}
]
}rotate_secret_key hanya merotasi rahasia tingkat aplikasi, yang menandatangani pengiriman ke webhook_url lama. Setiap tujuan webhook menandatangani dengan secret_shared_key-nya sendiri, dan panggilan ini tidak mengubahnya.allowed_return_hosts dijelaskan di Daftarkan tujuan pengembalian Anda.
biometric_consent_mode (auto, always atau never) menentukan kapan alur verifikasi meminta persetujuan biometrik eksplisit sebelum pengambilan wajah. Lihat Persetujuan biometrik.
Untuk membaca nilai saat ini terlebih dahulu, panggil Dapatkan Konfigurasi Webhook.Otorisasi
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
Kirim hanya kolom yang akan diubah. Tujuan tidak dikelola di sini.
URL webhook tingkat aplikasi lama. Didit menggunakannya hanya saat aplikasi tidak memiliki tujuan yang aktif, dan kemudian hanya untuk status.updated dan data.updated. Ini tidak membuat tujuan, dan pembuatan, pembaruan, atau penghapusan tujuan berikutnya akan menggantikannya. Untuk menerima webhook, buat tujuan dengan POST /v3/webhook/destinations/ sebagai gantinya.
2000Versi payload dari webhook_url lama.
v1, v2, v3 true mengganti secret_shared_key tingkat aplikasi dengan nilai acak baru secara langsung; nilai baru disertakan dalam respons. Rahasia tujuan tidak diubah. Setiap panggilan dengan true menghasilkan rahasia baru, sehingga tidak bersifat idempoten.
Pengaturan aplikasi lama. Alur verifikasi tidak membacanya.
MOBILE, MOBILE_AND_DESKTOP Jendela penghapusan otomatis dalam bulan (satu bulan dihitung sebagai 30 hari), atau null untuk tanpa penghapusan otomatis. Perubahan juga berlaku untuk sesi yang ada: setiap sesi verifikasi pengguna yang lebih lama dari jendela baru akan dihapus secara otomatis, dan penghapusan tersebut tidak dapat dibatalkan.
1 <= x <= 120Hal yang terjadi pada embedding wajah sesi saat sesi dihapus. retain_until_user_deleted memerlukan face_retention_days dalam permintaan yang sama atau yang sudah diatur sebelumnya. Perubahan berlaku untuk penghapusan sesi setelahnya; perubahan ini tidak membuat atau menghapus secara permanen templat biometrik yang sudah ada.
delete_with_session, retain_until_user_deleted Periode retensi data, dalam hari, untuk templat biometrik di bawah retain_until_user_deleted.
1 <= x <= 3650Kapan alur yang di-hosting dan SDK native meminta persetujuan biometrik eksplisit dari pengguna sebelum pengambilan wajah. auto (default) hanya meminta jika pemicu berlaku: negara bagian yang dinyatakan, IP pengguna, atau penerbit dokumen identitas berada di Illinois, Texas, atau Colorado, atau pengguna tampaknya berada di AS tanpa negara bagian yang diketahui. always meminta kepada setiap pengguna yang alur kerjanya mengambil gambar wajah. never tidak pernah menampilkan langkah tersebut, dan Anda mengumpulkan persetujuan sendiri sebelum swafoto. Setiap perubahan dicatat dalam log audit. Lihat Persetujuan biometrik.
auto, always, never Mengganti seluruh daftar host pengembalian dompet ID Digital. Hanya hostname murni, seperti shop.example.com: tanpa skema, port, path, atau wildcard. Nilai diubah menjadi huruf kecil dan duplikat dihapus. Kirim [] untuk mengosongkan daftar.
20253Mengganti seluruh daftar origin yang diizinkan. Origin (misalnya https://app.example.com; http hanya untuk localhost) tempat alur verifikasi yang di-hosting dapat disematkan dan dapat mengarahkan pengguna kembali dengan callback sesi. Panggilan server-ke-server tidak terpengaruh. Daftar kosong berarti tidak ada batasan. Didit menyimpan setiap origin dalam huruf kecil tanpa port default. Entri yang tidak valid gagal dengan 400 pada allowed_domains. Kirim [] untuk menghapus batasan.
50300["https://app.example.com"]
Respons
Konfigurasi lengkap setelah pembaruan, dengan struktur yang sama seperti GET /v3/webhook/. Saat Anda merotasi rahasia, simpan secret_shared_key baru sebelum Anda membuang respons.
Konfigurasi webhook tingkat aplikasi, kebijakan retensi, dan host pengembalian dompet Digital ID, beserta setiap tujuan webhook.
URL webhook tingkat aplikasi (lama). Didit hanya mengirim ke URL tersebut selama aplikasi tidak memiliki tujuan yang diaktifkan, dan setelah itu hanya status.updated dan data.updated. Setiap pembuatan, pembaruan, atau penghapusan tujuan akan menyetelnya ke URL tujuan aktif yang paling dahulu diaktifkan, atau null jika tidak ada yang diaktifkan.
Versi payload dari webhook_url lama. Setiap tujuan memiliki webhook_version miliknya sendiri.
v1, v2, v3 Rahasia penandatanganan tingkat aplikasi (token 43 karakter yang aman untuk URL). Ini hanya menandatangani pengiriman ke webhook_url lama; setiap tujuan menandatangani dengan secret_shared_key miliknya sendiri. Pemanggil yang menggunakan kunci API selalu menerimanya secara lengkap; pengguna Console tanpa read:webhooks menerima string kosong.
Pengaturan aplikasi lama. Alur verifikasi tidak membacanya: opsi pengambilan dikonfigurasi per alur kerja.
MOBILE, MOBILE_AND_DESKTOP Jendela penghapusan otomatis. Sesi verifikasi pengguna yang dibuat lebih dari sekian bulan lalu (satu bulan dihitung 30 hari) akan dihapus secara otomatis, dan penghapusan tersebut bersifat tidak dapat dibatalkan. null berarti sesi tidak pernah dihapus secara otomatis. Lihat Retensi data.
1 <= x <= 120Hal yang terjadi pada embedding wajah sesi saat sesi dihapus. delete_with_session (default) menghapusnya bersama sesi. retain_until_user_deleted merupakan opsi retensi templat biometrik yang dipilih secara sukarela: templat biometrik bebas gambar yang ditautkan ke Pengguna dikelola secara terpisah hingga periode retensinya berakhir, Pengguna dihapus, atau Anda menghapusnya secara permanen.
delete_with_session, retain_until_user_deleted Periode retensi data, dalam hari, untuk templat biometrik di bawah retain_until_user_deleted. Wajib diisi jika kebijakan tersebut diatur.
1 <= x <= 3650Setiap tipe event yang dapat dilanggan oleh tujuan, dengan label tampilan.
Show child attributes
Show child attributes
Nama host (kecocokan persis, hanya HTTPS) tempat verifikasi dompet Digital ID mandiri dapat mengarahkan pengguna kembali dengan return_url-nya. Domain White Label Anda juga selalu diizinkan. Lihat Daftarkan tujuan pengembalian Anda.
20253Setiap tujuan webhook dari aplikasi, yang terlama terlebih dahulu, masing-masing dengan rahasia penandatangannya. Hanya dapat dibaca di sini: kelola tujuan dengan endpoint /v3/webhook/destinations/.
Show child attributes
Show child attributes
Kapan alur yang di-hosting dan SDK native meminta persetujuan biometrik eksplisit dari pengguna sebelum pengambilan wajah. auto (default) hanya meminta jika pemicu berlaku: negara bagian yang dinyatakan, IP pengguna, atau penerbit dokumen identitas berada di Illinois, Texas, atau Colorado, atau pengguna tampaknya berada di AS tanpa negara bagian yang diketahui. always meminta kepada setiap pengguna yang alur kerjanya mengambil gambar wajah. never tidak pernah menampilkan langkah tersebut, dan Anda mengumpulkan persetujuan sendiri sebelum swafoto. Setiap perubahan dicatat dalam log audit. Lihat Persetujuan biometrik.
auto, always, never Asal (misalnya https://app.example.com; http hanya untuk localhost) tempat alur verifikasi yang di-hosting dapat disematkan dan dapat mengarahkan pengguna kembali dengan callback sesi. Panggilan server-ke-server tidak terpengaruh. Daftar kosong berarti tidak ada batasan. Didit menyimpan setiap origin dalam huruf kecil tanpa port default. Entri yang tidak valid gagal dengan 400 pada allowed_domains.
50300["https://app.example.com"]