Token Biometrico

Este artigo explica como verificar a autenticidade de um usuário que criou uma transação biométrica no IDUnico através do método CreateProcess. Com o método BiometryToken, o usuário fornece uma nova foto para ser comparada com a foto que foi previamente cadastrada.

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_DO_PROCESSO",
  "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 que foi gerado durante a criação da transação.
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 criou a transação no IDUnico.

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.