Comprove presença com uma selfie só, sem pedir movimento
Em breve A venda deste módulo está em preparação: ele ainda não entra num flow.
Pedir que o titular vire a cabeça ou siga um ponto na tela custa conversão, principalmente em aparelho simples e conexão fraca. Este módulo dispensa o desafio: a pessoa tira uma selfie de perto, como faria em qualquer aplicativo, e a análise procura ali os sinais de um artefato apresentado no lugar dela.
Confirma a prova de vida com uma selfie só, sem desafio: procura sinais de ataque de apresentação, como foto impressa ou tela, e devolve uma pontuação de vivacidade. Se o fluxo leu o documento, compara a selfie com o rosto do documento no mesmo passo, por isso não entra junto com o Face Match. Quando a evidência é uma imagem única, a resposta marca isso, porque uma imagem só sustenta menos que a sequência de quadros da captura.
- Liveness PassivoEm breve
"status": "approved"Para quem é
Serve a quem precisa de prova de presença num cadastro de baixo atrito: carteira digital, marketplace que credencia vendedor, aplicativo de entrega que confere o entregador antes do turno, programa de fidelidade que paga bônus no primeiro acesso. São jornadas em que cada tela a mais derruba o funil e o risco por conta é moderado.
Também atende quem já lê o documento no mesmo fluxo e quer resolver presença e semelhança facial numa etapa única. Como a comparação com o rosto impresso vem incluída, o flow fica menor e a cobrança fica numa linha. Para jornadas de risco alto, como crédito com valor relevante, a prova de vida com desafio continua sendo a escolha mais robusta.
O que você recebe
O bloco liveness traz a score de vivacidade, a band (real, ambiguous ou spoof), a versão da calibração aplicada e o evidence_level. Esse último campo conta se a decisão se apoiou na sequência de quadros gravada logo depois do disparo (sequence) ou apenas na fotografia isolada (single_image). A sequência só vale com os quadros do mesmo rosto da selfie. No segundo caso o aviso single_image_evidence acompanha a resposta e a verificação vai à revisão humana, porque uma imagem sozinha sustenta menos e nunca aprova no automático.
O bloco match diz se a selfie corresponde ao rosto do documento lido no mesmo fluxo: match, no_match, not_requested quando o flow não tem documento e unavailable quando a comparação não pôde acontecer. A lista warnings é fechada, cada código com severidade própria, e o status resume tudo em approved, declined, recapture ou review. Nada de idade, gênero ou vetor facial sai no resultado.
O módulo passive_liveness faz a prova de vida com uma selfie, sem desafio, e compara a selfie com o documento do mesmo flow quando ele existe, com o payload de resultado.
O módulo se chama passive_liveness no flow e no webhook.
Como entra no seu flow
Ligue o módulo no flow sozinho ou ao lado de cpf_ocr ou doc_global. Ele não depende de outro módulo, mas não convive com o Face Match: a semelhança com o documento já está dentro dele, e a API recusa a combinação com o código passive_liveness_includes_face_match. Ele também não toma o lugar da prova com desafio onde um módulo a exige.
Trate o desfecho pelo webhook. recapture significa que a foto não serviu e o próprio widget pede outra; review leva o caso à fila do seu time, como na faixa ambígua; declined encerra a verificação. Pontuação e similaridade chegam só ao seu servidor, nunca ao navegador do titular.
O grupo do módulo
Documento, selfie e prova de vida capturados pelo widget, com o resultado de cada etapa no seu webhook.
Preço
-por verificaçãoEm breve
A venda está em preparação e o valor acima é o de catálogo. Módulo marcado como "Em breve" não está à venda e não pode ser adicionado a um flow hoje.
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoQuando escolher a prova passiva em vez da prova com desafio?
Quando o atrito pesa mais que o risco da conta. A passiva pede só a selfie e encurta a jornada; a com desafio pede movimentos e entrega uma evidência mais forte contra ataque elaborado. Muitos produtos usam a passiva no cadastro e reservam a outra para o momento sensível, como um saque.
Preciso ter documento no fluxo?
Não. Sem documento, o módulo entrega só a prova de vida e o match chega not_requested, com o aviso informativo match_reference_missing. Com documento, a semelhança entre a selfie e a foto dele vem na mesma resposta, sem módulo extra.
O que faço com o aviso de imagem única?
Ele aparece quando os quadros posteriores à selfie não chegaram ou não confirmaram a fotografia, o que acontece em aparelho lento ou conexão instável. A verificação segue a decisão do motor; o aviso existe para a sua política tratar esses casos de forma diferente, se quiser.
Crie a conta, monte um flow com os módulos que já estão à venda e rode a verificação inteira no ambiente de teste, sem consumir saldo.
