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?

A página de checkout da loja envia os atributos do dispositivo do comprador para a Iovation, criando assim a caixa preta;
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;
O lojista envia para a Cielo, junto com os demais dados da transação a ser analisada, a caixa preta;
A Cielo recebe todos os dados, valida e envia para a ACI Worldwide;
A ACI Worldwide recebe todos os dados, envia a caixa preta para a Iovation descriptografar;
A ACI Worldwide recebe da Iovation os atributos do dispositivo do comprador.

Como configurar?

Inclua o javascript da Iovation em sua página de checkout;
Adicione parâmetros de configuração no JavaScript;
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âmetro	Descrição	Default
`io_install_flash`	Determina se será solicitado ao usuário a instalação do Flash ou atualização da versão	false
`io_flash_needs_handler`	Este 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_stm`	Determina 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_stm`	Determina 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_id`	Id 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_rip`	Determina se tentará coletar informações para obter o endereço IP real do comprador	true
`io_bb_callback`	Parâmetro para customizar a checagem da coleta da caixa preta foi concluída Ao utilizar, escrever a função conforme com a seguinte sintaxe: iocallback(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