Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl -X PATCH 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"subscribed_events": [
"status.updated",
"data.updated",
"transaction.created"
]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.update(
"11111111-2222-3333-4444-555555555555",
enabled=False,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.update("11111111-2222-3333-4444-555555555555", {
enabled: false,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.Update(ctx, "11111111-2222-3333-4444-555555555555", didit.WebhooksDestinationsUpdateParams{
Enabled: didit.Bool(false),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.WebhooksDestinationsUpdateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().update("11111111-2222-3333-4444-555555555555", WebhooksDestinationsUpdateParams.builder()
.enabled(false)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->update('11111111-2222-3333-4444-555555555555', [
'enabled' => false,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.destinations.update(
"11111111-2222-3333-4444-555555555555",
enabled: false
)
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.UpdateAsync("11111111-2222-3333-4444-555555555555", new WebhooksDestinationsUpdateParams
{
Enabled = false,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": false,
"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-01-04T08:00:00Z",
"updated_at": "2026-05-17T11:02:55Z",
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": "2026-05-17T09:21:18Z",
"environment": "live",
"summary": {
"total_deliveries": 12453,
"failed_deliveries": 14,
"error_rate_percentage": 0,
"min_response_time_ms": 41,
"avg_response_time_ms": 187,
"max_response_time_ms": 2103,
"last_delivery_at": "2026-05-17T09:21:18Z",
"metrics_window_days": 30
}
}API per actualitzar la destinació de webhook
Edita la destinació del webhook de Didit: etiqueta, URL, estat, versió i esdeveniments subscrits. Pagament per crida, sense contractes.
curl -X PATCH 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"subscribed_events": [
"status.updated",
"data.updated",
"transaction.created"
]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.webhooks.destinations.update(
"11111111-2222-3333-4444-555555555555",
enabled=False,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.webhooks.destinations.update("11111111-2222-3333-4444-555555555555", {
enabled: false,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Webhooks.Destinations.Update(ctx, "11111111-2222-3333-4444-555555555555", didit.WebhooksDestinationsUpdateParams{
Enabled: didit.Bool(false),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.WebhooksDestinationsUpdateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.webhooks().destinations().update("11111111-2222-3333-4444-555555555555", WebhooksDestinationsUpdateParams.builder()
.enabled(false)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->webhooks->destinations->update('11111111-2222-3333-4444-555555555555', [
'enabled' => false,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.webhooks.destinations.update(
"11111111-2222-3333-4444-555555555555",
enabled: false
)
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.UpdateAsync("11111111-2222-3333-4444-555555555555", new WebhooksDestinationsUpdateParams
{
Enabled = false,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"label": "Production session webhooks",
"url": "https://yourapp.com/webhooks/didit",
"enabled": false,
"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-01-04T08:00:00Z",
"updated_at": "2026-05-17T11:02:55Z",
"health_status": "healthy",
"failing_streak": 0,
"failing_since": null,
"last_success_at": "2026-05-17T09:21:18Z",
"environment": "live",
"summary": {
"total_deliveries": 12453,
"failed_deliveries": 14,
"error_rate_percentage": 0,
"min_response_time_ms": 41,
"avg_response_time_ms": 187,
"max_response_time_ms": 2103,
"last_delivery_at": "2026-05-17T09:21:18Z",
"metrics_window_days": 30
}
}Actualització de subscribed_events
Quan envies subscribed_events, proporciona la llista completa d’esdeveniments que han de continuar subscrits després de l’actualització. La llista substitueix el conjunt de subscripcions anterior.
{
"subscribed_events": [
"status.updated",
"data.updated",
"transaction.created",
"transaction.status.updated"
]
}
| Esdeveniment | Què representa |
|---|---|
status.updated | Ha canviat l’estat de la sessió de verificació d’usuaris (KYC) o de verificació d’empreses (KYB). |
data.updated | Han canviat les dades de verificació de la sessió després de la creació. |
user.status.updated | Ha canviat l’estat de l’entitat d’usuari. |
user.data.updated | Han canviat les dades de l’entitat d’usuari. |
business.status.updated | Ha canviat l’estat de l’entitat d’empresa. |
business.data.updated | Han canviat les dades de l’entitat d’empresa. |
activity.created | Acceptat, però avui no es lliura per al trànsit en producció. |
transaction.created | Transacció creada i avaluada inicialment. |
transaction.status.updated | Ha canviat l’estat de la transacció. |
travel_rule.status.updated | Ha canviat l’estat d’un intercanvi de Travel Rule. |
workflow.compliance_changed | Ha canviat l’estat de compliment d’un flux de treball publicat. |
transaction_rule_suggestions.created | Una execució de suggeriments de regles ha proposat nous canvis en les regles. |
investigator.*) i d’autenticació (auth.*) també són admeses; consulta webhooks per a la llista completa.
Fes servir la guia de creació de destinacions per a descripcions detallades dels esdeveniments i conjunts habituals de subscripcions.Autoritzacions
La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.
Paràmetres de ruta
UUID de la destinació que cal actualitzar.
Cos
Nou nom llegible per a les persones.
Nova URL de destinació. Ha de ser única dins de l'aplicació.
Estableix-ho a false per pausar els lliuraments a aquesta destinació sense eliminar-la.
Nova versió de l'esquema de payload per a lliuraments futurs.
v1, v2, v3 Filtre d'esdeveniments per a aquesta destinació del webhook. Didit només lliura webhooks el tipus d'esdeveniment dels quals coincideix exactament amb un d'aquests valors; no hi ha subscripció amb caràcters comodí. Quan s'envia, la llista ha de contenir almenys un esdeveniment vàlid (un [] explícit es rebutja amb 400); una destinació amb la llista buida (camp omès en crear-se) no rep res. En actualitzar, la llista es reemplaça completament, mai es fusiona.
1Nom d'esdeveniment de webhook admès. Utilitza aquestes cadenes exactes a subscribed_events; els valors no admesos es rebutgen.
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"]
Resposta
Destinació del webhook actualitzada. El cos té la mateixa estructura que GET /v3/webhook/destinations/{destination_uuid}/.
v1, v2, v3 Últims quatre caràcters del secret de signatura actual de la destinació, perquè puguis distingir els secrets. No són suficients per verificar una signatura.
Establert durant 24 hores després que el secret de signatura de la destinació es roti a la Business Console. Fins aquest moment, cada lliurament a la destinació també inclou X-Signature-Previous, X-Signature-V2-Previous i X-Signature-Simple-Previous, generats amb el secret substituït (consulta Verificació de la signatura). null quan no s'ha produït cap rotació en les darreres 24 hores.
Filtre d'esdeveniments per a aquesta destinació del webhook. Didit només lliura webhooks el tipus d'esdeveniment dels quals coincideix exactament amb un d'aquests valors; no hi ha subscripció amb caràcters comodí. Quan s'envia, la llista ha de contenir almenys un esdeveniment vàlid (un [] explícit es rebutja amb 400); una destinació amb la llista buida (camp omès en crear-se) no rep res. En actualitzar, la llista es reemplaça completament, mai es fusiona.
1Nom d'esdeveniment de webhook admès. Utilitza aquestes cadenes exactes a subscribed_events; els valors no admesos es rebutgen.
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"]
Correu electrònic del membre de la Business Console que ha creat la destinació. null per a una destinació creada amb una clau d'API.
Nom del membre de la Business Console que ha creat la destinació. null per a una destinació creada amb una clau d'API.
Estat del lliurament. failing: 3 o més esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per darrera vegada (consulta failing_streak). degraded: no és failing, però un intent de lliurament ha fallat en les darreres 24 hores i cap intent posterior ha lliurat aquest esdeveniment; un reintent o reenviament que el lliuri neteja aquest estat. healthy: cap dels dos. Independent d'enabled. Un intent fallit és un que ha rebut una resposta HTTP 400 o superior, o que no ha rebut cap resposta.
healthy, degraded, failing Quants esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per última vegada, durant els darrers 30 dies. Els reintents no es comptabilitzen, i qualsevol intent satisfactori, inclòs un reintent o un reenviament, posa fi a la ratxa. 0 quan cap esdeveniment ha fallat des de l'últim èxit.
Quan es va fer el primer intent fallit de la failing_streak actual. null quan failing_streak és 0.
Quan la destinació va respondre per darrera vegada a un lliurament amb un estat HTTP inferior a 400, en els darrers 30 dies. null si no ho ha fet en aquest interval.
Entorn de l'aplicació propietària de la destinació.
live, sandbox Mètriques de lliurament dels darrers metrics_window_days (30) dies. last_delivery_at és l'intent més recent, independentment de quan es va fer.
Show child attributes
Show child attributes