> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifokal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# A entrega assinada com o resultado da verificação a fonte da verdade

> Verifique a assinatura HMAC SHA-256 do header X-IDSAAS-Signature (formato t=<ts>,v1=<hex>, janela de 300s) antes de confiar no corpo. Responda 2xx rápido e deduplique pelo id do evento; sem 2xx, a entrega re-tenta com backoff exponencial, 3 tentativas no total, ao longo de cerca de 15 minutos; passada a janela a entrega para e o resgate é o replay (operação replayWebhookEvents). Crédito e aprovação no seu sistema só a partir do webhook VERIFICADO, nunca da resposta síncrona.



## OpenAPI

````yaml /api-reference/openapi.json webhook verification.completed
openapi: 3.1.0
info:
  title: UNIFOKAL API
  version: v1
  summary: >-
    Verificação de identidade: sessão criada no servidor, jornada no widget,
    resultado no webhook.
  description: >-
    A versão vive no caminho (/v1); não existe header de versão. Adição
    compatível (campo, módulo ou chave nova) NÃO sobe a versão: ignore o que não
    conhecer. Todo erro tem a forma { error, message }: o código é estável, a
    mensagem não. Ids são prefixo + ULID. Webhooks são assinados (HMAC SHA-256
    no header X-IDSAAS-Signature, janela de 300s; o segredo é SEU, mínimo 32
    caracteres) e o header x-idsaas-event carrega o tipo do evento.
  termsOfService: https://unifokal.com/termos
  contact:
    name: UNIFOKAL
    url: https://docs.unifokal.com/
servers:
  - url: https://api.unifokal.com/v1
security: []
externalDocs:
  description: >-
    Documentação completa em https://docs.unifokal.com/. Briefing para agentes
    de IA em https://unifokal.com/llms.txt.
  url: https://docs.unifokal.com/
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.