IOSOR Learn

Wallet invoice week: holds, captures, and refunds on one export

Reconcile invoice week transactions, holds, captures, and auto-refunds in a single white-label wallet export.

Wallet invoice week: holds, captures, and refunds on one export.

Understanding the invoice week financial cycle

During invoice week, platform operators reconcile fluctuating traffic against the prepaid wallet balance. Every transaction involving DLR confirmation or JIT number allocation generates detailed ledger entries. When running operations at scale, tracking holds versus actual debits ensures that your white-label brand maintains accurate financial records without discrepancies between carrier signals and billing logs.

Holds and captures in ledger exports

When a messaging route or voice termination initiates, the platform places a temporary hold on funds. This hold secures capital before the final delivery confirmation arrives. Once the webhook reports a successful DLR, the hold transitions into a permanent debit. If the delivery fails, the system triggers a Hold fail auto-refund and status truth to restore the balance instantly, keeping your ledger clean.

Auto-refund lines and reconciliation

Invoice week reports consolidate these status transitions into unified CSV or JSON exports. Automatic refunds appear as distinct credit lines to offset expired holds. Operators review these rows alongside incoming top-ups. Maintaining the USD 20 prepaid floor prevents accounts from entering negative balance states during high-volume OTP traffic spikes.

Traffic thresholds and protective stops

As platform usage grows toward the soft review near USD 1,000/month, automated monitoring systems evaluate consumption velocity. If traffic patterns deviate from normal operational baselines, Wallet volume review: stop-lines still bind to pause further outbound spending until manual review or balance replenishment clears the account.

Comparing holds, debits, and refunds

Transaction Type Financial State Export Behavior
Hold Pending delivery Reserves funds
Debit Captured via DLR Deducts balance
Refund Failed HB or DLR Credits wallet

Start with IOSOR

Navigate to the IOSOR Billing console and select the invoice week ledger export tool. Filter the unified transaction log by pending holds, captured debits, and auto-refund lines to cross-verify DLR timestamps against wallet adjustments. Set up automated webhook alerts for uncaptured holds that exceed your maximum delivery window to catch stalled traffic before final invoice settlement.

IOSOR takeaway

This guide demonstrated how hold, capture, and refund cycles operate within a unified invoice week export. Understanding how temporary reserves transition into captured debits upon DLR arrival ensures precise balance tracking without phantom deductions.

Do reconcile pending holds against DLR webhooks weekly and verify auto-refund lines for failed routes. Don't mistake temporary balance holds for final charges or overlook unreleased reserves when calculating your operational prepaid runway.

Was this guide helpful?

Related guides