Token Biometrico

Este artigo explica como verificar a autenticidade de um usuário que passou previamente pelo Score de Autenticação (CreateProcess), fornecendo agora uma nova foto a ser comparada com a foto do processo do score de autenticação, utilizando a REST API do Unico Check.

O Token Biométrico é uma funcionalidade do Unico Check para situações em que um usuário que passou previamente pelo Score de Autenticação (CreateProcess) deseja se autenticar, fornecendo uma nova foto

Como usar?

Faça uma requisição POST para o endpoint:

Produção: https://www4.acesso.io/services/v3/biometry/token

Homologação: https://crediariohomolog.acesso.io/services/v3/biometry/token

Com o token de acesso válido, faça uma requisição para um dos endpoints acima enviando os seguintes parâmetros:

{
  "processId": "ID_PROCESSO_SCORE",
  "selfie": "FOTO_PESSOA"
}

Parametros:

• HEADER PARAMETERS

Nome	Tipo	Mandatorio/Opcional	Descrição
APIKEY	String	Mandatório	API key
Authorization	String	Mandatório	Token de acesso
X-Tenant	String	Mandatório	Identificador exclusivo da empresa

• REQUEST BODY SCHEMA

Nome	Tipo	Mandatorio/Opcional	Descrição
processId	String	Mandatório	Identificador do processo de score de autenticação (1:N) que será usado como base para comparação com a selfie fornecida
selfie	String	Mandatório	Foto do pessoa. A imagem precisa ser em base64 (png, jpg, jpeg). Caso a captura da foto seja por meio do SDK da Unico com Liveness, a imagem enviada deve ser o Json Web Token (.jwt). O .JWT deve ser enviado em até 10 minutos evitando assim que a imagem expire. E esse .jwt só pode ser usado uma única vez.

Exemplo de requisição:

Arquivo JSON

{
  "processId": "D7A8B471-E69C-42B7-AF14-05E83365A944",
  "selfie": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg=="
}

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON contendo o status da verificação como a seguir:

{
  "authenticated": true
}

O authenticated é um boolean indicando se a foto enviada na requsição é da mesma pessoa que passou pelo score de atenticação.

Erro na Requisição

Caso ocorra algum erro, a resposta de retorno é um JSON contendo o código e descrição do erro:

{
    "Error": {
        "code": "40004",
        "description": "Descrição do erro"
    }
}

Para mais infomações sobre os erros retornados, consulte a lista disponível no artigo Response Errors.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.