将 DLR 状态 Webhook 与预付费冻结金额进行关联

在使用 IOSOR 发送 OTP SMS 时，系统会针对每条消息在您的账户余额中预留一笔 USD 冻结金额。如果未能将接收到的 DLR webhook 状态与这些预付费冻结记录（prepaid hold）进行正确关联，可能会导致资金长期锁定或 ledger 账目不一致。通过实施基于 API 的 JIT 自动对账流程，您可以确保资金根据最终投递状态实时完成扣款或退回，从而优化 10DLC 业务的资金周转效率。

理解预付费钱包冻结机制

在 IOSOR 生态系统中，每条外发短信请求都会触发即时 (JIT) 账本检查。当请求发起时，系统会立即在预付费钱包余额中设置临时冻结，以确保有足够的资金用于消息发送。此冻结并非最终扣款，而是资金的预留。最终结算仅在从网络接收到 DLR (发送回执) 状态后才会进行，确保您的财务账本准确反映实际的消息信用消耗。预付费钱包在此过程中扮演核心角色，它通过锁定特定额度来隔离待处理交易，防止余额在发送高峰期被过度透支，确保账面资金始终处于受控的流动状态。

DLR 回调与账本真实性

消息发送后，网络会返回 DLR 状态。您的 Webhook 端点接收此负载，其中包含唯一的消息 ID 和最终状态码。IOSOR 引擎会将此 ID 与原始交易记录关联。如果状态显示发送成功，系统会将冻结金额转换为永久扣款；如果状态显示失败，冻结金额将释放回您的可用余额，确保您仅为成功的尝试付费。Webhook 负载是账本更新的唯一真实来源，任何未匹配的回调都会导致金额在缓存中滞留，因此务必验证回调签名的完整性，以保证财务数据与实际消息吞吐量完全一致。

预付费底线与流动性管理

对于维持 USD 20 预付费底线的账户，账本核对对于防止服务中断至关重要。如果您的账户余额接近此阈值，系统会通过静默模式限制发送速率，以保护您的核心业务不受突发扣款影响。我们建议设置自动充值触发器，确保余额始终高于 USD 20，从而避免在网络高延迟期间出现因冻结金额占用导致的发送失败。若您的月度业务量超过 USD 1,000/月，系统将触发软审查以调整信用额度，确保高频吞吐量下的资金周转顺畅，同时通过动态容量分配优化您的消息发送效率。

处理边缘情况与静默期

并非所有消息都能在预期窗口内收到 DLR。如果网络未能提供状态更新，IOSOR 系统会采用清理作业，在定义的 TTL (生存时间) 后释放陈旧的冻结金额。在夜间或用户设定的静默期内，由于网络响应可能变慢，系统会自动延长冻结释放的观察窗口。请务必确保您的 Webhook 处理程序在 500ms 内确认收到 DLR，以保持我们的账本与您的内部会计记录之间的同步。若因网络抖动导致账本不一致，请利用我们的审计接口进行手动对账，确保每一笔预留金额都能被精确追踪并匹配到相应的发送任务。

同步与 opt-out 机制

为了确保合规性，您的系统必须支持 opt-out 同步。如果用户在发送过程中回复退订指令，DLR 状态将包含特定的拒绝代码，此时系统会立即释放预留的冻结金额并更新您的黑名单记录。这种实时反馈机制不仅能优化账本准确性，还能避免向已退订用户发送消息产生的额外成本。请定期通过 API 获取最新的退订列表，并将其与您的本地数据库进行交叉比对，以确保营销活动的精准度，防止因发送无效请求而造成的财务损耗和声誉损失。

相关阅读: 重复的 webhook 绝不能产生第二笔扣款 · 事件顺序与账本过账 · 首次扣款前的预付资金预留.

从 IOSOR 开始

要完成您的集成，请前往 IOSOR 控制台并导航至 Webhook 设置，以配置您的账本对账端点。确保您的监听程序已准备好处理 dlr.status 负载，并将其直接映射到相应的交易冻结 ID。在沙盒环境中测试此关联，将确保预留资金能够即时释放或扣除，而不会产生账本偏差。

IOSOR 要点

本指南详细展示了如何在实时消息传送与财务账本准确性之间安全地架起桥梁。通过将传入的 DLR 回调与活跃的预付费冻结进行关联，您可以有效防止资金长期占用，并确保您的可用余额能够实时反映真实的传送状态，而非基于最坏情况的预估假设。在实施过程中，开发者必须在管理控制台中配置精确的 Webhook 终结点，并确保后端逻辑能够根据 UTC 时间戳对账单条目进行排序，以便在导出数据时保持一致性。请务必将您的 Webhook 处理程序设计为严格幂等，以确保重复的 DLR 信号不会触发多次账本调整或重复扣款。此外，不要完全依赖即时回调；当运营商因网络波动未能及时返回送达收据时，请始终在您的分类账系统中实现备用的 TTL 机制，以便在预设的超时周期后自动释放过期的冻结资金。您可以参考 /learn/messaging/dlr-management 了解更多关于状态回执的细节，或者访问 /learn/billing/prepaid-ledger-api 深入研究预付费分类账的 API 集成规范。通过这种方式，您可以确保每一笔通信支出都有据可查，从而提升整体业务的财务透明度与运营效率。