Casos de uso

Detectando o país de origem para relatórios de conformidade

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/.