Luhn Validator

La herramienta implementa el algoritmo de suma de verificación Luhn para verificar números comúnmente usados en procesamiento de pagos y validación de identidades. Está destinada a desarrolladores, ingenieros de datos, QA y equipos de pagos que necesitan validación fiable y reproducible de identificadores numéricos antes de entrar en sistemas de gateway o pipelines analíticos. El enfoque es precisión, determinismo y comportamiento predecible a través de formatos de entrada. La herramienta funciona completamente offline, sin llamadas de red, y es adecuada para entornos sensibles y trabajos por lotes donde la privacidad de datos y el rendimiento son importantes.

Las entradas se limpian eliminando caracteres no numéricos, dejando una cadena puramente numérica. El algoritmo impone longitudes típicas (12–19 dígitos). El cálculo de Luhn procede desde la derecha: cada segundo dígito se duplica; si el resultado es mayor que 9, se resta 9; todos los dígitos se suman. Una suma final divisible por 10 indica validez. A petición, también puede reportarse un card_type estimado basándose en patrones de longitud de los dígitos, sin autenticación del emisor.

Las salidas son deterministas y estructuradas: is_valid (booleano), normalized_number (cadena de dígitos), digits_count (entero) y card_type opcional. El manejo de errores cubre entradas vacías, cadenas no numéricas tras limpieza y longitudes fuera de 12–19 dígitos. Supuestos: entrada numérica con separadores opcionales; exclusiones: búsquedas en tiempo real del emisor, procesamiento de transacciones o almacenamiento de datos sensibles. Casos de uso: validación de formularios en tiempo real, limpieza de datos y verificaciones pre-submisión para flujos de pago.