Skip to navigation

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 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;
  • method: link (página hospedada) ou facetec_sdk (SDK no app);
  • referenceMatch e checks: só em facetec_sdk. checks.liveness é o resultado da prova de vida e checks.faceMatch.result o da comparação 1:1 (not_performed quando referenceMatch é none — a aprovação prova só que havia uma pessoa viva, não quem ela é).

Headers

X-SignaturestringOptional

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

The payload of this webhook request is an object.
idstringRequired

Deterministic event id. Same id means the same event, possibly redelivered — deduplicate on it.

typeenumRequired

Event type. Full list at GET /v1/webhooks/events.

Allowed values:
occurredAtdatetimeRequired

RFC 3339, UTC with Z.

schemaVersionstringRequired

1.0 today; bumped only on breaking payload changes.

environmentenumRequired
Environment that emitted the event.
Allowed values:
tenantIdstringRequired
Tenant the event belongs to.
dataobjectRequired

Event-specific payload. See each webhook.

accountIdstringOptional

CorpX account where the event happened. Empty on cross-account events.

Response

2XX

Acknowledged. Any 2xx within 10 seconds stops retries; anything else is retried with backoff (see the Webhooks guide).