Verificação de Identidade

Nesta seção, você encontrará as particularidades de criar um processo que tenha a Verificação de Identidade como capacidade, bem como seus complementos

---

Antes de começar

---

Suas requisições de API são autenticadas utilizando um access-token. Qualquer requisição que não inclua um access-token válido retornará um erro.

Você pode ver mais sobre como gerar um access-token aqui.

Endpoints:

• UAT: https://api.id.uat.unico.app/processes/v1;

• Produção: https://api.id.unico.app/processes/v1.

---

CreateProcess

Endpoint para criar um novo processo de verificação de identidade no by Client.

POSThttps://api.id.uat.unico.app/processes/v1/

Header parameters

Body

application/json

subject*object

useCase*string

Caso de uso da operação.

Example: "Onboarding"

imageBase64*string

Encrypted gerado pelo SDK ou base64.

Example: "/9j/4AAQSkZJR..."

Response

200400500

Processo criado com sucesso (INCONCLUSIVO da Verificação de Identidade).

Body

application/json

idstring

ID do processo.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

statusinteger

Status do processo.

Example: 2

unicoIdobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.id.uat.unico.app/processes/v1/', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "APIKEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "subject": {
        "code": "12345678909",
        "name": "Luke Skywalker"
      },
      "useCase": "Onboarding",
      "imageBase64": "/9j/4AAQSkZJR..."
    }),
});
const data = await response.json();

Response

200400500

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

Note que para a utilização da capacidade de Verificação de Identidade:

• Na criação do processo, são obrigatórios subject.code, subject.name e imageBase64;

• No response do processo, as respostas das capacidades podem vir em tempos diferentes, visto que o IDCloud possui Capacidades síncronas e assíncronas. Em função disso, deve-se implementar o método GetProcess a depender da combinação destas capacidades.

A capacidade de Verificação de Identidade pode ser combinada com outras capacidades, como Score de risco ou Detecção de Perfil Fraudador. Para encontrar mais informações das respostas possíveis, veja as seções Cenários de response e Especificação de Parâmetros.

---

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.