Dois tipos de webhook (não misture)
1) Webhook de saída Emitfy → seu sistema: status fiscal, companyId, taxId. CRUD em /v1/webhooks.
2) Webhook de entrada (integração): Hotmart/Kiwify/API genérica envia venda para a Emitfy emitir.
Docs: https://docs.emitfy.com/webhooks e https://docs.emitfy.com/integrations/api-webhook.
Boas práticas
- Endpoint HTTPS idempotente
- Validar assinatura/segredo conforme docs
- Responder 2xx rápido e processar async
- Reprocessar com backoff em falhas
- Logar correlation id / invoice id
Perguntas frequentes
Os webhooks incluem XML?
O payload notifica o evento; o download de XML/PDF segue os endpoints de invoice documentados na API.
Preciso de webhook se uso só o dashboard?
Não. Webhooks são para sistemas que precisam reagir programaticamente.
Automatize a emissão fiscal com a Emitfy
Conecte sua plataforma ou use a API REST. 10 notas grátis, sem cartão. Garantia de 7 dias se o produto não atender às expectativas.
Começar grátis