Fingerprint Web

ℹ️

Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

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.


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

Como funciona?

Integração com sua página de checkout (site)
  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.

ℹ️

Importante

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

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>


Parâmetros de configuração

ParâmetroDescriçãoDefault
io_install_flashDetermina se será solicitado ao usuário a instalação do Flash ou atualização da versãofalse
io_flash_needs_handlerEste parâmetro só terá validade se o parâmetro io_install_flash estiver configurado como TRUE, caso contrário não será executado
É possível aqui customizar sua própria mensagem caso o Flash não esteja instalado
Ex.: var io_flash_needs_handler = "Alert('Instalar Flash');"
-
io_install_stmDetermina se será solicitado ao usuário a instalação do Active X, que ajuda a coletar informações do hardware
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
false
io_exclude_stmDetermina se o Active X deverá ser executado quando instalado
É possível optar por desativar o controle para plataformas específicas
Possíveis valores:
0 - executa em todas as plataformas
1 - não executa no Windows 9.x (incluindo as versões 3.1, 95, 98 e ME)
2 - não executa no Windows CE
4 - não executa no Windows XP (incluindo as versões NT, 2000, 2003 e 8)
8 - não executa no Windows Vista
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)
15
io_bbout_element_idId do elemento HTML para preencher com a caixa preta
Se o parâmetro io_bb_callback for definido, este não terá efeito
-
io_enable_ripDetermina se tentará coletar informações para obter o endereço IP real do compradortrue
io_bb_callbackParâmetro para customizar a checagem da coleta da caixa preta foi concluída
Ao utilizar, escrever a função conforme com a seguinte sintaxe:
io_callback(bb, complete), onde:
bb - valor da caixa preta
complete - valor booleano que indica que a coleta foi concluída
-

⚠️

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.

Exemplo

Exemplo: Incluindo o JavaScript da Iovation