Signdocs Com Br Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.signdocs.com.br/guias/webhooks.html
sources:
- https://docs.signdocs.com.br/guias/webhooks.html
- https://docs.signdocs.com.br/guias/sdk-webhooks.html
description: Webhooks allow real‑time notifications for events occurring in the SignDocs Brasil platform.
events:
- event: TRANSACTION.CREATED
  description: Uma nova transação foi criada.
- event: TRANSACTION.COMPLETED
  description: Todas as etapas foram concluídas com sucesso e o Evidence Pack foi gerado.
- event: TRANSACTION.CANCELLED
  description: A transação foi cancelada (por chamada de API ou ação administrativa).
- event: TRANSACTION.FAILED
  description: 'Falha terminal: todas as etapas passaram e a finalização ainda assim não produziu documento assinado.'
- event: TRANSACTION.EXPIRED
  description: A transação expirou sem que todas as etapas fossem concluídas dentro do prazo.
- event: TRANSACTION.FALLBACK
  description: A transação caiu para a política alternativa após falha na primária.
- event: TRANSACTION.DEADLINE_APPROACHING
  description: (NT65) Faltam ≤2 dias úteis para o prazo de submissão ao INSS.
- event: STEP.PURPOSE_DISCLOSURE_SENT
  description: (NT65) Notificação de divulgação de finalidade enviada ao beneficiário.
- event: SIGNING_SESSION.CREATED
  description: Uma nova sessão de assinatura expressa foi criada.
- event: SIGNING_SESSION.COMPLETED
  description: A sessão foi concluída — todas as etapas finalizadas e Evidence Pack gerado.
- event: SIGNING_SESSION.CANCELLED
  description: A sessão foi cancelada pelo integrador via API.
- event: SIGNING_SESSION.EXPIRED
  description: A sessão expirou antes de ser concluída pelo signatário.
- event: ENVELOPE.CREATED
  description: Envelope multi-assinante criado.
- event: ENVELOPE.ALL_SIGNED
  description: Todas as assinaturas do envelope foram concluídas.
- event: ENVELOPE.CANCELLED
  description: Envelope cancelado; as assinaturas pendentes são encerradas.
- event: ENVELOPE.EXPIRED
  description: Envelope expirou com uma ou mais assinaturas pendentes.
- event: ENROLLMENT.EXPIRING
  description: A foto de referência será destruída em breve — 30 e 7 dias antes.
- event: ENROLLMENT.EXPIRED
  description: A foto de referência foi destruída hoje; o usuário precisa de novo cadastro para assinar.
- event: QUOTA.WARNING
  description: O uso mensal de uma dimensão cruzou 80% do limite do plano.
- event: API.DEPRECATION_NOTICE
  description: Você chamou um endpoint marcado como deprecated.
delivery:
  signature: HMAC-SHA256
  content_type: application/json (POST body as raw text for signature verification)
note: 'Each webhook delivery includes two headers: X-SignDocs-Signature (hexadecimal HMAC‑SHA256) and X-SignDocs-Timestamp (Unix seconds). The
  signature is computed as HMAC‑SHA256("{timestamp}.{body}", secret) with a default tolerance of 300 seconds (5 minutes). The secret is returned
  only once at webhook creation and must be stored securely.'
docs: https://docs.signdocs.com.br/guias/webhooks.html