Unicus link

This Unicus integration method allows our customers to use our validation platform, without having to integrate it into a web page or application, it is possible to generate a link with the defined validation flow that can be shared to your customers by virtual means.

There are two ways to integrate Unicus link, using the administrative portal or with a request to our API.

Administration Portal

Navigating to the administration portal You will find the Unicus link section, in this section you will find the options to send messages via SMS or WhatsApp, just fill out the form to send the validation flow to your customer.

API

Navigating to the administration portal In this section you will find the Company section, where you will find the endpoint to make use of our API and obtain the link with the validation flow that you can send to your customer.

API use

Unicus link endpoint

POST <unicus-server-api-url>/init-api-transaction

Headers

Name	Type	Description
X-Customer-ID	String	Customer Token

Request Body

Name	Type	Description
document*	String	Número de documento de identificación
documentType*	String	Tipo de identificación ID (national identified) , FD(foreign document), PP(passport),

200: OK

{
    "success": true,
    "wasProcessed": true,
    "error": false,
    "path": "init-api-transaction",
    "resultCode": 0,
    "resultMessage": "A Transaction Enrollment was created.",
    "additionalSessionData": {
        "isAdditionalDataPartiallyIncomplete": true
    },
    "elapsedPerformanceTime": 644,
    "url": "https://dev-unicussocket.idunicus.com/?token=3a407c4a-c362-11ed-b3bf-12dee90996cb&process=enrollment"
}

curl --location '<unicus-server-api-url>/init-api-transaction' \
--header 'X-Customer-ID: CUSTOMER-TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "document": "<document-client-number>",
    "documentType": "<document-type-client>"
}

The url parameter is the only thing required for your customer to start the validation process remotely, quickly and easily.

When your customer finishes the identity validation process, you will receive the response of the process through webhook.

How to get customer token?