---
updatedAt: 2026-07-15T19:49:33.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/risco/llms.txt
---

# Fingerprint Web

<Callout icon="ℹ️" theme="info">
  ###

  Vá para a <a href="https://docs.cielo.com.br/risco/reference/analise-aci" target="\_blank">Referência da API para acessar os exemplos completos de requisição e resposta</a>.
</Callout>

O Fingerprint é a identificação digital do dispositivo do comprador. Essa identificação é composta por uma série de dados coletados na página de checkout do site ou aplicativo.

<br />

### Integração com sua página de checkout (site)

#### Como funciona?

<Image src="https://files.readme.io/2d7a64e-fingerprint.png" alt="Integração com sua página de checkout (site)" align="center" />

1. A página de checkout da loja envia os atributos do dispositivo do comprador para a Iovation, criando assim a *caixa preta*;
2. O lojista recebe a sequência de caracteres criptografados da Iovation e escreve o mesmo na página de checkout em um campo do tipo *hidden*;
3. O lojista envia para a Cielo, junto com os demais dados da transação a ser analisada, a *caixa preta*;
4. A Cielo recebe todos os dados, valida e envia para a ACI Worldwide;
5. A ACI Worldwide recebe todos os dados, envia a *caixa preta* para a Iovation descriptografar;
6. A ACI Worldwide recebe da Iovation os atributos do dispositivo do comprador.

#### Como configurar?

1. Inclua o javascript da Iovation em sua página de checkout;
2. Adicione parâmetros de configuração no JavaScript;
3. Crie um campo do tipo *hidden* em sua página para escrever a *caixa preta* nele e enviá-lo junto com os dados da transação a ser analisada.

<Callout icon="ℹ️" theme="info">
  ### Importante

  Não realize cache do script, pois pode ocorrer de vários dispositivos sejam identificados como sendo o mesmo.
</Callout>

**Incluindo o JavaScript da Iovation**

Para incluir o JavaScript, adicione o seguinte elemento <**script**> na sua página de checkout.

Esta é a URL da versão do snare.js da Iovation: `<script type=”text/javascript” src=”https://mpsnare.iesnare.com/snare.js”></script>`

<br />

#### Parâmetros de configuração

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parâmetro
      </th>

      <th>
        Descrição
      </th>

      <th>
        Default
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `io_install_flash`
      </td>

      <td>
        Determina se será solicitado ao usuário a instalação do Flash ou atualização da versão
      </td>

      <td>
        false
      </td>
    </tr>

    <tr>
      <td>
        `io_flash_needs_handler`
      </td>

      <td>
        Este parâmetro só terá validade se o parâmetro `io_install_flash` estiver configurado como TRUE, caso contrário não será executado<br />É possível aqui customizar sua própria mensagem caso o Flash não esteja instalado<br />Ex.: var `io_flash_needs_handler` = "Alert('Instalar Flash');"
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        `io_install_stm`
      </td>

      <td>
        Determina se será solicitado ao usuário a instalação do Active X, que ajuda a coletar informações do hardware<br />Este controle está disponível somente para o Internet Explorer, e caso o Active X já se encontre instalado, esta configuração não terá efeito
      </td>

      <td>
        false
      </td>
    </tr>

    <tr>
      <td>
        `io_exclude_stm`
      </td>

      <td>
        Determina se o Active X deverá ser executado quando instalado<br />É possível optar por desativar o controle para plataformas específicas<br />Possíveis valores:<br />0 - executa em todas as plataformas<br />1 - não executa no Windows 9.x (incluindo as versões 3.1, 95, 98 e ME)<br />2 - não executa no Windows CE<br />4 - não executa no Windows XP (incluindo as versões NT, 2000, 2003 e 8)<br />8 - não executa no Windows Vista<br />Obs.: Os valores são a combinação de somas dos valores acima, por exemplo: 12 - não executa no Windows XP (4) ou no Windows Vista (8)
      </td>

      <td>
        15
      </td>
    </tr>

    <tr>
      <td>
        `io_bbout_element_id`
      </td>

      <td>
        Id do elemento HTML para preencher com a _caixa preta_<br />Se o parâmetro `io_bb_callback` for definido, este não terá efeito
      </td>

      <td>
        N/A
      </td>
    </tr>

    <tr>
      <td>
        `io_enable_rip`
      </td>

      <td>
        Determina se tentará coletar informações para obter o endereço IP real do comprador
      </td>

      <td>
        true
      </td>
    </tr>

    <tr>
      <td>
        `io_bb_callback`
      </td>

      <td>
        Parâmetro para customizar a checagem da coleta da _caixa preta_ foi concluída<br />Ao utilizar, escrever a função conforme com a seguinte sintaxe:

        - io_callback(bb, complete)\_, onde:<br />bb - valor da caixa preta<br />complete - valor booleano que indica que a coleta foi concluída
      </td>

      <td>
        N/A
      </td>
    </tr>
  </tbody>
</Table>

<Callout icon="⚠️" theme="warn">
  ### Atenção

  Os parâmetros de configuração devem ser colocados antes da chamada da tag acima; eles determinam como o JavaScript do iovation funcionará, e podem ocorrer erros caso sejam colocados antes da chamada do JavaScript.
</Callout>

**Exemplo**

<Image src="https://files.readme.io/43fec10-exemplohtmlred.png" alt="Exemplo: Incluindo o JavaScript da Iovation" align="center" />

<br />