Skip to main content
Fraud prevention is critical for e-commerce. Device fingerprinting is a technique used by anti-fraud services to identify and analyze the device used for a transaction, helping to assess the risk of fraud. Ollie Shop maintains native compatibility with device fingerprint scripts from your e-commerce platform.

​
What is Device Fingerprint?

A device fingerprint is a unique identifier generated by collecting non-sensitive data about a user’s device and browser. This data helps anti-fraud platforms like Clearsale, Cybersource, and others to:
  • Identify the device used in each transaction
  • Analyze the security level of the device
  • Detect patterns from previous transactions made with the same device
  • Flag suspicious behavior that may indicate fraud
Device fingerprinting collects non-sensitive technical data such as browser type, screen resolution, installed fonts, and time zone. It does not collect personal information.

​
How It Works with Ollie Shop

When using Ollie Shop, your e-commerce platform’s device fingerprint scripts continue to work seamlessly. Ollie Shop maintains the expected global variables and interfaces that these scripts rely on.

​
Platform Compatibility

For VTEX stores, Ollie Shop creates and maintains the standard window.vtex.deviceFingerprint field. This field can be populated exactly as it would be in a native VTEX checkout.
// The deviceFingerprint field is available at:
window.vtex.deviceFingerprint
Your existing VTEX anti-fraud configuration will work automatically. No additional setup is required in Ollie Shop.

​
Integration with Anti-Fraud Services

Device fingerprint data is automatically included in the payment processing flow. When a transaction is submitted:
  1. The anti-fraud script collects device data and generates a fingerprint
  2. The fingerprint is stored in the platform’s expected location (e.g., window.vtex.deviceFingerprint)
  3. Ollie Shop includes this fingerprint when processing the payment
  4. Your anti-fraud provider receives the fingerprint for risk analysis

​
Loading Anti-Fraud Scripts

If your anti-fraud provider requires manual script loading, you have two options:
Create a custom component (e.g., a pixel component) that loads the anti-fraud script when the checkout renders:
AntifraudPixel.tsx
'use client'

import { useEffect } from 'react';

export default function AntifraudPixel() {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = 'https://your-antifraud-provider.com/fingerprint.js';
    script.async = true;
    document.body.appendChild(script);

    return () => {
      document.body.removeChild(script);
    };
  }, []);

  return null;
}

​
Troubleshooting

If device fingerprinting isn’t working as expected:
  1. Verify script loading — Check that your anti-fraud provider’s script is loading in the checkout
  2. Check the global variable — Confirm the fingerprint value is being set (e.g., console.log(window.vtex.deviceFingerprint))
  3. Review provider configuration — Ensure your anti-fraud provider is correctly configured in your e-commerce platform
  4. Contact support — If issues persist, reach out to both your anti-fraud provider and Ollie Shop support

​
Further Reading