在发起付费银行名称核验前，先拒绝输错的 CLABE

问题与你需要做的决定

你的付款开户流程会收集 CLABE，随后可能在另一个经过授权的流程中发起付费核验，例如银行名称比对。输入错误很常见：两位数字顺序颠倒、少输一位、复制粘贴带入多余空格。把这些输入继续发送出去，既要花费一次请求，又会让用户看到令人困惑的失败结果。你需要决定在哪里拦截错误输入。本文的建议是：先在本地检查校验位，只拒绝结构错误或校验位不通过的输入，并把通过视为可以提出下一个问题的许可，而不是那个问题的答案。

本地工具实际做了什么

已实现的行为范围很窄。check_clabe_format 工具接受 18 位 CLABE，可以用空格或连字符分隔，在本地运行，不访问网络。它返回 structure_valid（输入规范化后为 18 位数字）、checksum_valid（最后一位控制位与前 17 位的加权计算结果一致）以及 institution_code（前三位数字）。它不进行任何实时银行查询，也不对账户归属作任何断言。校验位正确并不能证明账户存在、能够收款或属于某个人。除这些字段之外的一切，例如如何引导用户、是否调用付费核验，都属于建议的应用设计，需要由你的代码负责。

假设场景与预期的 fixture 输出

假设付款文件中的某一行包含示例值 032180000118359719。经过测试的本地输出为：structure_valid 为 true，checksum_valid 为 true，institution_code 为 "032"，scope 为 "checksum_only"，account_exists 为 null，ownership_verified 为 false，network_calls 为 0，charged 为 false。请逐字理解每个字段。account_exists 为 null，是因为根本没有询问账户是否存在，而不是已经确认或否认了存在。ownership_verified 为 false，是因为归属从来不在检查范围内。network_calls 为 0 和 charged 为 false 说明这次检查没有产生费用，也没有联系任何外部方。在建议的设计中，这一行可以进入下一个经过授权的步骤。如果操作员输入的是 032180000118359791，即最后两位颠倒，可以预期 checksum_valid 为 false，该行会在任何付费请求之前被拦下；请在你自己的测试中确认这一预期，而不要直接假定。

失败处理

把三种结果分开处理。结构失败：去除空格和连字符后多于或少于 18 位，或含有非数字字符；请用户重新输入，并显示当前的位数。校验位失败：有 18 位数字但控制位不一致；提示号码可能输错并请求更正，不要暗示账户存在欺诈或已关闭。通过：继续流程，但记录仍须标注为 checksum_only。不要在数据库中把通过写成 account_verified，也不要据此自动放款。对于批量导入，应逐行标记失败记录，而不是拒绝整个文件；也绝不要静默修正某一位数字，因为猜出来的数字可能指向另一个人看似有效的号码。

需要明确说明的限制

这个工具只是本地的输入过滤器。它不查询银行，不确认机构代码当前是否可用于付款，不核验收款人姓名，也不确定谁控制该账户。本文中的商户示例是合成的契约说明，并非实际上线验收。任何付费的身份或收款账户核验都是独立的流程，需要当前可用的能力、授权以及已接受的报价。目前没有任何使用数据可以支持节省成本或提升转化的说法；观察到的计数均为零，也不意味着任何因果关系。

验收清单

上线前请确认：示例输入恰好返回上述八个字段；同一号码用空格或连字符分隔时结果相同；17 位输入使 structure_valid 为 false；数字颠倒的输入使 checksum_valid 为 false，且不会触发任何后续请求；保存的记录保持 scope 为 checksum_only、ownership_verified 为 false；结构失败和校验位失败给用户的提示各不相同；没有任何代码路径仅凭这项检查就把账户标记为已核验或放款；批量导入逐行报告失败记录；后续的付费核验只能通过其自身经过授权的流程调用。

检查这项功能

https://gridzen.ai/tools/clabe-format/ · 核对输入、输出与能力边界。以下命令只读取产品说明，不执行真实请求。

gridzen tools --product clabe-format

来源与范围

https://gridzen.ai/tools/clabe-format/ https://gridzen.ai/guides/current-capabilities/ 依据已检查的来源快照与本地模拟；建议的业务规则属于设计建议，不代表已证明的生产行为。内容使用 AI 辅助写作，并经过独立审稿。