金融与税务标识符格式检查

目标与适用范围

检查信用卡号、IBAN/SWIFT、欧盟 VAT 号和美国 EIN 的语法、长度、国家规则及适用校验位；格式通过不等于账户、注册状态或余额可用。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 保留原始字符串和字段来源，先判断它是信用卡号、IBAN 或 SWIFT/BIC、欧盟 VAT 号，还是美国 EIN。

• 如果已知国家或欧盟成员国，请把它记录下来；不要仅凭残缺或复制错误的值猜测管辖范围。

• 单独定义账户存在性、税务注册、发卡授权或余额查询的后续检查，因为本流程只产出格式证据。

• 决策点: 应选择哪一种标识符路径？. 信用卡号使用 credit-card-validator，银行标识使用 iban-swift-validator，欧盟税号使用 eu-vat-validator，美国雇主识别号使用 us-ein-validator。字段名含糊时，先核对来源，不要盲选工具。

• 决策点: 哪些字符只是展示分隔符？. 许多信用卡号、IBAN 和 EIN 可以处理空格或连字符，但 VAT 与银行标识中的国家前缀和有效字母不能丢失。必须同时保留原值和规范化值。

• 决策点: 格式通过后是否还要做外部核验？. 格式通过只能放行语法相关步骤。如果业务需要确认账户有效、税号已登记、卡片可授权或余额充足，应转交获授权的外部服务，而不是扩大本流程的结论。

按步骤完成工作流

1. 分类候选值

先检查来源字段，再从四种支持的类型中选择一条路径。四个工具是路由集合，不意味着任何标识符都能交给任意工具处理。 使用 credit-card-validator, iban-swift-validator, eu-vat-validator, us-ein-validator.

2. 在不丢证据的前提下规范化

保留原始字符串，只按所选类型允许的规则处理首尾空白、大小写、空格或连字符。保留国家前缀和有意义的字符，让复核人员可以重现检查。 使用 credit-card-validator, iban-swift-validator, eu-vat-validator, us-ein-validator.

3. 执行类型专属规则

查看返回的长度、结构、国家或前缀信息，以及适用的校验位结果。EU VAT 要核对检测到或指定的成员国；EIN 的九位结构和前缀检查仍只是格式判断，不是登记查询。 使用 credit-card-validator, iban-swift-validator, eu-vat-validator, us-ein-validator.

4. 记录有边界的结论

保存规范化候选值、工具输出、警告和修正原因。只有相关检查都通过时才标记为格式接受；账户、注册、授权和余额问题另走已批准的核验服务。 使用 credit-card-validator, iban-swift-validator, eu-vat-validator, us-ein-validator.

交付前验收结果

• 原始值、选定的标识符类型、规范化规则和预期国家范围已一起记录。
• 候选值符合适用的字符集、长度、前缀、国家格式和结构规则。
• 适用的校验位或校验和通过；不要求校验位的类型不能被误判为失败。
• 最终记录区分格式错误、规则失败、警告和格式通过，不把它们写成业务状态或法律状态。

常见问题

• 格式有效是否证明账户、卡片或税务登记真实存在？ 不能。它只说明输入符合已实现的格式规则，不会证明账户存在、卡片已获授权、VAT 已登记、EIN 已分配给某家公司、所有权或余额可用。
• 四个工具分别检查什么？ 信用卡号使用 credit-card-validator，IBAN 或 SWIFT/BIC 使用 iban-swift-validator，欧盟 VAT 号使用 eu-vat-validator，美国 EIN 使用 us-ein-validator，并在记录中写明类型选择。
• 检查前可以删除空格和连字符吗？ 只有当它们是该类型的展示分隔符时才可以。保留原值、国家前缀和有意义的字母，不要静默改写无法确定含义的输入。
• 候选值失败后怎样处理？ 保存完整错误和规范化值，与来源记录逐项比较，修正明确的输入问题后沿用同一类型重新检查；无法确定状态时应联系负责的服务方或登记机构。