Create Process

Este artigo explica como criar uma transação biométrica usando o método CreateProcess através da REST API do IDUnico.

Esse método cria um processo de biometria para autenticação no IDUnico. 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 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 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",
    "email": "random@unico.io",
    "phone": "5511999999999"
  },
  "useCase": "cartões",
  "imageBase64": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg=="
}

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON como a seguir:

API Key configurada com ID Síncrono:

• IDUnico

{
    "id": "016ba203-ca11-4690-aeb7-3573c9a03935",
    "status": 3,
    "unicoId": {
        "result": "yes"
    }
}

• IDUnico + IDCheck

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
    "status": 3,
    "unicoId": {
        "result": "inconclusive"
    },
    "liveness": 1,
    "score": 10
}

API Key configurada com ID Assíncrono:

{
    "id": "6ab1771e-dfab-4e47-8316-2452268e5481"
}

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