Skip to main content
Ao final deste passo o seu backend recebe os eventos da verificação sozinho, sem perguntar. Sem webhook, o seu sistema só sabe do resultado se ficar consultando. O catálogo de eventos, o formato do envelope e a conferência da assinatura estão em webhooks. Aqui está como cadastrar o endpoint e confirmar que ele responde.

​
Cadastre o endpoint

1

Abra Webhooks

Em Integrações, abra a sua integração e vá em Segurança → Webhooks.
2

Preencha o formulário

Clique em Novo Endpoint e informe:
  • URL do endpoint — a rota do seu backend que recebe o POST, por exemplo https://api.suaempresa.com.br/webhooks/legitimuz.
  • Eventos — ao menos um. A lista é fechada: só entram eventos do catálogo, porque salvar um nome livre significaria esperar para sempre por um evento que nunca dispara.
Aba Webhooks da integração, com o formulário Novo Endpoint aberto, a URL preenchida e a lista de eventos
3

Crie

Clique em Criar Endpoint. O segredo de assinatura nasce junto com o endpoint.
4

Dispare um teste

Com o endpoint selecionado, clique em Testar. A Legitimuz envia um evento real para a sua URL e ele aparece em Entregas.

​
Toda entrega é assinada

Não existe caminho para entrega sem assinatura: o segredo nasce com o endpoint e não há opção de desligar. O seu handler precisa conferir a assinatura antes de confiar no corpo — o passo a passo da conferência está em webhooks.
Confira a assinatura sobre o corpo cru, byte a byte, antes de qualquer JSON.parse. Reserializar o JSON muda bytes e quebra a conferência, mesmo com o segredo certo.

​
Confira que funcionou

Em Entregas, a linha do evento de teste mostra: Status lógico e HTTP são coisas diferentes, e os dois aparecem. Se o seu endpoint respondeu 2xx, está pronto. O Status do endpoint na listagem passa a Ativo. Falhando é veredito do sistema sobre as entregas, não algo que você configura — se aparecer, a causa está no seu lado.

​
Próximo passo

6. Integrar

Emita a sdkUrl no seu backend e monte o widget na sua página.