Commencer
Intégrer / SDK
Vérification des utilisateurs
Vérification d'entreprise
Surveillance des transactions
Journal des modificationscurl -X POST 'https://verification.didit.me/v3/webhook/destinations/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"webhook_version": "v3",
"subscribed_events": ["status.updated", "data.updated"]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.create(
label="Production session webhooks",
url="https://yourapp.com/webhooks/didit",
webhook_version="v3",
subscribed_events=["status.updated", "data.updated"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.create({
label: "Production session webhooks",
url: "https://yourapp.com/webhooks/didit",
webhook_version: "v3",
subscribed_events: ["status.updated", "data.updated"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.Create(ctx, didit.WebhooksDestinationsCreateParams{
Label: "Production session webhooks",
URL: "https://yourapp.com/webhooks/didit",
WebhookVersion: didit.Some(didit.WebhooksDestinationsCreateParamsWebhookVersion("v3")),
SubscribedEvents: didit.Some([]didit.WebhookEvent{didit.WebhookEvent("status.updated"), didit.WebhookEvent("data.updated")}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.WebhookEvent;
import me.didit.types.WebhooksDestinationsCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().create(WebhooksDestinationsCreateParams.builder()
.label("Production session webhooks")
.url("https://yourapp.com/webhooks/didit")
.webhookVersion(WebhooksDestinationsCreateParams.WebhookVersion.of("v3"))
.subscribedEvents(List.of(WebhookEvent.of("status.updated"), WebhookEvent.of("data.updated")))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->create([
'label' => 'Production session webhooks',
'url' => 'https://yourapp.com/webhooks/didit',
'webhook_version' => 'v3',
'subscribed_events' => ['status.updated', 'data.updated'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.destinations.create(
label: "Production session webhooks",
url: "https://yourapp.com/webhooks/didit",
webhook_version: "v3",
subscribed_events: ["status.updated", "data.updated"]
)
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.Destinations.CreateAsync(new WebhooksDestinationsCreateParams
{
Label = "Production session webhooks",
Url = "https://yourapp.com/webhooks/didit",
WebhookVersion = new WebhooksDestinationsCreateParamsWebhookVersion("v3"),
SubscribedEvents = new WebhookEvent[] { "status.updated", "data.updated" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"secret_shared_key": "tno2NTeRC1ZK3sBOYlBJDyEzBVENl3pQ1AcZyAW0xnQ",
"secret_last4": "0xnQ",
"previous_secret_expires_at": null,
"subscribed_events": [
"status.updated",
"data.updated"
],
"created_by_email": null,
"created_by_name": null,
"created_at": "2026-05-17T10:00:00Z",
"updated_at": "2026-05-17T10:00:00Z",
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": null,
"environment": "live",
"summary": {
"total_deliveries": 0,
"failed_deliveries": 0,
"error_rate_percentage": 0,
"min_response_time_ms": null,
"avg_response_time_ms": null,
"max_response_time_ms": null,
"last_delivery_at": null,
"metrics_window_days": 30
}
}Créer une destination webhook API
Créez une destination webhook Didit avec version, événements abonnés et secret de signature dédié. Gestion des webhooks par API, à l’appel.
curl -X POST 'https://verification.didit.me/v3/webhook/destinations/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"webhook_version": "v3",
"subscribed_events": ["status.updated", "data.updated"]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.create(
label="Production session webhooks",
url="https://yourapp.com/webhooks/didit",
webhook_version="v3",
subscribed_events=["status.updated", "data.updated"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.create({
label: "Production session webhooks",
url: "https://yourapp.com/webhooks/didit",
webhook_version: "v3",
subscribed_events: ["status.updated", "data.updated"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.Create(ctx, didit.WebhooksDestinationsCreateParams{
Label: "Production session webhooks",
URL: "https://yourapp.com/webhooks/didit",
WebhookVersion: didit.Some(didit.WebhooksDestinationsCreateParamsWebhookVersion("v3")),
SubscribedEvents: didit.Some([]didit.WebhookEvent{didit.WebhookEvent("status.updated"), didit.WebhookEvent("data.updated")}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.WebhookEvent;
import me.didit.types.WebhooksDestinationsCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().create(WebhooksDestinationsCreateParams.builder()
.label("Production session webhooks")
.url("https://yourapp.com/webhooks/didit")
.webhookVersion(WebhooksDestinationsCreateParams.WebhookVersion.of("v3"))
.subscribedEvents(List.of(WebhookEvent.of("status.updated"), WebhookEvent.of("data.updated")))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->create([
'label' => 'Production session webhooks',
'url' => 'https://yourapp.com/webhooks/didit',
'webhook_version' => 'v3',
'subscribed_events' => ['status.updated', 'data.updated'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.destinations.create(
label: "Production session webhooks",
url: "https://yourapp.com/webhooks/didit",
webhook_version: "v3",
subscribed_events: ["status.updated", "data.updated"]
)
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.Destinations.CreateAsync(new WebhooksDestinationsCreateParams
{
Label = "Production session webhooks",
Url = "https://yourapp.com/webhooks/didit",
WebhookVersion = new WebhooksDestinationsCreateParamsWebhookVersion("v3"),
SubscribedEvents = new WebhookEvent[] { "status.updated", "data.updated" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": true,
"webhook_version": "v3",
"secret_shared_key": "tno2NTeRC1ZK3sBOYlBJDyEzBVENl3pQ1AcZyAW0xnQ",
"secret_last4": "0xnQ",
"previous_secret_expires_at": null,
"subscribed_events": [
"status.updated",
"data.updated"
],
"created_by_email": null,
"created_by_name": null,
"created_at": "2026-05-17T10:00:00Z",
"updated_at": "2026-05-17T10:00:00Z",
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": null,
"environment": "live",
"summary": {
"total_deliveries": 0,
"failed_deliveries": 0,
"error_rate_percentage": 0,
"min_response_time_ms": null,
"avg_response_time_ms": null,
"max_response_time_ms": null,
"last_delivery_at": null,
"metrics_window_days": 30
}
}secret_shared_key, sa propre webhook_version et sa propre liste subscribed_events.
Comment fonctionne subscribed_events
subscribed_events est un tableau obligatoire de noms d’événements exacts. Didit n’envoie un webhook à cette destination que si le webhook_type du payload correspond à l’une des valeurs du tableau.
- Incluez au moins un événement.
- Utilisez uniquement les noms d’événements pris en charge ci-dessous.
- Ajoutez chaque événement que vous souhaitez recevoir ; il n’existe pas de valeur joker comme
*ouall. - Pour router différents domaines de produits vers différents systèmes, créez plusieurs destinations avec des listes
subscribed_eventsdifférentes.
Catalogue des événements
| Événement | À utiliser lorsque vous avez besoin de |
|---|---|
status.updated | Suivre les changements de statut d’une session de Vérification des utilisateurs (KYC) ou de Vérification d’entreprise (KYB). Les payloads KYB incluent session_kind: "business" et business_session_id. |
data.updated | Recevoir les données de vérification d’une session lorsqu’elles sont corrigées ou mises à jour après sa création, par exemple lors de modifications effectuées par un réviseur sur les données KYC, de justificatif de domicile ou KYB. |
user.status.updated | Suivre le changement de statut d’une entité User, par exemple ACTIVE, FLAGGED ou BLOCKED. |
user.data.updated | Suivre les changements du profil, des compteurs, des métadonnées, des documents ou des champs de vérification agrégés d’une entité User. |
business.status.updated | Suivre le changement de statut d’une entité Business, par exemple après un examen manuel, des résultats KYB ou une action de liste de blocage. |
business.data.updated | Suivre les changements du profil, des compteurs, des métadonnées, des champs d’immatriculation ou des champs de vérification agrégés d’une entité Business. |
activity.created | Accepté dans subscribed_events et couvert par Try Webhook, mais Didit n’envoie actuellement pas cet événement pour le trafic de production. |
transaction.created | Une transaction est créée dans la Surveillance des transactions et son évaluation initiale des règles est terminée. |
transaction.status.updated | Une transaction change de statut après l’application des règles, l’examen par un analyste, la remédiation, les mises à jour des fournisseurs ou des actions via l’API ou la console ; cet événement est aussi envoyé une fois lorsqu’un filtrage crypto relancé en arrière-plan se termine. |
travel_rule.status.updated | Un échange Travel Rule change de statut. |
workflow.compliance_changed | Le statut de conformité d’un workflow publié change après une réévaluation. |
transaction_rule_suggestions.created | Une exécution de suggestions de règles propose de nouvelles modifications de règles. |
investigator.*) et Authentication (auth.*) sont également acceptées. Tous les événements et leurs payloads sont décrits dans Webhooks.
Ensembles d’abonnement courants :
{
"subscribed_events": ["status.updated", "data.updated"]
}
{
"subscribed_events": ["transaction.created", "transaction.status.updated"]
}
{
"subscribed_events": [
"user.status.updated",
"user.data.updated",
"business.status.updated",
"business.data.updated",
"activity.created"
]
}
Autorisations
La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.
Corps
Nom lisible par l'humain affiché dans Console → Webhooks. Permet de distinguer les destinations lorsque vous en avez plusieurs (par ex. "Prod", "Staging mirror").
255URL HTTPS qui recevra les requêtes POST. Doit être unique parmi les destinations de l'application. Utilisez un endpoint stable et renforcé : Didit réessaie les livraisons ayant échoué selon un calendrier d'intervalles progressifs.
2000Lorsque la valeur est false, la destination est enregistrée mais Didit n'y enverra aucun webhook. Pratique pour les configurations de staging que vous souhaitez laisser en attente.
Version du schéma de payload que Didit enverra. v3 est le format actuel/recommandé ; les versions antérieures sont conservées pour des raisons de rétrocompatibilité avec les intégrations historiques.
v1, v2, v3 Événements à livrer. Concrètement obligatoire : un [] explicite est rejeté avec une erreur 400, et omettre ce champ crée une destination sans aucun abonnement qui ne reçoit rien.
1Nom d'événement webhook pris en charge. Utilisez ces chaînes exactes dans subscribed_events ; les valeurs non prises en charge sont rejetées.
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 ["status.updated", "data.updated"]
Réponse
Destination créée. secret_shared_key est le secret de signature HMAC — stockez-le maintenant.
Identifiant stable de la destination. À utiliser comme {destination_uuid} dans les appels ultérieurs.
v1, v2, v3 Secret de signature HMAC généré automatiquement et lié à cette destination (token de 43 caractères compatible URL). Utilisez-le pour vérifier les en-têtes de signature sur les webhooks entrants. Toujours renvoyé en intégralité aux appelants utilisant une clé API ; les utilisateurs de la Console doivent disposer de l'autorisation read:webhooks, faute de quoi ils verront une chaîne vide.
Quatre derniers caractères du secret de signature actuel de la destination, vous permettant de distinguer les secrets. Insuffisant pour vérifier une signature.
Défini pendant 24 heures après la rotation du secret de signature de la destination dans la Business Console. Jusqu'à cette échéance, chaque livraison vers la destination comporte également X-Signature-Previous, X-Signature-V2-Previous et X-Signature-Simple-Previous, générés avec le secret remplacé (voir Vérification de signature). null si aucune rotation n'a eu lieu au cours des dernières 24 heures.
Filtre d'événements pour cette destination de webhook. Didit ne livre que les webhooks dont le type d'événement correspond exactement à l'une de ces valeurs — il n'y a pas d'abonnement avec caractère générique. Lorsqu'elle est envoyée, la liste doit contenir au moins un événement valide (un [] explicite est rejeté avec une erreur 400) ; une destination dont la liste est vide (champ omis lors de la création) ne reçoit rien. Lors d'une mise à jour, la liste est entièrement remplacée, jamais fusionnée.
1Nom d'événement webhook pris en charge. Utilisez ces chaînes exactes dans subscribed_events ; les valeurs non prises en charge sont rejetées.
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 ["status.updated", "data.updated"]
E-mail du membre de la Business Console qui a créé la destination. null pour une destination créée avec une clé API.
Nom du membre de la Business Console ayant créé la destination. null pour une destination créée avec une clé API.
État de la livraison. failing : 3 événements consécutifs ou plus ont échoué lors de leur première tentative de livraison depuis la dernière réponse réussie de la destination (voir failing_streak). degraded : pas en échec, mais une tentative de livraison a échoué au cours des dernières 24 heures et aucune tentative ultérieure n'a livré cet événement ; une nouvelle tentative ou un renvoi qui le livre efface cet état. healthy : aucun des deux. Indépendant de enabled. Une tentative échouée correspond à une réponse HTTP 400 ou supérieure, ou à une absence totale de réponse.
healthy, degraded, failing Nombre d'événements consécutifs dont la première tentative de livraison a échoué depuis la dernière réponse réussie de la destination, au cours des 30 derniers jours. Les nouvelles tentatives ne sont pas comptabilisées, et toute tentative réussie, y compris une nouvelle tentative ou un renvoi, met fin à la série. 0 lorsqu'aucun événement n'a échoué depuis le dernier succès.
Date et heure de la première tentative infructueuse de la série d'échecs en cours (failing_streak). null lorsque failing_streak vaut 0.
Date et heure auxquelles la destination a répondu pour la dernière fois à une livraison avec un statut HTTP inférieur à 400, au cours des 30 derniers jours. null si ce n'est pas le cas dans cet intervalle.
Environnement de l'application propriétaire de la destination.
live, sandbox Métriques de livraison pour les derniers metrics_window_days (30) jours. last_delivery_at correspond à la tentative la plus récente, quelle que soit la date à laquelle elle a été effectuée.
Show child attributes
Show child attributes