Vender produtos digitais além das fronteiras traz uma obrigação de relatório que muitos vendedores menores subestimam até que ela vire um problema: saber, com razoável confiança, em qual país cada transação realmente ocorreu, já que o tratamento tributário e as exigências de relatório para vendas digitais muitas vezes dependem especificamente da localização do comprador, e não da do vendedor. Um país declarado pelo próprio comprador em um formulário de checkout é um começo, mas também é muito fácil de um comprador errar ou falsear, de propósito ou não, e um vendedor preocupado com conformidade precisava de um segundo sinal, independente, para conferir essa declaração.
O vendedor adicionou uma verificação no servidor no momento da compra. /v1/ip resolvia o endereço IP do comprador em um campo de país, comparado automaticamente com o país que o comprador tinha digitado ou selecionado durante o checkout. Quando os dois coincidiam, o que acontecia na esmagadora maioria das transações, nada mais acontecia, e o país declarado ficava como o país de registro da transação. Quando divergiam, a transação era sinalizada para uma análise mais cuidadosa antes de ser finalizada, já que uma divergência podia significar qualquer coisa, desde um comprador viajando e usando os dados de cobrança do seu país até alguém navegando por uma VPN ou uma tentativa real de falsear sua localização para obter vantagem de preço ou de imposto.
O vendedor tomou cuidado para não tratar toda divergência como prova de má-fé, já que muitas transações legítimas envolvem alguém temporariamente fora do seu país fazendo uma compra com seus dados de pagamento habituais. A sinalização acionava uma etapa de análise, e não um bloqueio automático, e a análise considerava a transação como um todo, com o país do meio de pagamento, o endereço de cobrança e o país detectado pelo IP juntos, em vez de rejeitar qualquer coisa apenas por uma divergência de IP.
Para seus próprios registros de conformidade, o vendedor guardava tanto o país declarado quanto o país detectado pelo IP em cada transação, junto com uma nota sobre como qualquer divergência tinha sido resolvida. Esse registro dava à empresa algo concreto para apresentar caso uma autoridade fiscal ou um processador de pagamentos perguntasse como ela determinava o país de uma venda: um processo documentado e consistente, e não uma afirmação impossível de verificar, baseada apenas nos dados do formulário de checkout.
Nada disso substitui uma orientação tributária e jurídica adequada, específica para as jurisdições em que o vendedor atua, e a empresa tratou a verificação de IP como um dos elementos de um processo de conformidade mais amplo, construído com a orientação dos seus próprios contadores, e não como uma solução completa por si só. O que a geolocalização de IP contribuiu especificamente foi um sinal barato, consistente e obtido no servidor, que não dependia de o comprador preencher um formulário com honestidade, o que fortaleceu de forma significativa um processo de conformidade que antes dependia apenas de dados autodeclarados.
O volume acompanhou diretamente o volume de transações, uma consulta por compra, o que, para um vendedor de produtos digitais de porte médio, cabe folgadamente na cota diária gratuita na maioria dos meses e passa para o crédito pré-pago em um período de vendas forte sem exigir nenhum planejamento antecipado, já que o custo por requisição cresce na mesma direção que a receita.
Acertar a detecção de país passa a importar mais no momento em que uma empresa começa a levar a sério suas obrigações tributárias e de relatório, e vale a pena ter um sinal confiável e independente, que não dependa do que o comprador escolhe digitar, antes que ele seja necessário, e não depois. A documentação do endpoint está em /docs/ipv4-lookup/ e /docs/ipv6-lookup/.
Um código postal e uma cidade que não batem em um formulário de pedido parecem um pequeno erro de digitação até virarem uma entrega enviada para uma região totalmente diferente do país.
Uma empresa de logística queria um alerta simples no momento em que um caminhão de entregas entrasse ou saísse do local de um cliente específico, sem construir ou licenciar uma plataforma completa de rastreamento de frota.
Uma ferramenta de colaboração queria que os colegas de equipe vissem, de relance, onde um colega estava e mais ou menos que horas eram para ele, sem que ninguém precisasse digitar isso no perfil.