Unico IDCloud - DevCenter
Página inicialAutenticaçãoAPIsSDKs
Portuguese (Brazil)
Portuguese (Brazil)
  • Introdução
  • SOBRE O IDCLOUD
    • Unico IDCloud
    • Capacidades
    • Meios de Integração
    • Capacidades e Meios de Integração
  • INTEGRAÇÃO
    • Guia de início rápido
    • Autenticação
      • Criando uma Conta de Serviço
      • Preparando para fazer uma requisição autenticada à API
      • Recursos adicionais
        • Exemplo em Javascript
        • Erros de autenticação
        • Postman Collection
    • Integração by Unico
      • Visão Geral
      • API
        • API Reference
          • Criação do Processo
            • Criação de processos separados por flows
          • Consultar Resultado do Processo
          • Obter Selfie do Usuário
          • Obter Conjunto Probatório
            • Especificação do conjunto probatório
          • Obter Documento Assinado
          • Obter Conjunto Probatório do Documento Assinado
        • Erros
      • Controlando a experiência
        • Redirecionando o usuário
        • SDK
        • QR Code
        • Personalizações
      • Recursos adicionais
        • Postman Collection
        • PoCs disponíveis
    • Integração by Client
      • Visão Geral
      • API
        • API Reference
          • Prova de vida + Verificação de Identidade + Alerta de comportamento
          • Prova de vida + Verificação de Identidade + Alerta de comportamento + Score de risco
          • Prova de vida + Validação 1:1 + Alerta de comportamento
          • Reaproveitamento e captura de documentos
        • Cenários de response
        • Erros
        • Recursos adicionais
          • Postman Collection
      • Padrão de captura (sem SDK)
    • Webhook
    • SDK
      • Visão Geral
      • Política de atualizações
      • Integração SDKs
        • SDK Android
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização Android
          • Solução de problemas
          • Release notes
        • SDK iOS
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização iOS
          • Solução de problemas
          • Release notes
        • SDK Flutter
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização Flutter
          • Solução de problemas
          • Release notes
        • SDK Web
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
            • Acessibilidade
          • Guia de tratamento de erros
          • Personalização Web
          • Release notes
      • Recursos adicionais
        • PoCs disponíveis
        • Melhores práticas de implementação da SDK
  • help & faq
    • Glossário
    • FAQs
      • FAQ IDCloud
      • FAQ Autenticação
      • FAQ SDK
    • Central de ajuda
Fornecido por GitBook

Institucional

  • Sobre nós

Copyright © 2024 unico. All rights reserved

Nesta página
  • Prova de vida
  • Prova de vida + Verificação de Identidade
  • Prova de vida + Verificação de Identidade + Score de risco
  • Prova de vida + Verificação de Identidade + Alerta de comportamento
  • Prova de vida + Verificação de Identidade + Alerta de comportamento + Score de risco

Isto foi útil?

Exportar como PDF
  1. INTEGRAÇÃO
  2. Integração by Client
  3. API

Cenários de response

Nesta seção, você encontrará os responses possíveis das combinações de capacidades separados por seus métodos, para facilitar seu entendimento sobre a integração by Client

AnteriorReaproveitamento e captura de documentosPróximoErros

Atualizado há 19 dias

Isto foi útil?


Entender como funciona o retorno de cada parâmetro é fundamental para implementar a melhor tomada de decisão. Para ver detalhadamente o significado de cada parâmetro, veja a seção .

Em todas as combinações descritas a seguir, caso ocorra algum erro no processamento, o processo retornará um status = 5. Por esse motivo, os cenários abaixo não exibem responses referentes a essa condição. Exemplo:

  {
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 5 //indica que houve um erro no processo
  }

Prova de vida


Prova de vida

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "liveness": 1
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "liveness": 1
}
Prova de vida

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "liveness": 2
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "liveness": 2
}

Para os cenários onde o response no CreateProcess é o mesmo que o response do GetProcess, otimize sua aplicação e tome sua decisão de forma síncrona.

Prova de vida + Verificação de Identidade


Para os cenários onde o response no CreateProcess é o mesmo que o response do GetProcess, otimize sua aplicação e tome sua decisão de forma síncrona.

Prova de vida + Verificação de Identidade + Score de risco


Para os cenários onde o response no CreateProcess é o mesmo que o response do GetProcess, otimize sua aplicação e tome sua decisão de forma síncrona.

Prova de vida + Verificação de Identidade + Alerta de comportamento


Para os cenários onde o response no CreateProcess é o mesmo que o response do GetProcess, otimize sua aplicação e tome sua decisão de forma síncrona.

Prova de vida + Verificação de Identidade + Alerta de comportamento + Score de risco


Para os cenários onde o response no CreateProcess é o mesmo que o response do GetProcess, otimize sua aplicação e tome sua decisão de forma síncrona.


Prova de vida + Verificação de Identidade

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  }
}

Observações:

  • A resposta de "yes" do unicoId.result (verificação de identidade) já engloba a validação da capacidade Prova de vida, ou seja, se a resposta for "yes" entende-se que a face do usuário é a do titular do CPF E ele estava ao vivo no momento da captura da selfie.

Prova de vida + Verificação de Identidade ❔

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1
}
Prova de vida + Verificação de Identidade

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
  }
}
Prova de vida + Verificação de Identidade ❔

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}
Prova de vida + Verificação de identidade

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
  }
}

Observações:

  • A resposta de "yes" do unicoId.result (Verificação de identidade) já engloba a validação da capacidade Prova de vida, ou seja, se a resposta for "yes" entende-se que a face do usuário é a do titular do CPF E ele estava ao vivo no momento da captura da selfie;

  • Quando a resposta do unicoId.result (Verificação de identidade) for "yes", não haverá a orquestração com a capacidade score de risco.

Prova de vida + Verificação de identidade❔+ Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 1,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1,
  "score": 50
}

Observações:

Prova de vida + Verificação de identidade❔+ Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1
}

Observações:

  • Quando o status = 3 e o unicoId.result for "inconclusive", mas não devolvermos o Score de risco, é porque houve um erro (drop) no motor de biométrica que não pôde gerar o score de probabilidade de risco.

Prova de vida + Verificação de Identidade + Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
  }
}

Observações:

  • Quando o status = 3 e o unicoId.result for "no" não haverá orquestração com a capacidade Score de risco.

Prova de vida + Verificação de identidade❔+ Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Observações:

  • Quando a resposta do liveness (Prova de vida) for 2, não haverá orquestração com o Score de risco.

Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "inconclusive"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "inconclusive"
  }
}

Observações:

  • A resposta de "yes" do unicoId.result (Verificação de identidade) já engloba a validação da capacidade Prova de vida, ou seja, se a resposta for "yes" entende-se que a face do usuário é a do titular do CPF E ele estava ao vivo no momento da captura da selfie.

Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "yes"
  }
}
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "inconclusive"
  }

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "inconclusive"
  }
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "yes"
  }

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "yes"
  }
Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "inconclusive"
  }

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "inconclusive"
  }
Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "yes"
  }

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "yes"
  }
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Observações:

  • Quando a resposta do liveness (Prova de vida) for 2, não executaremos as demais capacidades.

Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "inconclusive"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "inconclusive"
  }
}

Observações:

  • A resposta de "yes" do unicoId.result (Verificação de identidade) já engloba a validação da capacidade Prova de vida, ou seja, se a resposta for "yes" entende-se que a face do usuário é a do titular do CPF E ele estava ao vivo no momento da captura da selfie.

Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "yes"
   },
  "identityFraudsters": {
    "result": "yes"
  }
}
Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "inconclusive"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "inconclusive"
  }
}
Prova de vida + Verificação de identidade + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "no"
   },
   "identityFraudsters": {
      "result": "yes"
  }
}
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "yes"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "yes"
  }
}
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento + Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 1,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1,
  "identityFraudsters": {
      "result": "inconclusive"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "inconclusive"
   },
   "score": 50
}
Prova de vida + Verificação de identidade ❔ + Alerta de comportamento + Score de risco

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 1,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 1,
  "identityFraudsters": {
      "result": "inconclusive"
  }
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
   },
   "liveness": 1,
   "identityFraudsters": {
      "result": "inconclusive"
  }

Observações:

  • Quando o status = 3, unicoId.result ="inconclusive" e o identityFradsters.result = "inconclusive" , mas não devolvermos o Score de risco, é porque houve um erro (drop) no motor de biométrica que não pôde gerar o score de probabilidade de risco.

Prova de vida + Verificação de identidade ❔ + Alerta de comportamento

Response CreateProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Response GetProcess

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "liveness": 2
}

Observações:

  • Quando a resposta do liveness (Prova de vida) for 2, não executaremos as demais capacidades.

Dúvidas?

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

Caso realize o GetProcess e o processo ainda não esteja concluído, retornaremos os status 1 ou 2. Só tome sua decisão final quando obtiver um status de conclusão do processo (status = 3). Você também pode utilizar o para ser notificado quando o processo estiver concluído.

webhook
​
Central de Ajuda
Especificação de parâmetros