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. |
O parâmetro subject.Name não pode conter dois espaços entre os nomes.
"subject.Name": "Ronald Richards"
"subject.Name": "Ronald Richards"
Exemplo de requisição:
{
"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.