# Billing Specs

> Canonical path: `specs/billing/README.md`

This README lists canonical specs for the `billing` domain in recommended
reading order. Billing specs define AgentTeam's browser-facing billing surface,
organization subscription purchase surfaces, and the backend contracts needed to
settle hosted-product payments into MaaS-owned credit ledgers.

Canonical specs:

- [Hosted Credits Payment Flow](./hosted-credits-payment.md) defines the
  organization-admin payment flow for hosted model credit recharge, the AgentTeam
  browser API facade, the `agentteam-maas` internal billing API, and the ledger
  ownership rules.
- [Hosted Model Onboarding](./hosted-model-onboarding.md) defines the
  organization-admin flow for explicit hosted entitlement facts, hosted credit
  balance gating, hosted access policy, workspace authorization, and selectable
  model composition.
- [Organization Seat Purchases](./organization-seat-purchases.md) defines the
  AgentTeam-owned human-seat purchase plans, seat orders, payment records, quota
  calculation, and boundary with MaaS-owned hosted credit billing.