Live ID Validation

Adicione login biométrico ao seu aplicativo — confirme um usuário recorrente comparando uma selfie ao vivo com o rosto KYC já verificado dele na Certivant, e controle o acesso com um simples resultado matched true/false.

Live ID Validation transforma a identidade KYC já verificada de um cliente em um fator de login biométrico. No momento do login, o usuário tira uma selfie ao vivo; a Certivant a compara com o rosto KYC verificado dele (o mesmo pipeline de comparação facial e prova de vida usado durante o onboarding) e retorna um simples matched: true | false, que você usa para controlar o acesso.

Live ID Validation (este recurso) reautentica um usuário recorrente. Ele é diferente da videoconferência de Verificação ao vivo (uma chamada de onboarding assistida por uma pessoa). Recurso diferente, nome diferente.

Como funciona

graph LR
  A[User starts login] --> B[Your backend mints a session]
  B -->|holds the Identification Key| C[Certivant verifies key, returns sessionToken + captureUrl]
  C --> D[Device opens captureUrl in a WebView]
  D --> E[Selfie -> face match + liveness]
  E --> F[Your backend reads matched]
  F -->|matched true| G[Grant login]
  F -->|matched false| H[Deny / fall back]

A Chave de Identificação criptografada é sua credencial de longa duração, por perfil. Ela permanece no seu backend — o dispositivo só recebe um token de sessão de uso único e curta duração (TTL padrão de 120 s). A chave é protegida com AES-256-GCM e com uma assinatura Ed25519, de modo que qualquer alteração de um único bit é rejeitada no servidor; o token de sessão só consegue fazer uma coisa: enviar uma selfie para um perfil.

Pré-requisitos

Um perfil verificado e cadastrado. Um solicitante de KYC se torna elegível ao Live ID assim que sua solicitação estiver APPROVED e o Live ID estiver habilitado para a sua organização. O cadastro é automático na aprovação — ele captura a selfie verificada como face de referência.

Live ID habilitado + limites. Ative em KYC → Configurações → Live ID (liveIdEnabled), onde também são definidos a pontuação mínima de comparação facial, se a prova de vida é obrigatória e o TTL da sessão.

Um plano com capacidade de Live ID. A cota Validações Live ID incluídas por mês do seu plano cobre as validações gratuitas; além dela, cada validação é cobrada como Preço por Validação Live ID (PAYG) no seu saldo da conta. Veja Faturamento.

Uma Chave de Identificação por perfil. Emita uma em KYC → Live ID → Chaves (ou pela API de chaves) para um perfil cadastrado. Armazene-a no seu backend, vinculada ao seu usuário.

Integre em quatro passos

Crie uma sessão — no servidor. Quando um usuário inicia o login, seu backend envia a Chave de Identificação dele para a Certivant e recebe de volta um sessionToken e um captureUrl.

curl -X POST https://app.certivant.com/api/kyc/public/live-id/sessions \
  -H "Content-Type: application/json" \
  -d '{"key":"livid_…"}'
# → { "sessionToken": "…", "captureUrl": "https://…/live-id/…", "expiresAt": "…" }

Abra a página de captura. Envie o dispositivo para o captureUrl — uma página hospedada, pensada para celular, que cuida da câmera, da selfie e da tela de resultado. Na web, abra-a em um pop-up ou em um redirecionamento; em um aplicativo móvel, carregue-a em um WebView (veja Integração móvel).

Leia o resultado. Assine o webhook live_id.validation.completed (recomendado) ou faça polling em GET /api/kyc/public/live-id/sessions/:sessionToken até que status seja completed e leia matched.

Controle o login. matched === true → conceda o acesso. false → negue ou recorra a outro fator. Cada validação concluída é medida (e cobrada, se ultrapassar a cota).

Veja os formatos completos de requisição e resposta na Referência da API.

Por que a chave nunca chega ao dispositivo

Colocar a Chave de Identificação no código do cliente permitiria que qualquer pessoa que a extraísse criasse sessões para qualquer um dos seus usuários. Por isso:

A chave fica no seu backend e é usada apenas na chamada servidor-a-servidor POST /sessions.
O token de sessão que o dispositivo recebe é de uso único, de curta duração e vinculado a exatamente um perfil cadastrado. Enviar uma selfie é tudo o que ele pode fazer.
Uma chave adulterada é rejeitada antes de qualquer processamento (dois controles de integridade independentes: a tag de autenticação GCM e a assinatura Ed25519).

Faturamento

O Live ID considera a cota:

Validações dentro da cota mensal incluída do seu plano são gratuitas (mas são medidas).
Acima da cota, cada validação é cobrada como Preço por Validação Live ID do seu saldo da conta em dólares.
Se a próxima validação for PAYG e o seu saldo não cobrir o valor, POST /sessions retorna 402 verification_unavailable — o fluxo falha rapidamente, antes que o usuário abra a câmera, para que você possa adicionar saldo ou recorrer a outro método.

Organizações em período de teste usam a cota Validações Live ID de teste por mês do plano. O uso aparece no seu registro mensal de uso de KYC.

Próximos passos

Referência da API — crie, capture, consulte e valide sessões, além do payload do webhook.
Integração móvel — incorporação com WebView e aplicativos de exemplo para iOS, Android e .NET MAUI.