> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ollie.shop/llms.txt
> Use this file to discover all available pages before exploring further.

# Device Fingerprint

> Native anti-fraud device fingerprint compatibility for fraud prevention services

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

<Info>
  Device fingerprinting collects non-sensitive technical data such as browser type, screen resolution, installed fonts, and time zone. It does not collect personal information.
</Info>

## 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

<Tabs>
  <Tab title="VTEX">
    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.

    ```javascript theme={"system"}
    // The deviceFingerprint field is available at:
    window.vtex.deviceFingerprint
    ```

    <Info>
      Your existing VTEX anti-fraud configuration will work automatically. No additional setup is required in Ollie Shop.
    </Info>
  </Tab>

  <Tab title="Shopify">
    <div style={{ display: 'flex', alignItems: 'center', gap: '8px', marginBottom: '16px' }}>
      <span style={{ background: '#FEF3C7', color: '#92400E', padding: '4px 12px', borderRadius: '9999px', fontSize: '12px', fontWeight: '600' }}>Coming Soon</span>
    </div>

    Shopify device fingerprint compatibility is currently in development. Contact our team for updates on availability.
  </Tab>
</Tabs>

## 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:

<Tabs>
  <Tab title="Custom Component">
    Create a [custom component](/ollie-shop/customization/custom-component) (e.g., a pixel component) that loads the anti-fraud script when the checkout renders:

    ```typescript AntifraudPixel.tsx theme={"system"}
    '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;
    }
    ```
  </Tab>

  <Tab title="GTM Custom HTML">
    Load the script via a [GTM Custom HTML tag](/ollie-shop/analytics/gtm-enrichment) that fires on checkout page load:

    ```html theme={"system"}
    <script src="https://your-antifraud-provider.com/fingerprint.js"></script>
    ```

    Configure the trigger to fire on **Page View** or a custom checkout event.
  </Tab>
</Tabs>

## 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

* [VTEX Anti-fraud Documentation](https://help.vtex.com/docs/tutorials/what-is-anti-fraud)