A customer billing period summary containing usage and charge information.
Credit allocation (CustomerCreditAllocation)
A record that consumes part of a credit grant for one accepted usage event or reverses unused value.
Credit grant (CustomerCreditGrant)
An immutable positive credit lot in the customer currency, with an optional expiry date.
Customer credit
An immutable grant ledger that offsets eligible customer spend; distinct from billing charge ledger postings and mutable balance fields.
Customer key
A scoped runtime key used for preflight checks and usage logging for one customer.
Delivery attempt
A single HTTP attempt to send one webhook delivery to a subscriber endpoint.
External ID
A stable identifier from your system used to map runtime usage to Spendware records.
Guardrail
A threshold rule that can alert or act when usage or cost crosses a configured limit.
Ledger
The database-backed source of truth for usage or billing rows that support durable analytics and billing.
Management client
The Python or TypeScript SDK client used to call Spendware management APIs.
Platform billing
Spendware's own SaaS subscription billing (PAYG, Pro, Business plans). Uses
Stripe for checkout, subscription lifecycle, and payment collection. Separate
from end-customer billing — you do not need Stripe to bill your customers.
Preflight
A policy check performed before a provider call.
Presentation unit
Read-side scaling for usage totals, such as showing tokens in millions while preserving raw stored counts.
Pricing rule
A rule that maps provider/model usage to cost.
Project
A product or application boundary for usage attribution.
Runtime context
Per-call or resolver-provided customer, project, feature, and metadata used by provider adapters.
Usage event
A recorded provider request, token count, cost, or error event.
User API key
A scoped management key for automation and SDK management client calls.
Webhook endpoint
A subscriber URL and event filter configuration.
Webhook event
A durable event emitted by Spendware for delivery to matching endpoints.