WARP guide

Understanding Your WARP Billing

How to read account balance, ledger, invoices, plans, suspension status, and payment-related billing surfaces.

Billing shows how your account balance changes, what charges were recorded, and which invoices summarize each billing period. Use Billing together with Call Statistics when you need to understand what drove usage charges.

Account Balance

Your balance is the current financial position of your account. Payments and credits increase it. Usage, recurring charges, and other debits decrease it.

You can see the current balance on the Billing page. If your account is prepaid or has credit terms, balance and credit limit together determine whether service can continue without interruption.

Ledger

The ledger is the itemized record behind the balance. Each entry records a transaction such as a payment, credit, recurring charge, or usage charge.

Use the ledger when your balance is not what you expected. The balance tells you the current total; the ledger explains how the account got there.

The billing history page shows ledger history. When reconciling, compare ledger entries against invoices and usage for the same date range.

Invoices

Invoices summarize a billing period. You can view invoice details in the portal, view the rendered HTML invoice, and download a PDF for records or finance workflows.

If an invoice looks wrong:

  1. Note the invoice ID and billing period.
  2. Review the invoice sections and line items.
  3. Check the ledger for matching transactions.
  4. Check Call Statistics for the usage behind voice charges.
  5. Contact support with the invoice ID, date range, and the specific line item in question.

Plans and Packages

Plans or packages define pricing and commercial terms for your account. The plan is the pricing layer; invoices and ledger entries show the actual resulting charges.

If you want to change rates, packages, or credit terms, contact support. Customer billing pages explain what is currently charged; they do not replace commercial review.

Suspension

WARP can suspend service when the account runs out of available funds. The key calculation is balance plus credit limit. When available funds reach zero, new service can be gated so charges do not continue past the account's terms.

To avoid suspension:

  • Watch the Billing page regularly.
  • Understand your credit limit.
  • Add funds before expected high-volume periods.
  • Contact support before a planned traffic spike if your normal terms will not cover it.

If the account is already suspended, add funds if self-service payment is available or contact support to resolve payment or credit terms.

Payments Page

The Payments page is where customer payment-related workflows appear when enabled for your account. If a payment workflow is not available, use Billing to gather the current balance and ledger context, then contact support.

Do not rely on a payment until it appears in the ledger or balance. If you believe a payment is missing, provide payment reference, amount, timestamp, and customer account.

Usage and Billing

Call Statistics helps explain the usage side of billing. Billing shows charges and invoices; Call Statistics shows the underlying voice activity.

For usage disputes, compare:

  • Call Statistics for the date range.
  • Ledger entries for the date range.
  • Invoice line items for the billing period.

Buzz can help walk through this comparison if your role has billing:read and cdrs:read.

Scopes and API Reference

Billing reads use billing:read:

  • GET /v1/billing/balance
  • GET /v1/billing/ledger
  • GET /v1/invoices
  • GET /v1/invoices/:id
  • GET /v1/invoices/:id/html
  • GET /v1/invoices/:id/pdf

Billing write scope exists for payment or billing-management workflows when enabled:

  • billing:write

Usage reconciliation uses cdrs:read:

  • GET /v1/cdr/statistics
  • GET /v1/cdr/details
  • GET /v1/cdr/trends
  • GET /v1/cdr/export