Actualizar destino de webhook con la API

curl

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"
    ]
  }'

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());

using 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
  }
}

PATCH

webhook

destinations

{destination_uuid}

curl

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"
    ]
  }'

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());

using 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
  }
}

Usa este endpoint para cambiar adónde envía webhooks un destino y qué eventos recibe.

Actualizar `subscribed_events`

Cuando envíes subscribed_events, indica la lista completa de eventos que deben seguir suscritos después de la actualización. El array sustituye al conjunto de suscripciones anterior.

{
  "subscribed_events": [
    "status.updated",
    "data.updated",
    "transaction.created",
    "transaction.status.updated"
  ]
}

Los valores admitidos son:

Evento	Qué representa
`status.updated`	Cambió el estado de una sesión de Verificación de usuarios (KYC) o de Verificación de empresas (KYB).
`data.updated`	Cambiaron los datos de verificación de la sesión después de su creación.
`user.status.updated`	Cambió el estado de la entidad de usuario.
`user.data.updated`	Cambiaron los datos de la entidad de usuario.
`business.status.updated`	Cambió el estado de la entidad de empresa.
`business.data.updated`	Cambiaron los datos de la entidad de empresa.
`activity.created`	Se acepta, pero actualmente no se entrega para el tráfico de producción.
`transaction.created`	Se creó una transacción y se realizó su evaluación inicial.
`transaction.status.updated`	Cambió el estado de una transacción.
`travel_rule.status.updated`	Un intercambio de Travel Rule cambió de estado.
`workflow.compliance_changed`	Cambió el estado de cumplimiento de un flujo publicado.
`transaction_rule_suggestions.created`	Una ejecución de sugerencias de reglas propuso nuevos cambios en las reglas.

También se aceptan las familias de eventos de Investigator (investigator.*) y de autenticación (auth.*); consulta Webhooks para ver la lista completa. Consulta la guía para crear destinos para ver descripciones detalladas de los eventos y conjuntos de suscripciones habituales.

Autorizaciones

x-api-key

string

header

requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

destination_uuid

string<uuid>

requerido

UUID del destino que se va a actualizar.

Cuerpo

application/json

label

string

Nuevo nombre legible.

url

string<uri>

Nueva URL de destino. Debe ser única dentro de la aplicación.

enabled

boolean

Establécelo en false para pausar las entregas a este destino sin eliminarlo.

webhook_version

enum<string>

Nueva versión del esquema del payload para las entregas futuras.

Opciones disponibles:

v1,

v2,

v3

subscribed_events

enum<string>[]

Filtro de eventos de este destino de webhook. Didit entrega solo los webhooks cuyo tipo de evento coincide exactamente con uno de estos valores: no existe una suscripción comodín. Si se envía, la lista debe contener al menos un evento válido (un [] explícito se rechaza con 400). Un destino con la lista vacía (campo omitido al crearlo) no recibe nada. Al actualizar, la lista se reemplaza por completo y nunca se combina.

Minimum array length: 1

Nombre de evento de webhook admitido. Usa exactamente estas cadenas en subscribed_events; los valores no admitidos se rechazan.

Opciones disponibles:

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

Ejemplo:

["status.updated", "data.updated"]

Respuesta

Destino de webhook actualizado. El cuerpo tiene la misma estructura que GET /v3/webhook/destinations/{destination_uuid}/.

uuid

string<uuid>

label

string

url

string<uri>

enabled

boolean

webhook_version

enum<string>

Opciones disponibles:

v1,

v2,

v3

secret_shared_key

string

secret_last4

string

Últimos cuatro caracteres del secreto de firma actual del destino, para que puedas distinguir los secretos. No basta para verificar una firma.

previous_secret_expires_at

string<date-time> | null

Se establece durante 24 horas después de rotar el secreto de firma del destino en la Business Console. Hasta ese momento, cada entrega al destino también incluye X-Signature-Previous, X-Signature-V2-Previous y X-Signature-Simple-Previous, generados con el secreto sustituido (consulta Verificación de firma). null cuando no se ha producido ninguna rotación en las últimas 24 horas.

subscribed_events

enum<string>[]

Minimum array length: 1

Nombre de evento de webhook admitido. Usa exactamente estas cadenas en subscribed_events; los valores no admitidos se rechazan.

Opciones disponibles:

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

Ejemplo:

["status.updated", "data.updated"]

created_by_email

string | null

Correo electrónico del miembro de Business Console que creó el destino. null para un destino creado con una clave de API.

created_by_name

string | null

Nombre del miembro de Business Console que creó el destino. null para un destino creado con una clave de API.

created_at

string<date-time>

updated_at

string<date-time>

health_status

enum<string>

Estado de las entregas. failing: 3 o más eventos consecutivos fallaron en su primer intento de entrega desde la última vez que el destino respondió correctamente (consulta failing_streak). degraded: el destino no está fallando, pero un intento de entrega falló en las últimas 24 horas y ningún intento posterior ha entregado ese evento; un reintento o un reenvío que lo entregue elimina este estado. healthy: ninguno de los dos casos anteriores. Es independiente de enabled. Un intento fallido es aquel que recibe una respuesta HTTP 400 o superior, o que no recibe ninguna respuesta.

Opciones disponibles:

healthy,

degraded,

failing

failing_streak

integer

Cuántos eventos consecutivos fallaron en su primer intento de entrega desde la última vez que el destino respondió correctamente, dentro de los últimos 30 días. Los reintentos no se cuentan, y cualquier intento correcto, incluido un reintento o un reenvío, pone fin a la racha. 0 cuando ningún evento ha fallado desde el último éxito.

failing_since

string<date-time> | null

Cuándo se realizó el primer intento fallido de la failing_streak actual. null cuando failing_streak es 0.

last_success_at

string<date-time> | null

Cuándo el destino respondió por última vez a una entrega con un estado HTTP inferior a 400, dentro de los últimos 30 días. null si no lo ha hecho en ese periodo.

environment

enum<string>

Entorno de la aplicación a la que pertenece el destino.

Opciones disponibles:

live,

sandbox

summary

object

Métricas de entrega de los últimos metrics_window_days (30) días. last_delivery_at es el intento más reciente, independientemente de cuándo se realizó.

Show child attributes

Última modificación el 1 de noviembre de 2026

​Actualizar subscribed_events

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Actualizar `subscribed_events`