Verificação de identidade chegou a APPROVED, FAILED ou EXPIRED
Enviado quando uma verificação de identidade standalone chega a um estado
terminal: APPROVED, FAILED ou EXPIRED. PENDING nunca gera este evento.
Como a verificação pertence ao tenant e não a uma conta, o envelope não traz
accountId.
Cada entrega inclui X-Signature. Valide a assinatura contra os bytes
brutos do corpo antes de interpretar o JSON e deduplique pelo id do
envelope.
Campos em data:
verificationId: id retornado por POST /v1/identity-verifications;status: APPROVED, FAILED ou EXPIRED;purpose e referenceId: vínculo exato definido na criação;document: CPF de 11 dígitos;failureReason: motivo normalizado em falha/expiração; null na aprovação;completedAt: instante terminal em UTC;consumableUntil: limite para consumir uma aprovação; omitido nos demais
estados.Present when the subscription uses authType: HMAC: hex(HMAC_SHA256(secret, raw_request_body)) (64 lowercase hex characters). Compare in constant time against your own computation over the raw body.
Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.
Event type. Full list at GET /v1/webhooks/events.
RFC 3339, UTC with Z.
1.0 today; bumped only on breaking payload changes.
Event-specific payload. See each webhook.
CorpX account where the event happened. Empty on cross-account events.
Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).