Nesta seção, você encontrará as particularidades de criar um processo que tenha Prova de vida + Validação (1:1) + Alerta de comportamento como capacidades.
Atualizado
Nesta seção, você encontrará a documentação detalhada sobre o funcionamento do endpoint relacionado às capacidades Prova de Vida + Validação (1:1) + Alerta de comportamento, utilizadas em conjunto.
Trata-se de três capacidades síncronas, ou seja, toda a integração ocorre utilizando um único endpoint.
As capacidades da plataforma Unico IDCloud via by Client são gerenciadas por meio de API Keys - utilizadas como um parâmetro no header das requisições -, que definem o escopo de acesso. Como pré-requisito, é necessário possuir uma API Key configurada com as capacidades Prova de Vida + Validação (1:1) + Alerta de comportamento, garantindo acesso dedicado e seguro ao recurso.
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.
Endpoint para criar um novo processo de prova de vida + validação 1:1 + Alerta de comportamento no by Client.
Access-token válido.
APIKEY válida com as capacidades prova de vida + validação 1:1 + alerta de comportamento habilitadas.
Identificador do processo que foi gerado durante a criação da transação biométrica, cuja foto será usada para comparação.
80371b2a-3ac7-432e-866d-57fe37896ac6Caso de uso da operação.
Onboardingo ID da filial onde o processo será criado. Caso haja somente uma filial associada a conta de serviço, não há a necessidade de passar este parâmetro. Caso haja separação de processos por filial, você receberá os IDs das filiais do time Unico.
35d734c4-7fbb-4b2f-a1dc-7e1575514819Arquivo encrypted gerado pelo SDK ou base64 (caso não utilize a Prova de vida).
/9j/4AAQSkZJR...Processo criado com sucesso (Usuário autenticado).
Payload inválido.
Erro inesperado (Erro interno ou problema de parâmetro).
POST /processes/v1 HTTP/1.1
Host: api.id.uat.unico.app
Authorization: text
APIKEY: text
Content-Type: application/json
Accept: */*
Content-Length: 275
{
"subject": {
"code": "12345678909",
"name": "Luke Skywalker",
"email": "[email protected]",
"phone": "551972557070"
},
"referenceProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6",
"useCase": "Onboarding",
"subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",
"imageBase64": "/9j/4AAQSkZJR..."
}{
"id": "fda9bdb4-00cd-4ddb-bfea-d8cfe78eaa34",
"status": 3,
"identityFraudsters": {
"result": "yes"
},
"biometryToken": {
"result": "true"
},
"liveness": 1
}Pontos Importantes:
Para utilizar a capacidade Prova de vida, é indispensável o uso dos nossos SDKs:
É possível utilizar a capacidade de Validação (1:1) sem a Prova de vida. Para este caso de uso, não devolveremos o parâmetro liveness no response da API. Neste cenário não há nenhuma validação da prova de vida, nem mesmo passiva.
Caso ocorra algum erro no processamento, o processo retornará um status = 5, como no exemplo abaixo:
{
"id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
"status": 5
}Dicas:
Para este caso de uso, não há a necessidade de Consultar o Resultado do Processo, visto que a resposta é síncrona;
Para mais informações sobre os erros possíveis para este endpoint, consulte a seção Erros.
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.