FULL FLOW, comparando o rosto capturado ao vivo com a foto do documento apresentado.
Quando a prova de vida é executada
A biometria facial só é incluída no tipo de fluxoFULL FLOW. Se você criar um link do tipo ID ONLY, o usuário apenas capturará a frente e o verso do documento, sem prova de vida.
Ramificação adaptativa: apenas selfie
Desde a versão 2.2.0, um linkFULL FLOW com fluxo adaptativo pode se resolver em uma de duas ramificações para um cliente que já se verificou antes:
A ramificação é resolvida no servidor e persistida uma única vez. Você a lê em
GET /verifications/{id}/status?include=operationGuid, no campo method. A prova de vida é executada nas duas ramificações: o que a ramificação FACE omite é a captura do documento, nunca o controle biométrico.
Anti-spoofing no Identity Link
O sistema aplica controles anti-spoofing em duas camadas:- Anti-spoofing facial: detecta tentativas de fraude com fotos, vídeos, máscaras ou telas.
- Anti-spoofing documental: verifica que o documento capturado não é uma foto de tela nem uma cópia impressa.
Estado dos serviços de anti-spoofing
Resposta de exemplo
O endpoint devolve 200 quando o serviço está operacional e 503 quando não está, com o mesmo schema nos dois casos. Se algum indicador mostrar
DOWN, as verificações que dependem desse serviço falharão até que ele seja restaurado.
Interpretação dos resultados
Durante o fluxoFULL FLOW, você recebe eventos de webhook específicos da etapa de registro facial:
O evento final
verification.successful só é disparado se tanto a captura documental quanto a prova de vida passarem por todos os controles.
A verificação não expõe pontuações biométricas nem indicadores separados de prova de vida. O resultado consolidado vive em
status (success ou failed); quando falha, errorMessage descreve a causa. Consulte também os eventos de webhook granulares para saber em qual etapa ocorreu a falha.Acesso aos frames da selfie
Você pode recuperar as imagens capturadas durante a prova de vida pelos endpoints de imagens:images da verificação: addFront e addBack são as faces do documento, e o array register contém os frames da selfie tirados durante a prova de vida, úteis para auditoria manual ou revisão de casos limítrofes.
Configuração de anti-spoofing no nível da empresa
O indicadorantiSpoofing da sua empresa controla se os controles anti-spoofing estão ativos. É um ajuste administrado pela VU e somente leitura para a API: fica exposto dentro do bloco company de GET /links/{id}.
PATCH /users/me/company não aceita antiSpoofing. Os ajustes de empresa que você pode modificar são name, color, logo, linkConfig e verificationConfig. Para alterar a política anti-spoofing, contate seu responsável de conta na VU.Se você precisa apenas da extração de dados documentais, sem verificação facial, crie sempre links do tipo
ID ONLY. Isso reduz o atrito para o usuário final nos casos em que a biometria não é necessária.