Billing

Billing has three product layers:

1. Payments — card checkout through Stripe
2. Ledger — append-only credit grants and usage debits
3. Balances — paid, promotional, and combined available credit

Payments

Successful payment creates a durable payment record. Credits are granted only after webhook processing — never on the browser redirect alone.

All organization roles can view balances and billing history. Only the organization owner can start Checkout or open the Stripe customer portal.

Ledger

Every credit grant and usage debit is an append-only fact. Balance projections power the console; request paths do not scan the full ledger.

Promotional credits

When a welcome-credit offer is active, an eligible verified account receives one grant. The amount and validity are fixed when the grant is issued. Active Partner allowance credit is consumed before other promotional credit, and promotional credit is consumed before paid credit. Among grants with the same priority, usage consumes the earliest expiry first. Any unused amount expires at the end of its configured UTC billing-day window.