Validation (1:1)

In this section, you will find the specifics of creating a process that includes the 1:1 Validation capability

---

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/processes/v1;

• Production: https://api.id.unico.app/processes/v1.

---

CreateProcess

Endpoint to create a new 1:1 validation process by Client.

POSThttps://api.id.uat.unico.app/processes/v1/

Header parameters

Body

application/json

subject*object

referenceProcessId*string

Identifier of the process generated during the biometric transaction creation, whose photo will be used for comparison.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

imageBase64*string

Encrypted generated by the SDK.

Example: "/9j/4AAQSkZJR..."

Response

200400500

Process created successfully (User authenticated).

Body

application/json

idstring

Process ID.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

authenticatedboolean

Authentication result.

Example: true

livenessinteger

Result of the liveness test.

Example: 1

Request

JavaScriptCurlPython

const response = await fetch('https://api.id.uat.unico.app/processes/v1/', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "APIKEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "subject": {
        "code": "12345678909"
      },
      "referenceProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6",
      "imageBase64": "/9j/4AAQSkZJR..."
    }),
});
const data = await response.json();

Response

200400500

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "authenticated": true,
  "liveness": 1
}

• In the process creation, the following are mandatory: subject.code, referenteProcessId, and imageBase64;

• In the process response, we return the id, authenticated (result of the 1:1 Validation), and liveness (result of the Liveness).

For this use case, there is no need to perform the GetProcess, as the response is synchronous.

---

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.