VTEX Device Fingerprint

This page provides a guide to integrate DEUNA's device fingerprint with VTEX Widget V2.

Benefits of device fingerprint

The new version of DEUNA's Widget introduces an innovative way to handle multiple fraud engines with just a few lines of code.

This functionality allows centralizing all relevant information in a single place, facilitating control and management by the merchant.

Among the benefits are:

1. Clean Implementation: No need to implement additional scripts for anti-fraud engines; the widget automatically handles this process. You only need to enter the desired fraud engine and its credentials to activate it.
2. Information Centralization: All your anti-fraud engine configuration data is kept in one place, making it easier to manage.
3. Automation and updates: We manage the necessary updates and send fraud information to VTEX and the payment processor you configure.
4. Flexibility in payment rules: You can configure multiple engines for different payment rules from the DEUNA administrator, ensuring information is sent correctly.

Requirements

These are the requirements to integrate VTEX's device fingerprint:

1. DEUNA administrator credentials.
2. Anti-fraud engine credentials to configure.

Integrate device fingerprint

Integrate VTEX's device fingerprint by following these steps:

1. Add fraudCredentials to your configuration

Configure your script by adding the fraudCredentials option within the configuration attributes.

📘

Anti-fraud engine configuration is an optional part of the script you just configured.

function loadScriptWithAttributes(url, attributes, target) {
    return new Promise((resolve, reject) => {
        const script = document.createElement('script');
        script.src = url;

        if (attributes) {
            Object.keys(attributes).forEach(key => {
                script.setAttribute(key, attributes[key]);
            });
        }

        script.onload = resolve;
        script.onerror = reject;

		const currentTarget = target ?? document.head
        if (!currentTarget) {
          console.error("'currentTarget': is not defined")
 		}
		currentTarget.appendChild(script);        
    });
}


const baseURL = "https://cdn.stg.deuna.io/snippets/v1.0.0/index.js";
console.log("DEUNA cdn: ", baseURL);
const attributes = { 
	  env: "ENVIRONMENT",
    publicApiKey: "API_KEY",
    fraudCredentials: JSON.stringify({ // THIS IS WHAT YOU ADD TO SUPPORT ANTI-FRAUD ENGINES
	    CLEARSALE: {
        "Client Id": "CLEARSALE_CREDENTIAL" 
      }
   })
};
 

loadScriptWithAttributes(baseURL, attributes)
    .then(() => {
      console.log("DEUNA: loaded script Succesfully!")
    })
    .catch((err) => {
      console.error("DEUNA: Error load script cdn: ", err);
    });

 

2. Select the provider

Select anti-fraud engine providers from the available engines for device fingerprint

📘

Consult Global Providers or the Anti-fraud Engines offering for more information.

The following table contains attributes for engines supported by the widget: