# Wheelie private-preview billing

Agent docs index: /llms.txt

Wheelie private preview uses **manual invoice or contract billing only** (`billing_mode=manual_invoice_or_contract`). There is no self-serve checkout, card charge, billing portal, automatic overage, or money movement in the current Wheelie launch path. Use [Spend support states](./spend-support-states.md) for public-safe spend copy.

## What is supported now

- Request access through the private-preview CTA or support email.
- Use BYOK / customer-direct model credentials by default when supported.
- Use approved Wheelie-managed credits only when they are explicitly capped for the beta.
- Track hosted workspace usage separately from model usage.
- Handle any paid beta settlement, overage approval, cancellation, credit, refund, or dispute through support and the manual invoice/contract owner.
- Keep spend surfaces in notional/test, customer-direct/BYOK, included/prepaid-credit, private-pilot, disabled/fail-closed, or unsupported states unless an exact support receipt says otherwise.

## What is not a launch claim

Do not treat any Wheelie public asset or demo as evidence for:

- self-serve Stripe checkout or billing portal;
- self-serve payment-provider checkout, card-on-file charging, or provider payments;
- payment webhooks mutating Wheelie launch entitlements;
- automatic overage or unlimited managed model/workspace usage;
- self-serve refund or cancellation automation.

If a Wheelie command or page exposes a quote/prototype, check the machine-readable `support_state`, `money_movement_enabled`, `fee_policy_ref`, `refund_dispute_owner_ref`, `reconciliation_owner_ref`, and `support_owner_ref` fields. Fixture-only quote discovery must keep `money_movement_enabled=false` and must not ask for payment credentials.

## Support workflow

Use [Support and friendly error states](./support.md) for the user-facing help path.

1. Support verifies the beta user or organization and selected allowance.
2. Model spend defaults to the customer’s provider key/subscription where available.
3. Any Wheelie-managed credit or hosted workspace allowance is explicitly capped.
4. Spendful work fails closed when entitlement or metering cannot be confirmed.
5. Overage, plan changes, cancellation, credits, and refunds route through support/manual billing unless a scoped support receipt says otherwise.
6. Budget-cap, runaway-cost, or metering-disagreement receipts are stop conditions: pause new spendful work and escalate with redacted cost/resource refs.

The operator-facing launch decision packet stays private in the source repository. Public billing copy should keep the manual-billing boundary above unless a scoped support receipt is explicitly approved and published.