CreateProcess

In this section, you will find how to create a process in Unico via the REST API

---

Introduction

---

In this section, you will find detailed documentation on how the Process Creation endpoint works in by Unico. Note that to utilize the capabilities of the IDCloud platform in this integration method, you only need to change the value of the "flow" parameter when creating the process. Unico will handle the orchestration of all the desired capabilities.

Learn more about using capabilities in by Unico in the Overview section.

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.cadastro.uat.unico.app;

• Produção: https://api.cadastro.unico.app.

---

Process Creation

---

Create Process

post

Endpoint to create a new process at Unico.

Authorizations

Body

callbackUristringrequired

Defines where the user will be redirected at the end of the process. Possible values are: A URL (e.g., https://developers.unico.io/callback), a Schema URL for redirection in native mobile applications (e.g., br.com.meupacote.app://callback - the callback must be registered in your mobile app), or no redirection (just include '/').

Example: /

flowstring · enumrequired

Flow type. See flow details in the 'Overview' section of this documentation.

Example: iddocssignAvailable options:

companyBranchIdstringoptional

The ID of the branch where the process will be created. If there is only one branch associated with the service account, this parameter is not required. If there is a separation of processes by branch, you will receive the branch IDs from the Unico team.

Example: 60837cd3-ed3c-4038-ad7c-0a85ad64b03a

bioTokenIdstringoptional

Biometric token identification. Mandatory for the "idtoken" flow and must use an ID from a completed process of any other identity verification flow.

Example: 60837cd3-ed3c-4038-ad7c-0a85ad64b03a

personobjectoptional

User information.

purposestring · enumrequired

Purpose of the process.

Example: creditprocessAvailable options:

expiresInstringoptional

Expiration time of the process in seconds from its creation. The value must be in the format "10080s", with "s" at the end. If not provided, the default value of 7 days will be used.

Example: 3600s

contextualizationobjectoptional

Contextual information about the process. These fields are presented in the user journey, improving conversion by contextualizing the reason for biometric capture.

payloadobject[]optional

Array containing document information. All items in the array become mandatory if using any flow with electronic signature.

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.cadastro.uat.unico.app/client/v1/process' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "callbackUri": "/",
    "flow": "iddocssign",
    "companyBranchId": "60837cd3-ed3c-4038-ad7c-0a85ad64b03a",
    "bioTokenId": "60837cd3-ed3c-4038-ad7c-0a85ad64b03a",
    "person": {
      "duiType": "DUI_TYPE_BR_CPF",
      "duiValue": "12345678909",
      "friendlyName": "Luke Skywalker",
      "phone": "5511912345678",
      "email": "[e-mail]",
      "notifications": [
        {
          "notificationChannel": "NOTIFICATION_CHANNEL_WHATSAPP"
        }
      ]
    },
    "purpose": "creditprocess",
    "expiresIn": "3600s",
    "contextualization": {
      "currency": "BRL",
      "price": 15990.9,
      "locale": {
        "ptBr": {
          "reason": "Identity validation for personal loan approval."
        }
      }
    },
    "payload": [
      {
        "envelopePayload": {
          "documents": [
            {
              "documentName": "teste",
              "fileContents": "JVBERi0xLjMNCiXi48/[...]DQoNCnN0YXJ0eHJlZg0KMjcxNA0KJSVFT0YNCg=="
            }
          ]
        }
      }
    ]
  }'

200

400

401

500

200

{
  "process": {
    "id": "53060f52-f146-4c12-a234-5bb5031f6f5b",
    "companyBranchId": "60837cd3-ed3c-4038-ad7c-0a85ad64b03a",
    "flow": "iddocssign",
    "callbackUri": "/path/to/callback-url/",
    "userRedirectUrl": "https://cadastro.dev.unico.app/process/53060f52-f146-4c12-a234-5bb5031f6f5b",
    "state": "PROCESS_STATE_CREATED",
    "createdAt": "2023-10-09T15:15:25.417105Z",
    "person": {
      "duiType": "DUI_TYPE_BR_CPF",
      "duiValue": "73689290074",
      "friendlyName": "Luke Skywalker",
      "phone": "5511912345678",
      "email": "[e-mail]",
      "notifications": [
        {
          "notificationChannel": "NOTIFICATION_CHANNEL_WHATSAPP"
        }
      ]
    },
    "purpose": "creditprocess",
    "authenticationInfo": {},
    "capacities": [
      [
        "PROCESS_CAPACITY_IDUNICO",
        "PROCESS_CAPACITY_IDCHECK",
        "PROCESS_CAPACITY_IDDOCS"
      ]
    ],
    "expiresAt": "2023-10-09T15:15:25.417105Z",
    "token": "eyJhbGciOiJSUzI1[...]d_jhQ",
    "companyData": {
      "branchId": "60837cd3-ed3c-4038-ad7c-0a85ad64b03a",
      "countryCode": "BRA"
    }
  }
}

Process successfully created.

Processes must be created exclusively through backend-to-backend communication, due to our CORS policy, which prevents processes from being created through frontend-to-backend communication.

The requirement for parameters in process creation may change depending on the flows used. For example:

• In flows that involve Electronic Signature, it is mandatory to send the payload object and all its properties;

• In flows that involve Validation (1:1), it is mandatory to send the bioTokenId property.

Tips:

• For more information about the 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.