API para obtener una entrega de webhook

curl

curl -X GET 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.retrieve_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.retrieveDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.RetrieveDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.webhooks().destinations().retrieveDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->retrieveDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.retrieve_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.RetrieveDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000001",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 503,
  "response_time_ms": 412,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-15T09:21:18.412345Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"a5e02a03404e1337a0198e6be15d34abbd053c658a0e51e5d0e78554213ef29b\", \"X-Signature-V2\": \"927e7cb770c94ce745939bff73f04aa200015f3bc64795ba46c2aaf78a6cedc5\", \"X-Signature-Simple\": \"e37b0d4c716c72bb5ae7127b9cc455d28ab4686e9e22312b4ec2327409a73302\", \"X-Timestamp\": \"1792056078\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792056078,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

GET

webhook

destinations

{destination_uuid}

deliveries

{delivery_uuid}

curl

curl -X GET 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.retrieve_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.retrieveDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.RetrieveDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.webhooks().destinations().retrieveDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->retrieveDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.retrieve_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.RetrieveDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000001",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 503,
  "response_time_ms": 412,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-15T09:21:18.412345Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"a5e02a03404e1337a0198e6be15d34abbd053c658a0e51e5d0e78554213ef29b\", \"X-Signature-V2\": \"927e7cb770c94ce745939bff73f04aa200015f3bc64795ba46c2aaf78a6cedc5\", \"X-Signature-Simple\": \"e37b0d4c716c72bb5ae7127b9cc455d28ab4686e9e22312b4ec2327409a73302\", \"X-Timestamp\": \"1792056078\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792056078,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

Para comprobar tu código de firma con una entrega real, vuelve a calcular X-Signature-V2 a partir de request_body con la secret_shared_key del destino, como se describe en Verificación de firma. Usa para ello una clave de API con acceso completo: un cuerpo con valores censurados ya no coincide con sus firmas. Para volver a enviar la entrega, invoca Reenviar entrega de destino de webhook.

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 al que se envió la entrega.

delivery_uuid

string<uuid>

requerido

UUID de la entrega: el uuid de una entrada devuelta por GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Respuesta

La entrega, con los encabezados y el cuerpo de su solicitud.

Un intento de entrega a un destino de webhook, con los encabezados y el cuerpo exactos de la solicitud que envió Didit.

uuid

string<uuid>

requerido

ID de entrega, para las llamadas de detalle y de reenvío.

session_id

string<uuid> | null

requerido

Sesión de verificación de usuario a la que se refiere el evento. null para los eventos de sesiones de empresa, usuarios, empresas, transacciones, Travel Rule y flujos.

request_url

string<uri> | null

requerido

URL a la que se envió la entrega: la URL del destino en el momento en que se generó el evento.

response_status

integer | null

requerido

Estado HTTP que devolvió tu endpoint. null mientras la entrega está en cola y aún no se ha intentado. Cuando no se recibe ninguna respuesta HTTP, Didit registra un estado propio: 504 cuando tu endpoint no respondió en 5 segundos, 503 para un fallo de conexión, 400 cuando la URL se rechazó por no ser segura (por ejemplo, una dirección privada o interna) y 404 para cualquier otro error de la solicitud. 400 o superior cuenta como entrega fallida.

response_time_ms

integer | null

requerido

Tiempo que tardó el intento, en milisegundos. null mientras la entrega está en cola.

Rango requerido: x >= 0

status

string | null

requerido

Estado que informó el evento cuando se generó: el estado de la sesión para los eventos de sesión (por ejemplo, Approved o In Review), el estado de la persona o de la empresa para los eventos de usuario y de empresa, y el estado de la transacción para los eventos de transacción. null para los eventos que no incluyen ningún estado.

webhook_type

enum<string>

requerido

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

created_at

string<date-time>

requerido

Cuándo se creó la entrega.

request_header

string

requerido

Texto JSON (una cadena) de los encabezados de la solicitud que envió Didit: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp y User-Agent. Analízalo con un parser JSON. Contiene firmas, nunca el secreto de firma.

request_body

string

requerido

Texto JSON (una cadena) del payload exacto que envió Didit, con las claves ordenadas, incluidos event_id y timestamp. Analízalo con un parser JSON; consulta Estructura del payload. Para una clave con alcance limitado sin media: read, las URL de medios que contiene son null; sin sessions: write, los tokens de sesión y los enlaces de verificación alojados son null. Un cuerpo modificado de esa forma ya no coincide con sus firmas. Didit no registra el cuerpo de la respuesta que devolvió tu endpoint.

Última modificación el 1 de noviembre de 2026