Skip to main content
O LegitID responde a uma pergunta: qual a confiança de que esta selfie pertence ao CPF informado? O seu servidor envia o CPF e uma selfie e recebe o Score de Identidade, de 0 a 100, sem abrir a jornada de verificação para o titular. A chamada é uma só, síncrona: POST /v1/legitid/verifications.

​
Quando usar

​
Como funciona

1

A Legitimuz consulta a própria base biométrica

Se a base tem o CPF e a comparação com a selfie é conclusiva, a consulta termina aqui.
2

Se não houver resposta conclusiva, consulta bases biométricas parceiras

Uma por vez, em ordem fixa. A primeira resposta conclusiva encerra a busca. Não há votação nem média entre bases. Resposta inconclusiva, CPF ausente naquela base ou tempo esgotado passam a vez para a próxima.
3

Se nenhuma base for conclusiva, entra a evidência auxiliar

Só quando pelo menos uma base achou o CPF e deu resultado inconclusivo. A idade e o gênero estimados na selfie são comparados com o cadastro do CPF: compatíveis dão 40, incompatíveis dão 20.
Quando a evidência auxiliar não pode ser feita, o score é 0. Isso acontece, por exemplo, quando a selfie não tem rosto, tem mais de um rosto, ou o cadastro do CPF não tem os dados para comparar. Quando nenhuma base tem o CPF, o score também é 0.

​
Régua do Score de Identidade

O identity_score assume só sete valores. A resposta da API traz só o número. A classificação e a recomendação ficam aqui, na documentação.

​
Recomendação por faixa

A recomendação é uma orientação. A política de decisão é sua: cada cliente define o que fazer com cada faixa, de acordo com o próprio risco.

​
Conclusivo, inconclusivo e sem evidência

​
10 não é 0

Os dois números ficam perto na régua e dizem coisas opostas.
  • 10 é evidência de que a selfie não é da pessoa dona do CPF. Uma base comparou e concluiu que não bate.
  • 0 é ausência de evidência. Nenhuma base conseguiu dizer quem é. Isso não fala a favor nem contra o titular.
Falha técnica nunca vira 10 nem 20. Quando nenhuma base consegue responder, a API devolve 503 E_LEGITID_UNAVAILABLE, não um score. O LegitID não consulta a Receita Federal. O CPF é conferido só pelo dígito verificador, então um CPF que não existe na Receita termina em 0, como qualquer CPF ausente das bases.

​
Identidade não é risco

O Score de Identidade responde se a pessoa é quem diz ser. Risco é outra pergunta: device, localização, histórico de fraude, reincidência. O LegitID não avalia risco. Uma selfie com score 100 diz que o rosto pertence ao CPF. Não diz que a transação é segura. Veja os dois eixos do score na verificação completa. O identity_score do LegitID tem régua própria, de sete níveis. Ele é independente do identity_score que chega no webhook verification.scored da verificação completa: os dois não estão na mesma escala e não devem ser comparados.

​
Limitações

O LegitID não faz prova de vida. Ele não verifica se a selfie foi capturada ao vivo: uma foto de uma foto é aceita e comparada como qualquer outra. O produto responde só se o rosto pertence ao dono do CPF. Se você precisa garantir que a pessoa está presente na captura, use a verificação completa, que tem prova de vida.
  • Envie uma selfie com um rosto só, de frente. Sem rosto ou com mais de um, a evidência auxiliar não roda: se nenhuma base for conclusiva, o score é 0.
  • O LegitID não lê documento e não confere situação cadastral na Receita Federal.
  • A resposta leva alguns segundos, e às vezes mais. Veja tempo de resposta.

​
Cobrança

Toda resposta 200 é cobrada, inclusive o score 0. Erros (400, 401, 403, 413, 415, 429 e 503) não são cobrados.

​
Liberar o LegitID na chave

A chamada exige uma chave de API com duas coisas:
  1. A permissão de criar verificação, a mesma da criação de verificação. No dashboard, ela aparece como Criar link de verificação.
  2. A liberação do LegitID. Só a equipe da Legitimuz liga essa liberação, na criação da chave ou depois, no escopo dela. Peça pelo suporte informando a integração e a chave.
Sem uma das duas, a chamada responde 403 E_FORBIDDEN. Veja chaves de API.

​
Sandbox

Numa integração sandbox, o LegitID não consulta nenhuma base biométrica. A chave sandbox recebe um score fixo por CPF de teste, com qualquer selfie JPEG ou PNG. CPF fora da lista recebe 0. São os mesmos CPFs de teste da verificação completa. Eles não pertencem a ninguém, e numa integração de produção não têm tratamento especial.

​
Próximo passo

Chamar a API

Os dois formatos de requisição, a resposta e os erros.

Chaves de API

Crie a chave com o escopo certo.