Unicus WEB SDK

Unicus Button Integration

For the integration of the Unicus button we have two main processes which you should take into account, depending on your business needs.

• Liveness

A process that applies facial recognition to identify that a user is a real person.

• Enrollment-Verify

Process that unifies facial recognition with the identity document, to validate the identity of a person. When the person has already enrolled (registered) in the platform, only his or her face will be requested in the following transactions, verification process.

Add the following line of code inside the header or head tag of your website.

Important

It is recommended to include the script with the async or defer attribute to improve page loading.

<script type="text/javascript" src="https://unicusbtn.idunicus.com/sdkButton.js"></script>

How to use it?

• If you want to integrate the Liveness process, you need to specify two attributes, the first one is customertoken with the value of your token generated in the admin panel and the second is transactiontype with liveness like the following example

How to get customer token?

<!-- @param {customertoken} you get it in your administration panel -->
<!-- @param {transactiontype} Transaction type -->
<unicus-btn transactiontype="liveness" customerid="<customertoken>"></unicus-btn>

• If you want to integrate the Enrollment-Verify process you need to specify three attributes, the first one is customertoken with the value of your generated token, the second one is transactiontype with enrollment-verify and the third attribute clientid with the user identifier (Passport, Driver license, ID, etc.)

<!-- @param {clientid} document type : customer's document number-->
<!-- @param {customerid} you get it from the administration panel -->
<!-- @param {transactiontype} Transaction type -->
<unicus-btn clientid="<DOCUMENT_ID>:<CLIENT_ID>" transactiontype="enrollment-verify" customerid="<customertoken>"></unicus-btn>

The valid document types are:

• ID: National ID document

• PP: Passport

• DL: Driver's license

• FD: Foreing document

Unicus Button attributes

The following is a list of the attributes of the button that will allow a better understanding of its use.

Attribute	Type	Description	Required
customertoken	string	The corporate identification token	mandatory
transactiontype	string	Type of transaction to be executed: liveness enrollment-verify	mandatory
clientid	string	User identification consists of the type of identification and its identification number <DOCUMENT_ID>:<CLIENT_ID>. This attribute is used for enrollment-verify transactions.	mandatory for enrollment-verify transaction
language	string	interface language according to the user;'s browser	automatic
color	string	colors configured in the admin portal	automatic
disabled	string	according to the button context	automatic

Javascript Frameworks integration

In this section you will find different implementations with the main web technologies. To use the examples it is necessary to replace the token

Vanilla Javascript

Implement it on your own website with just a few lines of code regardless of the framework.

Example of the complete code and its integration in the following link

React

Vue.js

Angular