Overview
In this section you will find all the technical specifications of the by Unico REST APIs
Introduction
by Unico is a channel that provides an infrastructure of identity validation solutions from the IDCloud platform.
Its goal is to simplify the use of the capabilities of the IDCloud platform by offering a solution that can be integrated into your back-end and front-end, enhancing the security of transactions.
Compatible devices
Compatible with all devices with front camera, Android 8+, armv7 or arm64.
Compatible with all iOS devices version 11 or higher.
Web
Compatible with all devices with a front camera, whether on laptops or mobile devices, adhering to the list of officially supported browsers below:
iOS:
version greater than or equal to 12.
Android:
version greater than or equal to 5.
Android:
Chrome: version greater than or equal to 90.
iOS:
Safari: version greater than or equal to 14.1;
Chrome: version greater than or equal to 90 (only for IOS version equal to or greater than 14.4).
Chrome:
version greater than or equal to 85.
Firefox:
version greater than or equal to 94.
Safari:
version greater than or equal to 11.
Other browsers are not supported.
Possible Flows
by Unico is an integration method of Unico IDCloud that allows clients to integrate more easily and connect different capabilities in a single journey. This integration method provides the necessary resources to perform Liveness, Identity Verification, Risk Score, Document Capture and Reuse, and Electronic Signature.
To do this, you will only need to change the flow parameter in the REST API payload, which will give you several verification journey possibilities. See below the table relating the available flows and their respective capabilities:
idlive
id
idlivetrust
idtrust
idunicodocs
idunicosign
idunicodocssign
idtrustdocs
idtrustsign
idtrustdocssign
idtoken
idtokentrust
idtokensign
Flow depracateds
The Risk Score capability is being discontinued and can only be used in special cases.
How to integrate
Authenticate
First, you must have a service account and perform OAuth2 authentication to obtain a valid access token.
Learn more in Authentication.
Create a Process
With the access token obtained in the previous step, make a POST request to the endpoint client/v1/process
(here you will specify the "flow" you wish to use).
Learn more in CreateProcess.
Define Your User’s Journey
In this step, you will define where your user's journey will take place.
Will the journey be in your app? You can use a Webview.
Will the journey be in the messaging flow? You can send notifications via WhatsApp and SMS (for this, simply provide the corresponding parameter in the CreateProcess request in step 2).
Check the Process Result
With the access token obtained in step 1, make a GET request to the endpoint client/v1/process/{id}
(here you will provide the "id" of the process created in step 2), check the process result, and decide whether to approve or reject the user.
Learn more in GetProcess.
To optimize your integration, you can use the Webhook to know when the result of your process is completed.
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
Isto foi útil?