Pular para o conteúdo principal
POST
curl
Cada chamada reenvia o webhook. Torne seu endpoint idempotente em relação a event_id antes de reenviar em massa, e reenvie apenas as entregas cujo response_status seja null, 400 ou superior.
O reenvio é enviado para a URL usada pela entrega original. Se você moveu o destino para uma nova URL, as entregas antigas continuam apontando para a URL antiga. Encontre as entregas a reenviar com Listar entregas do destino do webhook e consulte o guia de webhooks para a verificação de assinatura.

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

destination_uuid
string<uuid>
obrigatório

UUID do destino para o qual a entrega foi enviada.

delivery_uuid
string<uuid>
obrigatório

UUID da entrega a ser reenviada: o uuid de um item retornado por GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Resposta

A nova entrega, já tentada. response_status é o que o seu endpoint respondeu desta vez (504 tempo esgotado, 503 falha de conexão). A entrega original permanece inalterada.

Uma tentativa de entrega a um destino do webhook, com os cabeçalhos e o corpo exatos da requisição que a Didit enviou.

uuid
string<uuid>
obrigatório

ID da entrega, para as chamadas de detalhe e reenvio.

session_id
string<uuid> | null
obrigatório

Sessão de verificação de usuário à qual o evento se refere. null para eventos de sessão de empresa, usuário, empresa, transação, Travel Rule e fluxo.

request_url
string<uri> | null
obrigatório

URL para a qual a entrega foi enviada: a URL do destino no momento em que o evento foi gerado.

response_status
integer | null
obrigatório

Status HTTP que seu endpoint retornou. null enquanto a entrega está na fila e ainda não foi tentada. Quando nenhuma resposta HTTP é recebida, a Didit registra um status próprio: 504 quando seu endpoint não respondeu em 5 segundos, 503 para falha de conexão, 400 quando a URL foi recusada como insegura (por exemplo, um endereço privado ou interno) e 404 para qualquer outro erro de requisição. 400 ou acima conta como entrega com falha.

response_time_ms
integer | null
obrigatório

Tempo que a tentativa levou, em milissegundos. null enquanto a entrega está na fila.

Intervalo obrigatório: x >= 0
status
string | null
obrigatório

Status informado pelo evento quando ele foi gerado: o status da sessão para eventos de sessão (por exemplo, Approved ou In Review), o status da pessoa ou da empresa para eventos de usuário e de empresa, e o status da transação para eventos de transação. null para eventos que não têm status.

webhook_type
enum<string>
obrigatório

Nome de evento de webhook compatível. Use exatamente estas strings em subscribed_events; valores não compatíveis são rejeitados.

Opções disponíveis:
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>
obrigatório

Quando a entrega foi criada.

request_header
string
obrigatório

Texto JSON (uma string) dos cabeçalhos da requisição que a Didit enviou: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp e User-Agent. Analise-o com um parser JSON. Ele contém assinaturas, nunca o segredo de assinatura.

request_body
string
obrigatório

Texto JSON (uma string) do payload exato que a Didit enviou, com as chaves ordenadas, incluindo event_id e timestamp. Analise-o com um parser JSON; consulte Formato do payload. Para uma chave com escopo sem media: read, as URLs de mídia dentro dele são null; sem sessions: write, os tokens de sessão e os links de verificação hospedados são null. Um corpo alterado dessa forma não corresponde mais às suas assinaturas. A Didit não registra o corpo da resposta que o seu endpoint retornou.

Última modificação em 1 de novembro de 2026