Antifraude e Impressão Digital do Dispositivo
Quick Reference
O motor antifraude integrado da A55 analisa sinais de dispositivo, comportamento e pagamento em tempo real. Alimente-o com dados ricos através de device_info e antifraud_info na requisição de cobrança para maximizar taxas de aprovação enquanto minimiza fraudes.
Por que o antifraude importa
| Métrica | Sem sinais | Com sinais completos |
|---|---|---|
| Taxa de falsos positivos | Mais alta | Reduzida |
| Taxa de estorno | Padrão | Mais baixa |
| Taxa de aprovação | Padrão | Mais alta |
| Confiança do emissor | Padrão | Elevada |
Categorias do motor de risco
| Categoria | Pontos de dados |
|---|---|
| Sinais do dispositivo | Impressão digital, endereço IP, user agent, dimensões da tela |
| Comportamento e velocidade | Tentativas repetidas, saltos de valor, múltiplos cartões |
| Atributos de pagamento | BIN, valor, MCC, moeda, parcelas |
| Metadados do cliente | E-mail, telefone, consistência de endereço |
| Histórico e reputação | Listas internas de permissão/bloqueio, histórico de disputas |
Objeto device_info
Anexe device_info ao payload da cobrança para identificar o dispositivo e a sessão:
| Campo | Descrição |
|---|---|
device_id | Impressão digital estável de A55Pay.getDeviceId() |
ip_address | IP público do cliente |
user_agent | String do user agent do navegador |
session_id | Identificador da sessão de checkout |
SDK: impressão digital do dispositivo
- getDeviceId
- regenerateDeviceId
const deviceId = A55Pay.getDeviceId();
Retorna uma impressão digital do dispositivo baseada no motor de risco global. Use como o campo device_id.
const newDeviceId = A55Pay.regenerateDeviceId();
Gere uma nova impressão digital quando o usuário trocar de dispositivo, limpar o armazenamento ou sua política exigir rotação.
Envie o mesmo device_id durante toda a sessão de checkout. Mudanças frequentes e inexplicadas enfraquecem a pontuação de risco.
Objeto antifraud_info
Carrega contexto comportamental e de canal — envie todos os campos que seu produto puder fornecer:
| Campo | Descrição |
|---|---|
sales_channel | Identificador do canal (web, app, call center) |
is_logged_in | Se o portador do cartão está autenticado |
cardholder_since_days | Tempo de conta em dias |
purchase_count | Total de compras históricas |
purchase_amount_avg | Ticket médio |
shipping_matches_billing | Flag de consistência de endereço |
is_first_purchase | Flag de primeira compra |
Um antifraud_info esparso pode aumentar falsos positivos. Trate-o como uma etapa de integração obrigatória para fluxos de cartão não presente.
Fluxo de decisão antifraude
Exemplo de payload de cobrança
{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 10000,
"currency": "BRL",
"type_charge": "credit_card",
"card_number": "4111111111111111",
"card_cvv": "123",
"device_info": {
"device_id": "tmx_abc123xyz",
"ip_address": "203.0.113.42",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
"session_id": "sess_7f3a2b1c"
},
"antifraud_info": {
"sales_channel": "web",
"is_logged_in": true,
"cardholder_since_days": 365,
"purchase_count": 12,
"is_first_purchase": false
}
}
O antifraude complementa (não substitui) 3DS, network tokens e DataOnly. Empilhe os controles adequados para o seu perfil de risco.