Dígito de control Luhn mod-10

Los códigos de cuenta largos, fragmentos de IMEI, números de socio y series internas son fáciles de teclear mal. El algoritmo de Luhn —también llamado esquema de dígito de control módulo 10— añade un único dígito final de modo que la mayoría de las sustituciones de un dígito y muchas transposiciones adyacentes rompen la suma de verificación. Esta capacidad calcula ese dígito para cualquier carga útil de dígitos puros que usted ya tenga, o valida un número completo que ya lo incluya, y rechaza la entrada no numérica con un error claro en lugar de eliminar guiones o letras en silencio. A diferencia de un comprobador solo para tarjetas de pago, acepta cualquier longitud de dígitos para que usted pueda proteger SKU de almacén, identificadores de fidelización y etiquetas por lotes con la misma regla que la industria ya confía en las tarjetas.

Qué hace el algoritmo Luhn mod-10 y qué errores caza

Los dígitos de control existen porque las personas y los teclados introducen daños predecibles: una tecla equivocada, dos dígitos vecinos intercambiados o un dígito insertado o eliminado al volver a teclear. Hans Peter Luhn publicó un procedimiento sencillo de derecha a izquierda que duplica cada segundo dígito, reduce los valores superiores a nueve restando nueve, suma el resultado y elige un dígito final para que el total sea divisible por diez.

Esa construcción caza todos los errores de un solo dígito y la mayoría de las transposiciones adyacentes, y por eso las redes de pago, los identificadores de telecomunicaciones y un sinfín de formatos de cuenta internos siguen confiando en ella décadas después. Esta herramienta implementa ese recorrido estándar sobre cualquier cadena de dígitos puros —no una variante propia ni un analizador de BIN de red de tarjetas—.

Usted obtiene el dígito de control como cadena de un carácter, el número completo con el dígito añadido, o un indicador booleano de validez con el dígito de control esperado recalculado solo a partir de la carga útil. La respuesta siempre nombra el algoritmo como luhn para que los sistemas posteriores registren qué esquema protegió el valor.

Frente a los dígitos de control de cuasigrupo Damm, Luhn es el valor por defecto de la industria para campos tipo tarjeta o cuenta; frente a los dígitos de la familia de códigos de barras (EAN, UPC, ISBN), Luhn no está atado a un diseño de GTIN minorista —se aplica a cualquier carga útil de dígitos que usted elija. Conocer esos compromisos le ayuda a elegir el esquema adecuado: use Luhn cuando la interoperabilidad con sistemas mod-10 existentes importe más que cazar hasta el último par de transposición.

Cómo calcular un dígito de control o validar un número completo

Envíe un campo number que contenga solo los caracteres del 0 al 9. El modo validate espera un número completo de al menos dos dígitos (uno o más dígitos de carga útil más el dígito de control final). Esa forma facilita mostrar «usted tecleó X, se esperaba Y» en un formulario sin una segunda llamada.

Las cadenas vacías, un number faltante y los valores de modo no válidos fallan antes de cualquier duplicación y no se facturan. Prefiera compute cuando acuñe identificadores nuevos; prefiera validate cuando reciba un identificador de un usuario, un fichero de socio o una etiqueta escaneada y necesite una comprobación booleana antes de buscar el registro.

Dónde encajan los dígitos de control Luhn en sistemas reales

Los programas de socios y fidelización acuñan identificadores numéricos secuenciales o aleatorios y necesitan un dígito final que los agentes del centro de llamadas y los teclados móviles no corrompan en silencio. Los equipos de almacén y logística imprimen códigos de bulto o de activo; un solo dígito mal tecleado en la ruta de un dispositivo de mano es habitual, y Luhn caza toda sustitución de un dígito.

Los flujos de telecomunicaciones y de dispositivos que ya documentan IMEI u identificadores similares en forma mod-10 pueden recalcular y verificar sin una interfaz específica de tarjeta. Las pruebas de integración y los trabajos de calidad de datos recalculan el dígito de control esperado para cada fila de una exportación CSV y marcan las filas donde el número completo almacenado ya no coincide, lo que caza tanto las ediciones humanas como los errores de desfase por uno en los generadores.

Los equipos de producto que ya exponen un validador Luhn de tarjeta para el pago pueden adoptar aún esta herramienta general para identificadores internos donde se exige el mismo algoritmo pero la entrada no es un PAN. No tome un control Luhn superado como prueba de autorización, propiedad o de que una tarjeta sea real —solo prueba que la cadena de dígitos está bien formada bajo este algoritmo, el mismo listón de honestidad que usted aplica a cualquier suma de verificación.