← Back to blog

Oct 26, 2026 · 8 min read

Checkout internacional: como testar SSN, EIN e VAT sem dados reais

Roteiro de testes para formulários de cobrança nos EUA e na União Europeia: formatos de SSN, ITIN e EIN, validação de VAT com VIES, reverse charge e os casos de borda que costumam quebrar em produção.

Mapa-múndi e globalização
Photo: Chuttersnap / Unsplash

Quando o produto sai do Brasil, o formulário muda

Um SaaS brasileiro que começa a vender para fora descobre rápido que CPF e CNPJ têm equivalentes em cada país, cada um com formato, regra e implicação fiscal própria. Nos Estados Unidos, a pessoa física se identifica com SSN ou ITIN, e a empresa com EIN. Na União Europeia, o que importa no B2B é o número de IVA intracomunitário, o VAT number. Errar a validação gera dois tipos de problema: clientes legítimos bloqueados no checkout e notas emitidas com imposto errado.

Este roteiro cobre o que testar em cada campo usando apenas dados sintéticos. Usar SSNs reais em teste é ainda pior do que usar CPFs reais: nos EUA, o SSN é a chave de roubo de identidade.

Estados Unidos: três números de 9 dígitos que parecem iguais

  • SSN (Social Security Number), formato AAA-GG-SSSS. Área 000, 666 e 900–999 nunca são emitidas; grupo 00 e série 0000 também não. Desde 2011 os números são atribuídos aleatoriamente, então a área não indica mais o estado.
  • ITIN (Individual Taxpayer Identification Number), para quem paga imposto nos EUA sem ter direito a SSN. Começa sempre com 9, e os dígitos 4 e 5 ficam em faixas definidas pelo IRS (como 50–65 e 70–88).
  • EIN (Employer Identification Number), da empresa, escrito XX-XXXXXXX. O prefixo de dois dígitos segue uma lista publicada pelo IRS.

Nenhum dos três tem dígito verificador. Diferente do CPF, não existe conta que pegue erro de digitação; a validação de formato é o máximo possível sem consultar o governo.

Casos de teste para o campo de SSN/ITIN/EIN

  • Com e sem hífens: 123-45-6789 e 123456789 devem ser aceitos e salvos no mesmo formato.
  • Áreas proibidas (000, 666, 9XX) rejeitadas quando o campo é especificamente SSN.
  • Um ITIN (9XX) aceito quando o campo é "SSN ou ITIN", que é o caso comum em cadastros fiscais.
  • Um EIN no formato XX-XXXXXXX aceito no cadastro de empresa e rejeitado no de pessoa.
  • Máscara na exibição (***-**-6789) e criptografia no banco. O SSN completo nunca deve aparecer em logs, e-mails ou telas de suporte.
  • Mensagem de erro que diga qual regra foi violada, sem ecoar o número inteiro.

O gerador de SSN da Ontoom cria números que respeitam essas regras de formato e mostra qual regra um número inválido quebrou.

União Europeia: o VAT number decide o imposto

Em vendas B2B entre países da UE, quando o cliente informa um VAT number válido, a fatura sai sem IVA e o cliente recolhe o imposto no país dele: é o mecanismo de reverse charge (autoliquidação). Sem um número válido, a venda é tratada como B2C e o IVA do país do cliente precisa ser cobrado. Para serviços digitais vendidos a consumidores, isso é declarado pelo regime OSS (One-Stop Shop).

Ou seja, o campo de VAT não é só cadastro: ele muda o valor final do pedido. Por isso a validação tem duas fases: • no formulário, verificar o formato do país (DE + 9 dígitos, FR + 2 caracteres + 9 dígitos, NL com a letra B no meio, Grécia com prefixo EL em vez de GR); • no servidor, consultar o VIES, o serviço da Comissão Europeia que confirma se o número está ativo, e guardar o resultado da consulta como evidência.

Casos de teste para o campo de VAT

  • Número com espaços e pontos, como vem copiado de uma fatura belga ou francesa (BE 0123.456.789): normalizar antes de validar.
  • Número sem prefixo de país, com o país escolhido em outro campo.
  • Grécia com EL aceita e com GR rejeitada (ou convertida).
  • Reino Unido (GB) fora do VIES desde o Brexit; Irlanda do Norte usa XI para mercadorias.
  • Formato válido, mas VIES respondendo "inválido": cobrar IVA e avisar o cliente.
  • VIES fora do ar ou com timeout, algo comum em alguns países: não liberar a isenção por padrão. Cobre IVA ou deixe o pedido pendente para revalidação.
  • Cliente do mesmo país do vendedor: VAT válido, mas sem reverse charge.
  • Recalcular o total na tela quando o VAT é informado ou removido.

Montando a massa de teste

Uma boa massa cobre cada combinação que muda o comportamento: pessoa física nos EUA com SSN, com ITIN e sem número; empresa americana com EIN; empresa europeia com VAT válido de outro país, do mesmo país e inválido; e consumidor europeu sem VAT. Gere os números com ferramentas de dados sintéticos e guarde-os como fixtures versionados, para que os testes sejam reproduzíveis.

Para o lado bancário do mesmo checkout, o gerador de IBAN da Ontoom cria contas de teste com dígitos de controle válidos para 74 países. Assim o fluxo inteiro, do cadastro ao pagamento, roda sem nenhum dado real.

Gerar e validar VAT de teste

Roteiro de testes para formulários de cobrança nos EUA e na União Europeia: formatos de SSN, ITIN e EIN, validação de VAT com VIES, reverse charge e os casos de borda que costumam quebrar em produção.

Gerar e validar VAT de teste