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
- Resolving Timing Gaps Between Hold Expiration and Ledger Settlement
Learn how to reconcile unreleased platform authorizations when delivery status webhooks arrive after hold TTLs in your white-label CPaaS ledger.
- Reconciling Stuck Prepaid Holds After Upstream Outages
Step-by-step playbook for auditing and releasing lingering prepaid system holds across all billing channels following platform network incidents.
- Detecting Wallet Spend Velocity Anomalies Before Balance Exhaustion
Learn how IOSOR detects abnormal prepaid spend velocity, halts anomalous automated outbound traffic instantly, and protects funds from sudden drainage.