无效的 MSISDN 绝对不能扣款

无效的 MSISDN 绝对不能扣款.

入口验证与下游失败的区别

在路由大容量短信或验证码流量时，区分入口处的无效目标地址与下游投递失败对于财务完整性至关重要。任何无效的 MSISDN 都必须在发生任何账本交易之前，在 API 网关处被立即拒绝。如果无效号码绕过了入口检查，它可能会生成一个状态未知的下游投递回执(DLR)，这看起来像产生了消费，但实际上没有任何投递。IOSOR 强制执行严格的验证规则来防止这种情况，确保您的余额免受错误目标格式的侵害。此外，系统在入口处还会评估静音时段(Quiet Hours)限制。根据目标国家或地区的本地合规法律，在深夜或特定免打扰时间段内，发送非紧急通知可能会被直接拦截或延迟投递。在入口处识别这些静音规则，不仅能避免因违反合规而产生的潜在罚款，还能防止无效的短信尝试占用您的通道容量。

E.164 解析引擎

针对移动号码的每一个 API 请求都会根据全球 E.164 标准进行实时解析。平台会检查国家代码、国内目的地代码以及用户号码的长度。如果格式无效，网关会立即返回 HTTP 400 Bad Request。这种即时验证确保了在分配资源或应用任何预付费冻结之前，不存在的路由路径就被彻底阻断。该机制可防止无效号码触发产生隐藏成本的下游运营商查询。

账本规则与预付费冻结

为了维持健康的余额状态，IOSOR 使用了实时账本。当一个有效的短信请求被接受时，您的余额上会放置一个临时的预付费冻结。如果消息成功路由，冻结将转化为扣款。然而，如果该号码在入口处被标记为无效，则不会创建冻结，并且扣款金额为零。这保护了您的 20 美元预付费底线，使其免受格式错误的目标字符串的侵蚀。在 IOSOR 的实时计费架构中，预付费钱包冻结(Prepaid Wallet Holds)扮演着核心角色。当 API 接收到合规请求时，系统会立即在您的钱包中冻结对应通道费率的资金，而不是直接扣除。这种临时冻结机制确保了高吞吐量并发发送时的账目准确性。如果遇到无效号码，冻结将瞬间释放。为了确保高可用性并防止由于突发流量导致服务中断，平台要求账户必须维持 20 美元的最低余额底线(USD 20 Floor)。一旦可用余额低于此阈值，系统将发出预警，但入口验证依然会保护这最后的 20 美元不被无效的垃圾请求消耗殆尽。对于规模不断扩大的账户，在 1,000 美元/月左右进行一次软审查，有助于优化路由表并调整专用资源的月度循环费用(MRC)限制。

Webhook 载荷与错误代码

当消息在入口处被拒绝时，API 响应包含一个特定的错误载荷。您的应用程序不会等待异步的 DLR Webhook，而是立即收到同步错误。该载荷包含无效参数和清晰的拒绝代码。对于有效号码，系统将分配路由路径并通过 Webhook 发送状态更新(包括 STOP 和验证成功事件)，在不浪费 API 周期的前提下确保您的消息管道完全透明。在处理大规模消息传递时，DLR 与 Webhook 的真实性(DLR/Webhook Truth)是衡量通道质量的唯一标准。有些劣质渠道会伪造成功的 DLR，而 IOSOR 坚持透传来自终端运营商的真实状态。同时，系统支持自动的退订同步(Opt-out Sync)。当终端用户回复 STOP 或其他退订关键字时，该退订状态会立即同步至您的全局黑名单数据库。后续针对该号码的任何发送请求都将在入口处被直接拦截，不再产生任何预付费钱包冻结，从而在源头上保障了数据的清洁度与合规性。

开发者资源与集成

为了构建能够避免不必要开支的强大集成，开发人员应在调用 API 之前实现客户端验证。请查看以下重要指南以优化您的实现：

• 在 API 入口验证 E.164 电话格式
• 钱包试点周：真实流量下的冻结与扣款真相
• SMS API 采购清单

从 IOSOR 开始

在沙箱里 POST 一个缺国家码的目的地，再 POST 一个长度不可能的号码。应得到 HTTP 400，ledger 不动——没有 hold，没有扣款。再发一个合法 E.164，确认 hold 只在 accept 之后出现。若无效那对已经动了钱，入口解析就坏了。

IOSOR 要点

入口的格式拒绝不是投递失败。非法 MSISDN 绝不该开 hold。要做：钱动之前先解析 E.164。不要：等一条 unknown DLR 来解释本不该存在的扣款。号码没成形，ledger 就该安静。