Billing

Get usage summary for the current organization.

Returns call count, minutes used, billed amount, provider costs, and margin.

Get per-day usage breakdown for the current organization.

Returns a list of {date, minutes, billed_amount} for charting.

Get billing settings for the current organization.

Includes billing type, rate, and Stripe connection status.

Render data for the phone-numbers tier-cap panel.

For each region tier the org's SKU has a cap for: returns cap (included free), used (currently active numbers), and above_cap_rate_usd (per-month charge for any number beyond the cap, looked up via RateCardService — falls back to None when no rate card row exists, e.g. R8/special markets).

Auth: org-context only — customers see their own caps. The 4 possible-but-uninteresting rows (R8 = special quote, GLOBAL = uncapped WebRTC) are omitted to keep the panel tight.

Get USD → billing currency exchange rate for the current organization.

Create a Stripe customer for the organization.

This enables prepaid credits billing - customers top up their balance and credits are deducted per call.

Disconnect Stripe from the organization.

Note: In prepaid model, this clears the Stripe customer association. Any remaining credits will be forfeited.

Create a SetupIntent for adding a payment method. Auto-creates a Stripe customer if one doesn't exist. Returns client_secret for Stripe.js to complete the setup.

Get all payment methods for the organization.

Set a payment method as the default.

Remove a payment method.

Get current account credit balance from local ledger (source of truth).

Check if organization has sufficient balance to make a call.

Returns whether calls can be made and current balance. Used by frontend before initiating calls.

Create a payment intent for topping up account credits.

Returns a client_secret for completing payment with Stripe.js on frontend.

Confirm a top-up payment and add credits to account.

Call this after payment succeeds on the frontend.

Get balance transaction history.

Get current auto-reload settings for the organization.

Update auto-reload settings for the organization.

Create a Stripe Billing Portal session for self-service payment method management.

The billing portal allows customers to:

• View and update payment methods
• View billing history
• Update billing information

Get invoice history (credit transactions) for the organization.

For prepaid billing, invoices are customer balance transactions:

• top_up: Manual credit purchase
• auto_reload: Automatic reload when balance dropped below threshold
• credit_grant: Admin-granted credits (promotional, etc.)
• correction: Admin corrections, refunds, adjustments

Add or remove real credits for an organization (Stripe customer balance).

Get platform-wide revenue summary (admin only).

Returns total revenue, costs, margin, and margin percentage across all organizations.

Get usage summary for all organizations (admin only).

Returns per-org usage data for efficient table display.

Get usage summary for a specific organization (admin only).

Read DLT compliance flag + custom rate overrides + concurrency.

Set DLT compliance flag and/or replace custom rate overrides.

Note: custom_rate_overrides is REPLACED in full when provided — pass the merged dict, not a partial. This avoids partial-update ambiguity around removing a single key.

Convert a Pilot org per spec B6 (day 25-30 conversion call).

Steps:

1. Verify org is sku='pilot' AND pilot_status='active'|'live'
2. Set org.sku = target_sku, pilot_status = 'converted'
3. Create the new setup_fee invoice via SetupFeeService
4. Apply $2K Pilot conversion credit against the new invoice

Manually flip pilot_go_live_at + status='live'.

Idempotent — calling on a non-active pilot is a no-op (returns 409 so the UI can surface why nothing changed).

Manually refund the $2K Pilot setup fee + flip status='refunded'.

Reuses the same RefundService path the day-31 auto-cancel cron uses. No-op if pilot is already in a terminal state ('refunded'|'cancelled') — returns 409 so the UI can surface that.

Mark pilot as cancelled WITHOUT issuing a refund.

Use when ops decide the customer doesn't qualify for the $2K refund (e.g. abuse / TOS violation / explicit no-refund waiver). Distinct from the refund endpoint which always refunds.

Audit fix L6: pagination via skip/limit. Without skip, the AdminDnc UI silently truncated once platform_seed grew past 500 entries (regulator do-not-call lists ingested at scale). Returns one page at a time, ordered by added_at desc.