Setting up Nethone antifraud

4 min read

Nethone is an anti-fraud solution that identifies specific aspects of user behavior and minimizes the risk of fraud in your store's transactions by using artificial intelligence and machine learning.

You can integrate your store with Nethone via Application Key (App Key) and Application Token (App Token). You will find this information in the plugin package that Nethone will send you after you sign the contract. If you have any questions, please contact the Nethone support team.

To set up Nethone in your store, you will need to:

Configure Nethone’s anti-fraud solution
Associate Nethone’s solution with a payment condition
Enable Google Tag Manager at checkout
Configure Google Tag Manager
Create a tag trigger

Once the configuration process is complete, each purchase attempt will be analyzed by the anti-fraud solution and displayed on your Nethone dashboard.

Configuring Nethone’s anti-fraud solution

Go to the VTEX Admin.
Access the Payments module.
Click on Settings.
In Gateway Affiliations, click on the green “+” button.
In the Anti-fraud section, select the Nethone option.
In the Affiliation name field, enter Nethone.
In the Application Key and Application Token fields, enter the data you received in the plugin package.
Click on Save.

Associating Nethone’s solution with a payment condition

To perform the anti-fraud analysis, the Nethone affiliation must be associated with a payment condition. You can either use an existing condition or create a new one. Follow the instructions below:

Go to the VTEX Admin.
Access the Payments module.
Click on Settings.
In the Payment conditions tab, select an existing condition, or check out the Configuring a payment condition tutorial to create a new one.
Make sure the payment condition is Active.
After selecting or creating a new condition, enable the option Use anti-fraud solution.
Select the Nethone option.
Click on Save.

Enabling Google Tag Manager at checkout

The next step for configuring the Nethone affiliation is integrating with Google Tag Manager via Javascript.

Click here to access Google Tag Manager.
Log in to your account. If you don't have an account yet, please create one.
In the Google Tag Manager workspace, look for a number that starts with GTM-XXXX. Copy that number.
Go to your VTEX Admin.
Access the Store setup section.
Click on the Checkout option.
In the Default card, click on the gear icon.
In the top menu, select the Checkout tab.
In the Google Tag Manager field, paste the identifier number you copied from the workspace.
Click on Save.

Configuring Google Tag Manager

The configurations documented below are to be performed on a system external to VTEX and may be discontinued without notice.

Once you have configured your account ID number at checkout, follow the instructions below to track purchase attempts made in your store.

Click here and sign in to Google Tag Manager.
On the left sidebar, click on Variables.
In the User-Defined Variables section, click on New.
In Variable Configuration, click on the pencil icon.
In the Utilities section, select the Constant option.
Name the variable profilerUrl.
In the Value field, enter the link provided by Nethone in the plugin package you received.
Click on Save.

Creating a tag trigger

Once the variable has been created, follow the steps below to define the triggers:

In Google Tag Manager’s sidebar, click on Triggers.
Click on New.
Name the trigger Profiler Trigger.
In Trigger Configuration, click on the pencil icon.
In the Other option, click on Custom Event.
In the Event name field, enter the following information including the parentheses: (email|profile|shipping|payment).
Enable the Use regex matching option.
In This trigger fires on, select Some Custom Events.
Select the options Page Path, Matches RegEx, Checkout.
Click on Save.
Return to the workspace and click on Tags.
Click on New.
Under Tag Configuration, click on the pencil icon.
In the Custom section, select the Custom HTML option.
Paste the following code into the HTML field, and ensure that the value in the src="your profiling link" field is the same as the one provided by Nethone in the plugin package.


   <script type="text/javascript" id="nthScript" crossorigin="use-credentials"
   src="yourprofilinglink" async></script>
   <script>
   (function() {
   function uuidv4() {
   return
   'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
   var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r &
   0x3 | 0x8);
   return v.toString(16);
   });
   }
   var attRef = uuidv4();
   window.vtex.deviceFingerprint = attRef;
   var options = {
   attemptReference: attRef,
   sensitiveFields: []
   };
   if (window.dftp) {
   dftp.init(options);
   } else {
   var el = document.getElementById("nthScript");
   el.addEventListener("load", function() {
   dftp.init(options);
   });
   }
   })()
   </script>

Enable the Support document.write option.
Expand the Advanced Settings, and in the Tag firing option field, select Once per page.
On the Triggers menu, click on the pencil icon.
Select the Profiler Trigger option and click on Save.
Click on Submit.
In the Version Name field, enter Nethone Profiler and click on Publish.

Once this is done, the Nethone Anti-Fraud will have been installed correctly and will be ready to process your transactions.