Fingerprint
Atributos do fingerprint enviado nos pagamentos da My Gateway: sessão, canal, dispositivo, rede e localização do comprador.
Nesta página
O fingerprint descreve a sessão de checkout do comprador e vai em pix.fingerprint e em creditCard.antifraud.fingerprint.
Atributos#
Atributos do fingerprint
sessionIdstringobrigatórioIdentificador único da sessão ou tentativa. UUID é recomendado.
channelintegerobrigatórioCanal:
1Web,2aplicativo móvel,3Web em dispositivo móvel. Não use0.Valores aceitos:
123deviceInfoobjectrecomendadoDados do navegador ou dispositivo capturados no momento do checkout.
Atributos de deviceInfo
deviceIdstringopcionalIdentificador do dispositivo do comprador.
httpAcceptBrowserValuestringrecomendadoValor de conteúdo aceito pelo cliente, por exemplo
application/jsonou o valor usado pela integração.httpAcceptContentstringrecomendadoValor do header de aceitação de conteúdo, normalmente
*/*.httpBrowserLanguagestringrecomendadoIdioma do navegador, por exemplo
pt-BR.httpBrowserJavaEnabledstringrecomendadoYquando Java estiver habilitado; caso contrário,N.httpBrowserJavaScriptEnabledstringrecomendadoYquando JavaScript estiver habilitado; caso contrário,N.httpBrowserColorDepthstringrecomendadoProfundidade de cor da tela, por exemplo
24.httpBrowserScreenHeightstringrecomendadoAltura visível da tela em pixels.
httpBrowserScreenWidthstringrecomendadoLargura visível da tela em pixels.
httpBrowserTimeDifferencestringrecomendadoDiferença do fuso em minutos, equivalente a
Date.getTimezoneOffset()no navegador.userAgentBrowserValuestringrecomendadonavigator.userAgentdo navegador.
networkobjectobrigatórioDados de rede da sessão.
Atributos de network
ipstringobrigatórioIP público do cliente, IPv4 ou IPv6. Não envie IP local como
127.0.0.1.refererstringrecomendadoPágina que originou o checkout ou o valor de
document.referrer.userAgentstringrecomendadoUser-Agent observado na sessão.
locationobjectopcionalGeolocalização, só quando houver consentimento e dados disponíveis.
Atributos de location
latitudestringcondicionalLatitude decimal. Obrigatória quando
locationfor enviado.longitudestringcondicionalLongitude decimal. Obrigatória quando
locationfor enviado.accuracystringopcionalPrecisão da geolocalização em metros.
timestampstringopcionalInstante da leitura, normalmente Unix timestamp em milissegundos.
Exemplo de fingerprint
{
"sessionId": "32c37c71-2b34-45e2-b678-d6627d0f9001",
"channel": 1,
"deviceInfo": {
"deviceId": "IDENTIFICADOR_DO_DISPOSITIVO",
"httpAcceptBrowserValue": "application/json",
"httpAcceptContent": "*/*",
"httpBrowserLanguage": "pt-BR",
"httpBrowserJavaEnabled": "N",
"httpBrowserJavaScriptEnabled": "Y",
"httpBrowserColorDepth": "24",
"httpBrowserScreenHeight": "1080",
"httpBrowserScreenWidth": "1920",
"httpBrowserTimeDifference": "180",
"userAgentBrowserValue": "Mozilla/5.0 (...)"
},
"network": {
"ip": "203.0.113.10",
"referer": "https://loja.exemplo.com/checkout",
"userAgent": "Mozilla/5.0 (...)"
},
"location": {
"latitude": "-23.550520",
"longitude": "-46.633308",
"accuracy": "10",
"timestamp": "1793291400000"
}
}Coletar no navegador#
Os dados de deviceInfo vêm do navegador do comprador. Um exemplo conceitual de coleta:
Exemplo conceitual (navegador)
const deviceInfo = {
httpAcceptBrowserValue: "application/json",
httpAcceptContent: "*/*",
httpBrowserLanguage: navigator.language,
httpBrowserJavaEnabled: "N",
httpBrowserJavaScriptEnabled: "Y",
httpBrowserColorDepth: String(screen.colorDepth),
httpBrowserScreenHeight: String(window.innerHeight),
httpBrowserScreenWidth: String(window.innerWidth),
httpBrowserTimeDifference: String(new Date().getTimezoneOffset()),
userAgentBrowserValue: navigator.userAgent,
};Localização#
Envie location só quando o comprador consentir e os dados estiverem disponíveis. Quando o objeto for enviado, latitude e longitude são obrigatórios.
Última atualização em
