Liveness + Identity Verification + Behavior Alert + Risk Score

In this section, you will find the specifics of creating a process that has Liveness + Identity Verification + Behavior Alert + Risk Score as a capabilities.

Introduction

In this section, you will find detailed documentation on how the endpoints related to the Liveness + Identity Verification + Behavior Alert capabilities work when used together.

These are three synchronous capabilities (Liveness + Identity Verification + Behavior Alert), meaning that the entire integration occurs using a single endpoint.

The capabilities of the Unico IDCloud platform via by Client are managed through API Keys - used as a parameter in the request headers - which define the access scope. As a prerequisite, you must have an API Key configured with the Liveness + Identity Verification + Behavior Alert capabilities, ensuring dedicated and secure access to the resource.

Talk to your project manager to obtain the API Key with this configuration.

Getting started

Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about generating an access token here.

Endpoints:

UAT: https://api.id.uat.unico.app;
Production: https://api.id.unico.app.

CreateProcess

Important:

If the response from the Identity Verification capability is unicoId = yes, this response already includes the Liveness (meaning you will not receive the liveness parameter in the response).
The Identity Verification and Behavior Alert capabilities are completely independent. To implement your business rules, make sure to analyze what each return means.
To use the Liveness capability, it is essential to use our SDKs:
- It is possible to use the Identity Verification capability without Liveness. In this use case, the liveness return will always be liveness = 1. In this scenario, there is no validation of the life proof, not even passive validation.
If an error occurs during processing, the process will return a status = 5, as shown in the example below:

  {
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 5
  }

Tips:

For this use case, there is no need to Query the Process Result, as the response is synchronous.
To implement your business rules, always validate the final statuses of the processes (3, 5). To validate the response from the IDCloud capabilities, only consider status = 3 for your decision-making.
For more information on the scenarios you might receive in the response, refer to the Response Scenarios section.
For more information on possible errors for this endpoint, refer to the Errors section.

GetProcess

In the v2 endpoint (/processes/v2/{id}), we also return additional user information, as shown in the example below:

"processAdditionalInfo": {
      "transactionId": "2ed76ac5-8fd7-4477-839d-92bedd7e9fd5",
      "personName": "Nome da pessoa",
      "personDocument": "Número do documento da pessoa",
      "personImage": "URL assinada da imagem da pessoa",
      "finishedAt": "2024-10-04T18:53:17.028228"
  }
}

Attention:

When making a GET request for a process with status = 5 (error), the return status code will be 410 (Gone) instead of 200 (Success);
There may be cases of drops during orchestration with the Risk Score capability. In this scenario, the process will have the following combination: {status = 3, unicoId = inconclusive, liveness = 1, and NO score in the API response}. Learn more in the Response Scenarios section;
If you query a process with status = 2, implement polling until you receive status = 3 or implement Unico's Webhook to know when to get the result.

When implementing your business rules, always validate the final statuses of the processes (3, 4, 5). To validate the response of IDCloud capabilities, only consider status = 3 for your decision-making process;
To improve the performance of your operation, you can use our Webhooks and only query the results of processes that have a finalized status;
For more details on the scenarios you might receive in the response, refer to the Response Scenarios section;
For more information about possible errors for this endpoint, refer to the Errors section.

Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.

AnteriorLiveness + Identity Verification + Behavior Alert PróximoLiveness + Validation (1:1)

Atualizado há 28 dias

Isto foi útil?

Liveness + Identity Verification + Behavior Alert + Risk Score

In this section, you will find the specifics of creating a process that has Liveness + Identity Verification + Behavior Alert + Risk Score as a capabilities.

Introduction

In this section, you will find detailed documentation on how the endpoints related to the Liveness + Identity Verification + Behavior Alert capabilities work when used together.

These are three synchronous capabilities (Liveness + Identity Verification + Behavior Alert), meaning that the entire integration occurs using a single endpoint.

Talk to your project manager to obtain the API Key with this configuration.

Getting started

Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about generating an access token here.

Endpoints:

UAT: https://api.id.uat.unico.app;
Production: https://api.id.unico.app.

CreateProcess

Important:

If the response from the Identity Verification capability is unicoId = yes, this response already includes the Liveness (meaning you will not receive the liveness parameter in the response).
The Identity Verification and Behavior Alert capabilities are completely independent. To implement your business rules, make sure to analyze what each return means.
To use the Liveness capability, it is essential to use our SDKs:
- It is possible to use the Identity Verification capability without Liveness. In this use case, the liveness return will always be liveness = 1. In this scenario, there is no validation of the life proof, not even passive validation.
If an error occurs during processing, the process will return a status = 5, as shown in the example below:

  {
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 5
  }

Tips:

For this use case, there is no need to Query the Process Result, as the response is synchronous.
To implement your business rules, always validate the final statuses of the processes (3, 5). To validate the response from the IDCloud capabilities, only consider status = 3 for your decision-making.
For more information on the scenarios you might receive in the response, refer to the Response Scenarios section.
For more information on possible errors for this endpoint, refer to the Errors section.

GetProcess

In the v2 endpoint (/processes/v2/{id}), we also return additional user information, as shown in the example below:

"processAdditionalInfo": {
      "transactionId": "2ed76ac5-8fd7-4477-839d-92bedd7e9fd5",
      "personName": "Nome da pessoa",
      "personDocument": "Número do documento da pessoa",
      "personImage": "URL assinada da imagem da pessoa",
      "finishedAt": "2024-10-04T18:53:17.028228"
  }
}

Attention:

When making a GET request for a process with status = 5 (error), the return status code will be 410 (Gone) instead of 200 (Success);
There may be cases of drops during orchestration with the Risk Score capability. In this scenario, the process will have the following combination: {status = 3, unicoId = inconclusive, liveness = 1, and NO score in the API response}. Learn more in the Response Scenarios section;
If you query a process with status = 2, implement polling until you receive status = 3 or implement Unico's Webhook to know when to get the result.

When implementing your business rules, always validate the final statuses of the processes (3, 4, 5). To validate the response of IDCloud capabilities, only consider status = 3 for your decision-making process;
To improve the performance of your operation, you can use our Webhooks and only query the results of processes that have a finalized status;
For more details on the scenarios you might receive in the response, refer to the Response Scenarios section;
For more information about possible errors for this endpoint, refer to the Errors section.

Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.

AnteriorLiveness + Identity Verification + Behavior Alert PróximoLiveness + Validation (1:1)

Atualizado há 28 dias

Isto foi útil?

Liveness + Identity Verification + Behavior Alert + Risk Score

Introduction

Getting started

CreateProcess

GetProcess

Liveness + Identity Verification + Behavior Alert + Risk Score

Introduction

Getting started

CreateProcess

GetProcess

Create Process

Get Process

Introduction

Getting started

CreateProcess

GetProcess

Introduction

Getting started

CreateProcess

GetProcess

Create Process

Show child attributes

Get Process