IOSOR Learn
SMS invoice week: when segment math and the bill disagree
Resolve discrepancies between calculated SMS segments and actual prepaid debit rows on your first heavy invoice week.
SMS invoice week: when segment math and the bill disagree.
The First Heavy Invoice Week Shock
Your white-label tenant just wrapped its first high-volume SMS week. The client dashboard showed 50,000 sent messages, but the prepaid balance dropped faster than simple arithmetic predicted. Operators panic, assuming upstream billing errors or hidden network surcharges. In reality, billing discrepancies almost always stem from encoding shifts or concatenated payload boundaries rather than fraudulent rate card inflation.
UCS2 Encoding and Segment Inflation
Standard GSM 7-bit encoding fits 160 characters into one segment. The moment a user pastes a smart quote, an emoji, or a Cyrillic character, the entire payload drops to UCS2 encoding. A single UCS2 segment holds only 70 characters. When a message exceeds 70 characters, concatenation headers consume payload space, dropping multi-part limits to 67 characters per frame. Refer to SMS segment accounting to audit individual payload lengths before they hit the gateway.
DLR Timestamps and Ledger Latency
Prepaid platforms debit funds instantly upon carrier handoff, but final delivery receipts (DLR) via webhook can lag by several minutes during peak traffic windows. If your client export pulls data before all asynchronous status callbacks settle, the transaction ledger will temporarily mismatch local message counts. Always pull your Wallet month-end export at 02:00 after a mandatory two-hour grace period to ensure every pending DLR has reconciled against the ledger.
Thresholds for Volume Reviews
Every prepaid workspace operates under strict structural boundaries. Accounts dipping below the USD 20 prepaid floor trigger immediate traffic throttling to prevent unsecured overdrafts. Conversely, once an active tenant crosses the soft review near USD 1,000/month mark, automated risk flags check for unusual traffic spikes or unverified 10DLC registration data. Skipping this step leads to sudden carrier filtering.
Reconciling Segments Versus Ledger Rows
To prove accuracy to your enterprise clients, compare raw database logs against immutable transaction records using a structured ledger breakdown.
| Source Metric | Count Type | Typical Discrepancy |
|---|---|---|
| App DB Logs | Outbound API Calls | Missing concat headers |
| Carrier DLR | Terminal Receipts | Network time lag |
| Wallet Ledger | Prepaid Debits | UCS2 bit-depth shifts |
Review SMS volume review: when the prepaid pilot is no longer enough to establish repeatable audit habits for high-tier accounts.
Start with IOSOR
Open the IOSOR console to inspect outgoing message payloads against the character encoding audit log before issuing weekly client billing statements. Filter your outbound traffic by UCS2 flags to identify hidden smart quotes or unicode characters that split single-segment drafts into multi-part charges. Verify that asynchronous delivery receipt webhooks have fully settled prior to exporting your ledger reconciliation files.
IOSOR takeaway
Discrepancies between application call logs and billing statements stem from message encoding shifts and multi-part segment headers rather than platform billing errors. A single non-GSM character forces UCS2 encoding, immediately shrinking segment capacity from 160 to 70 characters and inflating total billable units.
Do sanitize outbound payloads to strip inadvertent unicode characters before handoff, and wait for asynchronous delivery receipts to settle before running ledger exports. Don't rely on raw API call counts to calculate customer charges, as multi-part concatenation overhead directly alters the underlying segment math.
Was this guide helpful?
Related guides
- Campaign ETA vs wall-clock: quiet hours eat the forecast
Learn how wall-clock time, quiet hours rules, and throughput pacing alter your SMS campaign ETA. Keep your white-label platform precise.
- Retry failed SMS campaign items without double-delivering
Safe requeue of failed items in white-label prepaid SMS campaigns without rebilling delivered messages.
- Balance Guard Pauses SMS Campaigns: Low Wallet Is Not Provider Down
Discover why unexpected SMS campaign halts on our white-label CPaaS platform stem from prepaid balance floors rather than carrier outages.