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:
{
"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.