Create Process

Este artigo explica como criar uma transação com prova de vida usando o método CreateProcess através da REST API do Unico IDLive.

Esse método cria um processo para autenticação no Unico IDLive. Toda a validação nesse fluxo é feita após o usuário realizar a captura da biometria. Envie a imagem capturada e as informações da pessoa.

A imagem é processada após o upload com sucesso.

Como usar?

Faça uma requisição POST para o endpoint /processes/v1

Com o token de acesso válido, faça uma requisição para o endpoint (POST/processes/v1) enviando os seguintes parâmetros:

{
  "subject": {
    "Code": "CPF_Titular",
    "Name": "NOME_Titular",
    "Email": "EMAIL_Titular",
    "Phone": "PHONE_Titular"
  },
  "useCase": "USECASE",
  "imagebase64": "IMAGEM_Titular"
}

Parametros:

• HEADER PARAMETERS

Nome	Tipo	Mandatorio/Opcional	Descrição
APIKEY	String	Mandatório	API key
Authorization	String	Mandatório	Token de acesso
Content-Type	String	Mandatório	"application/json"

• REQUEST BODY SCHEMA

Nome	Tipo	Mandatorio/Opcional	Descrição
subject.Code	String	Mandatório	CPF válido
subject.Name	String	Mandatório	Nome da pessoa
subject.Email	String	Opcional	Email da pessoa
subject.Phone	String	Opcional	Telefone da pessoa
useCase	String	Opcional	Indica o uso da operação. Serve para que as operações possam ser segmentadas.
imagebase64	String	Mandatório	Foto da pesssoa. A image deve ser o Json Web Token (.jwt) capturado através do SDK da Unico. O .jwt deve ser enviado em até 10 minutos evitando que a imagem expire. E esse .jwt só pode ser usado uma única vez.

Importante

O parâmetro subject.Name não pode conter dois espaços entre os nomes.

Envio correto do parâmetro:

  "subject.Name": "Ronald Richards"

Envio errado do parâmetro:

  "subject.Name": "Ronald  Richards"

Exemplo de requisição:

Arquivo JSON

{
  "subject": {
    "code": "45875596922",
    "name": "Roberto Flavio",
  },
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg=="
}

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON com os possíveis cenários:

• Liveness Aprovado

{
    "id": "016ba203-ca11-4690-aeb7-3573c9a03935",
    "status": 3,
    "liveness": 1
}

• Liveness Reprovado

{
    "id": "016ba203-ca11-4690-aeb7-3573c9a03935",
    "status": 3,
    "liveness": 2
}

• Processo com erro

{
    "id": "016ba203-ca11-4690-aeb7-3573c9a03935",
    "status": 5
}

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": "10700",
        "description": "Falha Interna! Erro ao validar o token informado"
    }
}

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.