> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# identity.verification.completed

POST 

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 é).

Reference: https://en.docs.api.corpx.com/baas/referencia/webhook-events/webhook-identity-verification-completed

## Request

### Headers

- `X-Signature` (string, optional) — 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

- `id` (string, required) — Deterministic event id. Same `id` means the same event, possibly redelivered — deduplicate on it.
- `type` (enum, required) — Event type. Full list at `GET /v1/webhooks/events`.
  - Allowed values: `identity.verification.completed`
- `occurredAt` (datetime, required) — RFC 3339, UTC with `Z`.
- `schemaVersion` (string, required) — `1.0` today; bumped only on breaking payload changes.
- `environment` (enum, required) — Environment that emitted the event.
  - Allowed values: `production`, `sandbox`
- `tenantId` (string, required) — Tenant the event belongs to.
- `data` (WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `verificationId` (string, optional)
- `status` (string, optional)
- `purpose` (string, optional)
- `referenceId` (string, optional)
- `document` (string, optional)
- `failureReason` (string, optional, nullable)
- `completedAt` (datetime, optional)
- `consumableUntil` (datetime, optional)
- `method` (string, optional)
- `referenceMatch` (string, optional)
- `checks` (WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaDataChecks, optional)

### WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaDataChecks

- `liveness` (string, optional)
- `faceMatch` (WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaDataChecksFaceMatch, optional)

### WebhooksWebhookIdentityVerificationCompletedPayloadContentApplicationJsonSchemaDataChecksFaceMatch

- `result` (string, optional)
- `reference` (string, optional)