Aggiorna destinazione webhook 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 questo endpoint per modificare la destinazione a cui vengono inviati i webhook e gli eventi che riceve.

Aggiornamento di `subscribed_events`

Quando invii subscribed_events, fornisci l’elenco completo degli eventi che devono restare sottoscritti dopo l’aggiornamento. L’array sostituisce l’elenco precedente degli eventi sottoscritti.

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

I valori supportati sono:

Evento	Cosa rappresenta
`status.updated`	Lo stato di una sessione di Verifica degli utenti (KYC) o di Verifica aziendale (KYB) è cambiato.
`data.updated`	I dati di verifica della sessione sono cambiati dopo la creazione.
`user.status.updated`	Lo stato dell’entità utente è cambiato.
`user.data.updated`	I dati dell’entità utente sono cambiati.
`business.status.updated`	Lo stato dell’entità azienda è cambiato.
`business.data.updated`	I dati dell’entità azienda sono cambiati.
`activity.created`	Accettato, ma oggi non consegnato per il traffico in produzione.
`transaction.created`	Transazione creata e valutata inizialmente.
`transaction.status.updated`	Lo stato della transazione è cambiato.
`travel_rule.status.updated`	Lo stato di uno scambio Travel Rule è cambiato.
`workflow.compliance_changed`	Lo stato di conformità di un workflow pubblicato è cambiato.
`transaction_rule_suggestions.created`	Un’esecuzione di suggerimenti di regole ha proposto nuove modifiche alle regole.

Sono accettate anche le famiglie di eventi Investigator (investigator.*) e Authentication (auth.*); consulta Webhook per l’elenco completo. Usa la guida alla creazione della destinazione per le descrizioni dettagliate degli eventi e i set di sottoscrizione più comuni.

Autorizzazioni

x-api-key

string

header

obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

destination_uuid

string<uuid>

obbligatorio

UUID della destinazione da aggiornare.

Corpo

application/json

label

string

Nuovo nome leggibile.

url

string<uri>

Nuovo URL di destinazione. Deve essere univoco all'interno dell'applicazione.

enabled

boolean

Imposta su false per sospendere le consegne a questa destinazione senza eliminarla.

webhook_version

enum<string>

Nuova versione dello schema del payload per le consegne future.

Opzioni disponibili:

v1,

v2,

v3

subscribed_events

enum<string>[]

Filtro degli eventi per questa destinazione webhook. Didit consegna solo i webhook il cui tipo di evento corrisponde esattamente a uno di questi valori — non esiste un abbonamento con caratteri jolly. Quando viene inviato, l'elenco deve contenere almeno un evento valido (un [] esplicito viene rifiutato con 400); una destinazione il cui elenco è vuoto (campo omesso alla creazione) non riceve nulla. In caso di aggiornamento, l'elenco viene sostituito per intero, mai unito.

Minimum array length: 1

Nome dell'evento webhook supportato. Usa queste stringhe esatte in subscribed_events; i valori non supportati vengono rifiutati.

Opzioni disponibili:

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

Esempio:

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

Risposta

Destinazione webhook aggiornata. Il corpo ha la stessa struttura di GET /v3/webhook/destinations/{destination_uuid}/.

uuid

string<uuid>

label

string

url

string<uri>

enabled

boolean

webhook_version

enum<string>

Opzioni disponibili:

v1,

v2,

v3

secret_shared_key

string

secret_last4

string

Ultimi quattro caratteri del segreto di firma attuale della destinazione, per consentirti di distinguere i segreti. Non sufficienti per verificare una firma.

previous_secret_expires_at

string<date-time> | null

Impostato per 24 ore dopo la rotazione del segreto di firma della destinazione nella Business Console. Fino a tale momento, ogni consegna alla destinazione include anche X-Signature-Previous, X-Signature-V2-Previous e X-Signature-Simple-Previous, generati con il segreto sostituito (vedi Verifica della firma). null quando non si è verificata alcuna rotazione nelle ultime 24 ore.

subscribed_events

enum<string>[]

Minimum array length: 1

Nome dell'evento webhook supportato. Usa queste stringhe esatte in subscribed_events; i valori non supportati vengono rifiutati.

Opzioni disponibili:

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

Esempio:

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

created_by_email

string | null

Email del membro della Business Console che ha creato la destinazione. null per una destinazione creata con una chiave API.

created_by_name

string | null

Nome del membro della Business Console che ha creato la destinazione. null per una destinazione creata con una chiave API.

created_at

string<date-time>

updated_at

string<date-time>

health_status

enum<string>

Stato della consegna. failing: 3 o più eventi consecutivi hanno fallito il primo tentativo di consegna dall'ultima risposta riuscita della destinazione (vedere failing_streak). degraded: non in errore, ma un tentativo di consegna è fallito nelle ultime 24 ore e nessun tentativo successivo ha consegnato quell'evento; un nuovo tentativo o reinvio che lo consegna cancella questa condizione. healthy: nessuno dei due. Indipendente da enabled. Un tentativo fallito è quello a cui è stato risposto con HTTP 400 o superiore, o a cui non è stata data alcuna risposta.

Opzioni disponibili:

healthy,

degraded,

failing

failing_streak

integer

Quanti eventi consecutivi hanno fallito il primo tentativo di consegna dall'ultima risposta positiva della destinazione, negli ultimi 30 giorni. I nuovi tentativi non vengono conteggiati e qualsiasi tentativo riuscito, inclusi nuovi tentativi o reinvii, interrompe la serie. 0 quando nessun evento ha fallito dall'ultimo successo.

failing_since

string<date-time> | null

Data e ora del primo tentativo fallito dell'attuale failing_streak. null quando failing_streak è 0.

last_success_at

string<date-time> | null

Data e ora dell'ultima risposta della destinazione a una consegna con uno stato HTTP inferiore a 400, negli ultimi 30 giorni. null se non ha risposto in tale intervallo.

environment

enum<string>

Ambiente dell'applicazione proprietaria della destinazione.

Opzioni disponibili:

live,

sandbox

summary

object

Metriche di consegna per gli ultimi metrics_window_days (30) giorni. last_delivery_at è il tentativo più recente, a prescindere da quando è stato effettuato.

Show child attributes

Ultima modifica il 7 novembre 2026

​Aggiornamento di subscribed_events

Autorizzazioni

Parametri del percorso

Corpo

Risposta

Aggiornamento di `subscribed_events`