Parameter Specification
In this section, you will find the specification of all the parameters for the REST API of the by Unico integration
CreateProcess - Request Payload
Name | Type | Mandatory/ Optional | Description |
---|---|---|---|
| string | Mandatory | Define the journey to be executed.
id: Identity validation flow with facial biometrics.
|
| string | Mandatory | Define where the user will be redirected at the end of the process.
To learn more about how to redirect the user, see the section "Redirecting the User" here. |
| string | Mandatory | Define the type of user identifier.
|
| string | Mandatory | Define the value of the user identifier specified in the Example: In the case of using the identifier DUI_TYPE_BR_CPF, provide a valid CPF without formatting: 73689290074. Note: This is mandatory for SMS and WhatsApp flows. |
| string | Optional | DDefine the name of the user. Ex.: |
| string | Optional(*) | Define the user's phone number. Ex.: |
| string | Optional(*) | Define the user's email address. |
| string | Optional |
|
| string | Mandatory | Define the purpose of use and data collection for the user. This is aimed at providing transparency and ensuring the proper handling of data according to LGPD (General Data Protection Law).
|
| string | Optional(**) | Define the ID of the transaction you want to compare with the validation of the idtoken flow. The value of this field can be the value of the id field or the authenticationInfo.authenticationId from the process returned when performing the GetProcess of an idcheck process. |
| array | Mandatory | The payload field is an array that provides a location for inserting files necessary for specific flows, such as idsign. Within the payload array, another array can be used to create signature flow envelopes. The documents field is an array that receives the documents that make up each envelope, which can be one or more. Each document object has:
This field is mandatory when using the electronic signature capability. |
| string | Optional | This field defines the time in seconds for the expiration of the process, based on the created_at date. For example, for the expiration to occur in 7 days, it is necessary to specify as |
| float | Optional | This field defines the value that will be displayed in the process contextualization. |
| string | Optional(***) | Esse campo define a moeda que será uThis field defines the currency that will be used for formatting the price field. |
| string | Optional | This field defines the information that will be displayed in the Reason field of the process when the pt-br language is selected. |
| string | Optional | This field defines the information that will be displayed in the Reason field of the process when the en-us language is selected. |
| string | Optional | This field defines the information that will be displayed in the Reason field of the process when the es-mx language is selected. |
GetProcess - Request Response
Name | Type | Description |
---|---|---|
| string | The identifier of the process. |
| string | Indicates the journey that was created.
|
| string | Indicates where the user will be redirected at the end of the process. |
| string | Indicates the URL to which you should redirect the user to complete the journey. |
| string | Indicates the current state of the process, which can be of the type:
|
| string | IIndicates the result of the user's journey process, which can be of the type:
|
| string | Indicates the moment when the process was created. |
| string | Indicates the moment when the process was completed. |
| string | Indicates the type of identifier for the user.
|
| string | Indicates the value of the user identifier specified in the |
| string | Indicates the email value of the user specified in the |
| string | IndiIndicates the phone number value of the user specified in the |
| string | IIndicates the name of the user, for example, Luke Skywalker. |
| string | Indicates the channel used for sending notifications during the creation of the process. |
| string | Indicates the purpose of collecting the user's data at the time the process was created. |
| string | It refers to the Identity Verification capability.
A |
| string | Indicates whether the Risk Score capability is enabled in this journey. |
| integer | Indicates the Risk Score for cases where the Identity Verification response was inconclusive. |
| string | Indicates the ID of the process that derived to the Risk Score. It can be used in the idtoken flow as a value for the bioTokenId parameter. |
| string | Indicates the result of the liveness check.
|
| integer | Indicates the result of the similarity score from SERPRO. Currently available only for the idcheckserpro flow. |
| boolean | Indicates whether there was (true) or not (false) reuse of the document. A document is reused when it already exists in Unico's database and the user has granted permission to reuse it without the need for a new capture. |
| boolean | Indicates whether the CPF in the request is the same as the document's CPF. If yes, (true); if no, (false). |
| boolean | Indicates whether the document was classified (true) or not (false). A document is classified when its layout can be identified. |
| string | Unique identifier of the shared document. |
| string | Indicates the signed URL of the document. |
| boolean | Indicates whether the document was validated (true) or not (false). |
| boolean | Indicates whether the person in the request photo is the same as the one on the document. If yes (true), if no (false). |
| integer | Indicates the version of document. |
| object | When the document is typed, it will return the extracted data from the document:
|
| string | When typed, it will return RG, CIN, or CNH; if not, it will return "Unknown."
A document is typed when it is possible to identify the layout of that document during the image capture. |
| boolean | Indicates whether there was (true) or was not (false) user consent. |
| string | Indicates the identifier of the electronic signature envelope. |
| string | Indicates the identifier of the document that was signed during the journey. |
| string | Indicates which IDCloud capabilities were used in the respective process flow. It can have the following returns:
|
| string | Indicates the moment when the process will have expired or has expired. The value of this field is calculated from the |
GetSelfie - Request Response
Nome | Tipo | Descrição |
---|---|---|
| string | It is a Base64-encoded string that should be converted to an image file in your application. |
| string | Indicates that the content in |
GetEvidenceSet - Request Response
Nome | Tipo | Descrição |
---|---|---|
| string | It is a Base64-encoded string that should be converted to an image file in your application. |
| string | Indicates that the content in |
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.
Atualizado