identity.verification.completed
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 porPOST /v1/identity-verifications;status:APPROVED,FAILEDouEXPIRED;purposeereferenceId: vínculo exato definido na criação;document: CPF de 11 dígitos;failureReason: motivo normalizado em falha/expiração;nullna aprovação;completedAt: instante terminal em UTC;consumableUntil: limite para consumir uma aprovação; omitido nos demais estados;method:link(página hospedada) oufacetec_sdk(SDK no app);referenceMatchechecks: só emfacetec_sdk.checks.livenessé o resultado da prova de vida echecks.faceMatch.resulto da comparação 1:1 (not_performedquandoreferenceMatchénone— a aprovação prova só que havia uma pessoa viva, não quem ela é).
Headers
Present when the subscription uses authType: HMAC: base64(HMAC_SHA256(secret, raw_request_body)) (standard Base64, with padding). Compare in constant time against your own computation over the raw body.
Payload
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.
Response
Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).