Luhn Validator

A ferramenta implementa o algoritmo de soma de verificação Luhn para verificar números comumente usados no processamento de pagamentos e validação de identidade. Destina-se a desenvolvedores, engenheiros de dados, QA e equipes de pagamentos que precisam de validação confiável e reproduzível de identificadores numéricos antes de entrarem em sistemas de gateway ou pipelines analíticos. O foco está em precisão, determinismo e comportamento previsível em diferentes formatos de entrada. A ferramenta funciona inteiramente offline, sem chamadas externas, sendo adequada para ambientes sensíveis e trabalhos em lote onde privacidade de dados e throughput importam.

As entradas são limpas removendo caracteres não numéricos, restando uma string de dígitos. O algoritmo exige comprimentos típicos (12–19 dígitos). O cálculo de Luhn procede da direita: cada segundo dígito é dobrado; se o resultado for maior que 9, subtrai-se 9; todos os dígitos são somados. Uma soma final divisível por 10 indica validade. A pedido, também pode ser relatado um card_type estimado com base em padrões de comprimento dos dígitos, sem autenticação do emissor.

As saídas são deterministas e estruturadas: is_valid (booleano), normalized_number (sequência de dígitos), digits_count (inteiro) e card_type opcional. O tratamento de erros abrange entradas vazias, strings não numéricas após limpeza e comprimentos fora de 12–19 dígitos. Suposições: entrada numérica com separadores opcionais; exclusões: consultas em tempo real do emissor, processamento de transações ou armazenamento de dados sensíveis. Casos de uso: validação de formulários em tempo real, limpeza de dados e verificações pré-submissão para fluxos de pagamento.