Saltar para o conteúdo principal
POST
curl
O reenvio é enviado para o URL guardado na entrega, mesmo que tenha alterado o URL do destino desde então. Como o payload mantém o seu event_id, um recetor que elimina duplicados com base no event_id trata o reenvio como o evento que já conhece.
Encontre a entrega a reenviar com Listar entregas de webhook de sessão.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

sessionId
string<uuid>
obrigatório

UUID da sessão de verificação, utilizador (KYC) ou empresa (KYB): o session_id retornado por POST /v3/session/. O servidor resolve-o em ambos os tipos de sessão.

Deve ser um UUID válido. A rota apenas faz correspondência com UUIDs bem formatados, pelo que um valor mal formatado é rejeitado pelo router de URL antes da execução de qualquer código da aplicação e a resposta é uma página HTML de 404 em vez do envelope JSON {"detail": ...} apresentado abaixo.

webhook_uuid
string<uuid>
obrigatório

UUID da entrega a reenviar: o uuid de uma entrada retornada por GET /v3/session/{sessionId}/webhooks/. Tem de pertencer à sessão no caminho.

Resposta

A nova entrega, já tentada. response_status é o que o seu endpoint respondeu desta vez. A entrega original permanece inalterada.

Uma tentativa de entrega de webhook registada para uma sessão de verificação, com os cabeçalhos e o corpo exatos do pedido enviados pela Didit.

uuid
string<uuid>
obrigatório

ID de entrega. Utilize-o como {webhook_uuid} para obter ou reenviar esta entrega.

session_id
string<uuid>
obrigatório

A sessão à qual a entrega pertence (a sessão no caminho).

request_url
string<uri> | null
obrigatório

URL para onde a entrega foi enviada.

response_status
integer | null
obrigatório

Código de estado HTTP devolvido pelo seu endpoint. null enquanto a entrega está na fila e ainda não foi tentada. Quando não foi recebida nenhuma resposta HTTP, a Didit regista um código de estado próprio: 504 quando o seu endpoint não respondeu no prazo de 5 segundos, 503 para uma falha de ligação, 400 quando o URL foi recusado por não ser seguro (por exemplo, um endereço privado ou interno) e 404 para qualquer outro erro no pedido. Valores iguais ou superiores a 400 contam como uma entrega com falha.

status
string | null
obrigatório

Estado da sessão quando o evento foi gerado, por exemplo In Progress, Approved ou Declined.

webhook_type
enum<string>
obrigatório

Nome de evento de webhook suportado. Utilize estas strings exatas em subscribed_events; valores não suportados 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
request_header
string
obrigatório

Texto JSON (uma string) dos cabeçalhos do pedido que a Didit enviou: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp e User-Agent. Efetue o parse com um analisador de JSON. 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 chaves ordenadas, incluindo event_id e timestamp. Efetue o parse com um analisador de JSON; consulte Formato do payload. Para uma chave com âmbito sem media: read, os URLs de multimédia no seu interior são null; sem sessions: write, os tokens de sessão e as ligações de verificação alojadas são null. Um corpo alterado dessa forma já não coincide com as suas assinaturas. A Didit não regista o corpo da resposta que o seu endpoint devolveu.

created_at
string<date-time>
obrigatório

Quando a entrega foi criada.

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