Validador del algoritmo de Luhn

El validador del algoritmo de Luhn comprueba si una cadena numérica cumple la conocida fórmula de suma de control módulo 10. Envíe los dígitos tal como aparecen, incluidos los ceros iniciales, y recibirá un resultado sencillo: válido o no válido. La capacidad solo valida la suma de control; no identifica al emisor, no confirma que exista una cuenta ni contacta con servicios externos. Las entradas con caracteres que no sean dígitos se rechazan expresamente en vez de limpiarse de forma silenciosa, lo que hace predecible la automatización y ayuda a detectar errores de formato antes de que lleguen a otro sistema.

Qué indica realmente un resultado de Luhn

La suma de control de Luhn es una regla compacta para detectar errores en secuencias de dígitos decimales. Desde la derecha, el algoritmo conserva el dígito de control, duplica cada segundo dígito, resta nueve cuando el doble tiene dos cifras y suma los valores resultantes. El número es válido si el total es divisible entre diez.

Así se detectan todos los cambios accidentales de un solo dígito y muchas transposiciones adyacentes habituales. Un resultado válido no demuestra que el número haya sido emitido, pertenezca a alguien, esté activo o permita una transacción. Solo indica que la cadena proporcionada es coherente con la fórmula de Luhn.

Esta distinción importa en interfaces y canalizaciones: presente el resultado como validez de la suma de control, no como verificación de identidad o cuenta. El validador conserva la representación textual, incluidos los ceros iniciales, y nunca convierte la entrada en un número de JavaScript; por ello, los identificadores largos mantienen todos sus dígitos sin pérdidas de precisión.

Cómo preparar la entrada e interpretar los errores

Envíe el valor en el campo <code>number</code> como una cadena no vacía formada únicamente por los caracteres del cero al nueve. Se rechazan espacios, guiones, signos de suma, puntos decimales, saltos de línea y letras. Este comportamiento estricto es intencionado.

Eliminar signos de forma silenciosa puede ocultar un defecto de formato anterior, cambiar el significado del texto copiado o hacer que dos sistemas parezcan coincidir aunque recibieran datos distintos. Si el origen presenta valores agrupados, normalícelos deliberadamente en su flujo antes de llamar a esta capacidad y conserve el original cuando necesite trazabilidad. No convierta primero la cadena en entero: podría eliminar ceros iniciales y redondear valores largos.

Una llamada correcta siempre devuelve un objeto con un campo booleano llamado <code>valid</code>. <code>true</code> significa que el total es divisible entre diez; <code>false</code>, que la entrada es sintácticamente correcta pero no supera la suma de control. Un error de entrada es distinto de un resultado falso y normalmente requiere corrección o revisión.

Cómo usar una validación determinista en aplicaciones

Utilice este validador en los límites por los que las cadenas numéricas entran en un sistema: envío de formularios, importaciones por lotes, migraciones, generación de datos de prueba o pruebas de integración. En formularios interactivos, ejecute la versión del navegador cuando la persona termine de introducir el valor y explique que la comprobación detecta errores probables sin demostrar que exista una cuenta. En una importación, trate los errores de caracteres como registros mal formados y los resultados falsos como registros bien formados cuya suma no coincide.

Separar ambos casos mejora los informes y conserva diagnósticos útiles. El algoritmo es determinista, no usa red, no consulta el reloj ni genera valores aleatorios; una misma entrada siempre produce la misma salida. Tampoco aplica reglas de longitud o prefijo propias de un emisor: cualquier cadena no vacía de dígitos recibe el mismo cálculo.

Si su dominio exige longitudes, prefijos, titularidad o estado en tiempo real, aplique esas reglas por separado.