Device Fingerprint é um identificador que atua no processamento de um pagamento, tendo como objetivo melhorar a análise do risco de fraude em cada transação.
Por meio da coleta de dados não sensíveis, o Device Fingerprint identifica e analisa o nível de segurança do dispositivo utilizado para realizar a transação, bem como as transações que anteriormente foram realizadas com este mesmo dispositivo.
Cada loja deve ter somente um Device Fingerprint cadastrado. Verifique se você já efetuou o cadastro do Device Fingerprint em outro conector, antes de continuar os passos abaixo.
Neste artigo, explicaremos como associar o recurso Device Fingerprint à afiliação Mercado Pago.
- Acesse o Admin VTEX.
- Em Configurações da loja, clique em Checkout.
- Em Default, clique na engrenagem azul.
- Na aba superior, clique em Código.
- No canto direito, em Arquivos, selecione uma das seguintes opções:
- Se você utiliza a V5 do checkout, clique em checkout5-custom.js
- Se você utiliza a V6 do checkout, clique em checkout6-custom.js
- No campo seguinte, apague a mensagem de aviso e insira o seguinte código:
var script = document.createElement("script");script.src = "https://www.mercadopago.com/v2/security.js";script.setAttribute("output","vtex.deviceFingerprint");script.setAttribute("view","checkout");document.body.appendChild(script);console.log("MP-deviceId 2020 " + script.getAttribute("output").value );
- Clique em Salvar para que o código seja aplicado ao checkout.
Ao finalizar essas configurações, o Device Fingerprint do Mercado Pago estará instalado na sua loja.
Confirmar envio do Device Fingerprint
Para garantir o funcionamento deste recurso, é preciso analisar os detalhes de uma compra realizada utilizando o Mercado Pago como forma de pagamento. Para isso, siga os passos abaixo:
- Acesse o Admin VTEX.
- Clique em Pagamentos > Transações.
- Selecione a transação mais recente que tenha utilizado o Mercado Pago como forma de pagamento.
- Na página seguinte, clique em +Informações.
- Ao clicar em +Informações, busque pelo campo deviceFingerprint e confira se o código disponível inicia com a palavra armor, conforme exemplo abaixo.

- Ao confirmar que as informações estão corretas, a etapa final para verificação do Device Fingerprint é o envio do ID da transação para a equipe do Mercado Pago. Esse ID pode ser encontrado no campo, authorizationConnectorResponse, no detalhe da transação.

- Copie o ID e encaminhe um e-mail para o Mercado Pago com esta informação e solicite a validação da transação. Dessa forma, a equipe do Mercado Pago poderá avaliar se o Device Fingerprint está operando corretamente.
Assim que receber o retorno do Mercado Pago, o Device Fingerprint estará instalado e pronto para ser utilizado em sua loja.