CHECKSUM GUIDE

Luhn 算法校验指南:原理、步骤与测试用例

Luhn 是一种轻量校验和,用来发现部分数字录入错误。它适合验证输入流程,却不能证明卡号真实存在、账户有效或交易能够授权。

Luhn 能检查什么,不能检查什么

Luhn 只根据数字序列本身计算校验结果。它能够捕获许多单个数字输错和部分相邻数字交换,但不会连接卡组织、发卡行或支付服务商。

因此,通过 Luhn 只能说明校验和成立。它不能回答号码是否已分配、账户是否开放、余额是否足够,也不能预测 sandbox 或真实支付结果。

校验位是怎样计算的

从最右侧校验位左边开始,隔一位将数字乘以 2;如果结果大于 9,则减去 9。把处理后的数字与未加倍数字相加,选择一个校验位,使总和能够被 10 整除。

实现时应把号码当作字符串,而不是 JavaScript Number。长数字转换为 Number 可能丢失精度,前导零也会消失。

  • 删除显示用空格和连字符
  • 拒绝其他非数字字符
  • 先检查全局及卡组织长度
  • 最后执行 Luhn 并返回明确原因

推荐的 QA 测试矩阵

不要只准备一个“通过”号码。至少分别覆盖:长度与 Luhn 均有效、长度有效但 Luhn 错误、Luhn 有效但卡组织长度错误,以及包含不允许字符的输入。

这些用例应单独失败,才能判断界面提示、日志脱敏和后端错误映射是否准确。TestPAN Studio 的负向模式正是为了隔离这些变量。

从本地校验进入支付 sandbox

本地 Luhn 测试适合输入限制、格式化、遮罩和错误状态。涉及 3DS、拒付原因、风控或授权结果时,应切换到支付服务商官方 sandbox 测试卡。

任何测试号码都不应提交到真实支付环境,也不要把完整值写入分析、崩溃报告或服务器日志。