Usage-based billing

Metered billing logic for API calls, seats, tokens, storage, and custom events.

Record usage events, aggregate quantities by billing period, apply tiered or volume rating rules, and turn usage into invoice-ready line items.

<120ms

event acknowledgement target

usage-event.ts

await floatless.usage.record({
  customerId: "cus_329",
  meter: "api_calls",
  quantity: 540,
  idempotencyKey: "evt_20260617_01"
});

Built as infrastructure, not a workflow patch.

Each product area exposes clear API state, reviewable operational controls, and finance-ready records.

Usage event ingestion API

Tiered, volume, graduated, and hybrid rating

Period aggregation and late-event handling

Usage audit trails for customer disputes

Product emits customer activity with idempotency and meter metadata.

Floatless applies tiers, commits, credits, and billing-period rules.

Usage, subscriptions, tax, and adjustments become auditable invoice lines.

Finance reviews exceptions, payment state, exports, and audit trails.

Send product activity as usage events with meter, quantity, customer, timestamp, and idempotency keys.

Apply pricing rules, customer contracts, minimums, and billing-period logic before invoice generation.

Give finance and customers traceable usage summaries tied back to event-level source records.