Pular para o conteúdo principal

Cenários de Response

Este artigo exemplifica os possíveis cenários de response dos métodos CreateProcess e GetProcess para API Key Síncrona. Para mais informações leia o artigo Análise Biométrica.

IDUnico + IDCheck

Cenário: Processo não finalizado

Ocorre quando o IDUnico ainda está processando a transação (somente na API assíncrona)

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1
}

Cenário: Resultado SIM do IDUnico

Ocorre quando o IDUnico devolve 100% de certeza que a biometria é do titular do CPF.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "yes"
}
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "yes"
}
}

Cenário: Resultado NÃO do IDUnico

Ocorre quando o IDUnico devolve que a biometria NÃO É do titular do CPF.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "no"
}
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "no"
}
}
Importante
  • Caso o retorno do IDUnico seja "no", não haverá orquestração com o IDCheck, ou seja, não terá o score de risco no retorno da API.

Cenário: Resultado INCONCLUSIVO do IDUnico e Liveness Reprovado

Ocorre quando o IDUnico não consegue validar a titularidade do CPF, pois a prova de vida foi recusada.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
"liveness": 2
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
"liveness": 2
}
Atenção
  • O retorno de Liveness = 2 (reprovado) só acontecerá caso utilize a SDK da Unico com Prova de vida.

Cenário: Resultado INCONCLUSIVO do IDUnico, Liveness Aprovado e Score no IDCheck

Ocorre quando o IDUnico não consegue validar com 100% de certeza que a biometria é do titular do CPF, mas a pessoa está ao vivo. Desta forma, o IDCheck devolve o score de probabilidade daquela pessoa ser o titular do CPF.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1,
"score": 10
}

Cenário: Resultado INCONCLUSIVO do IDUnico, Liveness Aprovado e Divergência no IDCheck

Ocorre quando o IDUnico não consegue validar com 100% de certeza que a biometria é do titular do CPF, a pessoa está ao vivo, mas o IDCheck devolveu uma divergência quanto a real titularidade do CPF (deve-se realizar o getProcess para obter o retorno do score de forma assíncrona).

Observação: Este não é um status final do processo.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 2,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1
}

Cenário: Resultado INCONCLUSIVO do IDUnico, Liveness Aprovado e Drop no IDCheck

Ocorre quando o IDUnico não consegue validar com 100% de certeza que a biometria é do titular do CPF, a pessoa está ao vivo, mas o IDCheck não conseguiu processar o score de autenticação (entende-se como drop no check).

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
"liveness": 1
}

Cenário: Processo com erro

Ocorre quando há algum erro na transação e não foi possível processar o cadastro.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 5
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 5
}

IDUnico

Cenário: Processo não finalizado

Ocorre quando o IDUnico ainda está processando a transação (somente na API assíncrona).

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 1
}

Cenário: Resultado SIM do IDUnico

Ocorre quando o IDUnico devolve 100% de certeza que a biometria é do titular do CPF.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "yes"
}
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "yes"
}
}

Cenário: Resultado NÃO do IDUnico

Ocorre quando o IDUnico devolve que a biometria NÃO É do titular do CPF.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "no"
}
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "no"
}
}
Importante
  • Caso o retorno do IDUnico seja "no", não haverá orquestração com o IDCheck, ou seja, não terá o score de risco no retorno da API.

Cenário: Resultado INCONCLUSIVO do IDUnico e/ou Liveness Reprovado

Ocorre quando o IDUnico não consegue validar a titularidade do CPF e/ou a prova de vida foi recusada.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 3,
"unicoId": {
"result": "inconclusive"
},
}

Cenário: Processo com erro

Ocorre quando há algum erro na transação e não foi possível processar o cadastro.

CreateProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 5
}
GetProcess
{
"id": "fc7219f8-ee00-4489-8427-910b0cceffdd",
"status": 5
}

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.