Domain glossary

Use these terms consistently in application code and integration discussions.

Purchase definition : The benefits promised to a beneficiary, independent of their price.

Offer : A purchase definition under exact commercial terms. An offer has a key and immutable revision.

Customer : The merchant-identified payer attached to checkout and payment history.

Beneficiary : The subject receiving benefits. It may be the paying customer or a separate merchant subject such as a workspace.

Entitlement : A named permission contributed by settled or policy-governed history, such as workspace.use.

Access contribution : One historical source of an entitlement. Current access is derived from all active contributions rather than a mutable boolean.

Offer revision / purchase revision : Immutable identities for accepted terms. Changing price, benefits, or policy creates a new revision; old purchases keep their original revision.

Checkout : A provider-neutral request that retains accepted purchase and provider-request snapshots before or alongside external creation.

Payment notification : A raw provider message authenticated by the selected adapter and translated into a settlement, refund, failure, expiry, or ignored observation.

Usage credit : A consumable quantity in a named service unit. It is not currency credit.

Credit lot : Quantity issued by one payment-backed benefit. Provenance and original quantity never change.

Credit reservation : A temporary hold on exact units. Consumption and release are mutually exclusive terminal outcomes.

Meter : A versioned identity for one kind of usage.

Metered rate : An exact rational price for aggregate usage. SAPA aggregates first and then truncates once per meter and invoice period.

Late usage adjustment : A signed line on a later invoice for usage or correction accepted after its source invoice closed. The original invoice remains immutable.

Billing watermark : The exact ordered usage heads included in a finalized invoice. It prevents omission and double billing.

Seat capacity : Purchased capacity for a beneficiary and named pool. A seat assignment turns capacity into one member’s continuous occupancy.

Download asset revision : One immutable downloadable object identified by key and revision.

License credential : A rotatable key representing eligibility for one entitlement. Activations are separate append-only lifecycle records.

Fulfillment obligation : Durable work owed to an external system after eligible settlement.

Idempotency key : A caller-selected identity for one material command. Exact retries replay; changed command material under the same key conflicts.