Qualidade dos Dados do Pagador
Quick Reference
Continue enviando a cobrança que você envia hoje. Antes de chegar à adquirente, conferimos cada dado do pagador, corrigimos o que dá para corrigir com certeza e dizemos exatamente o que aconteceu.
Por que isso importa
O dado do pagador se estraga entre o checkout e a adquirente: o CEP perde o zero à esquerda, o número da casa fica dentro da rua, o estado chega por extenso. Cada inconsistência faz um comprador legítimo parecer menos confiável.
Isso tem custo medido. Em mais de 250 mil vendas aprovadas no nosso histórico, as vendas com campos de endereço que não batiam foram contestadas cerca de duas vezes mais do que as vendas com campos coerentes (1,73% contra 0,82%).
O que muda em uma cobrança
| Campo | Você envia | A adquirente recebe |
|---|---|---|
| Rua | 200 Main St | 200 Main St |
| Número | vazio | 200 |
| Cidade | Boston | Boston |
| Estado | Massachusetts | MA |
| CEP | 2108 | 02108 |
O que você ganha
| Nenhum trabalho de integração | Ativado na sua conta. Sua requisição continua igual. |
| Dados consistentes em toda adquirente | Cada campo vai no formato que aquela adquirente espera, em qualquer rota. |
| Endereços em que você pode confiar | Quando o CEP dos EUA é inutilizável, o certo vem de dados postais oficiais. No nosso teste com endereços de CEP conhecido, 190 de 191 respostas estavam corretas. |
| Mais força em disputas | O cadastro do comprador fica igual de uma compra para a outra, que é o que você precisa para contestar um chargeback. |
| Visão completa | Cada cobrança diz, campo a campo, o que foi conferido e o que mudou. |
| Sem custo para a velocidade | As conferências levam microssegundos. A única confirmação externa acontece na primeira vez que um comprador tem CEP inutilizável, é limitada a cerca de um segundo e nunca impede a venda. |
A aprovação é sempre decisão do emissor. O que este recurso tira do caminho são os motivos evitáveis de dúvida.
Como funciona
- Padroniza. País, estado, telefone e número da casa no formato esperado.
- Confere. CEP, cidade e estado são comparados entre si com referências públicas.
- Corrige, só com certeza. Um campo só muda quando outros dados do mesmo comprador confirmam o valor certo.
- Registra. Sua requisição original fica guardada sem alteração, e cada mudança é registrada com regra e origem.
Veja o que aconteceu
A resposta da cobrança e o webhook trazem o objeto data_quality. Ele contém situações, nunca valores do pagador.
"data_quality": {
"version": "1",
"mode": "standard",
"fields": {
"payer_address.postal_code": { "status": "certified", "rule": "US-CERT-01", "source": "postal_authority" },
"payer_address.address_number": { "status": "normalized", "rule": "ADDR-NUM-01", "source": "street" },
"payer_cell_phone": { "status": "valid" }
},
"flags": []
}
| Situação | Significado |
|---|---|
valid | Passou nas conferências |
normalized | Mesma informação, no formato padrão |
corrected | Corrigido porque outros dados do comprador confirmam o valor certo |
certified | Confirmado com dados postais oficiais |
unverified | Presente, mas sem confirmação; reason explica quando conhecido |
missing | Não enviado |
flags são informativos e novos podem ser adicionados, então não crie lógica que falhe diante de um sinal desconhecido.
O controle continua com você
Opcional, por cobrança:
"data_quality": { "mode": "standard" }
| Modo | O que acontece |
|---|---|
standard | Confere e corrige. Padrão. |
validate_only | Só informa. O dado segue como você enviou. |
off | O recurso não atua nesta cobrança. |
O que nunca faz
- Nunca inventa nomes, documentos, endereços ou dados de aparelho.
- Nunca reescreve o nome ou a cidade do comprador.
- Nunca altera a requisição que você enviou.
Se a adquirente exige um campo que não existe, como o número da casa, usa-se o valor aceito por ela e o campo é informado como unverified.
Tire o máximo
Quanto mais perto do comprador estiver o dado, melhor o resultado: envie CEP e estado como digitados no checkout, o IP público do comprador e os dados lidos do navegador dele.
Como ativar
Fale com o seu gerente de conta. Não precisa mudar código.