# Billing & Plans

Pick a tariff per client by conversation volume, set the cycle, and track token usage

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Match each client's plan to the conversation volume they handle, pick a billing cycle for the discount, and top up tokens as usage grows.

<BillingPageDemo />

The billing page lives under the account menu (top-right): active tariff chip in the header, period selector, all plans side-by-side, and payment history at the bottom.

## Pick a plan and cycle [#pick-a-plan-and-cycle]

1. Open **Account menu → Billing**.
2. Choose the billing cycle in the header — it recalculates every card's monthly price live (strike-through + `−%` badge).
3. Click the tariff card you want.
4. Confirm the new price in the header — payment is processed instantly.

Upgrades take effect immediately; downgrades at the end of the current period. Cancel from the header — access continues until period end, no early-termination fee.

| Plan         | Price / month | Includes                                                        | Best for                     |
| ------------ | ------------- | --------------------------------------------------------------- | ---------------------------- |
| **Starter**  | $29           | 1 assistant, 2 channels, light usage                            | Pilots, proof-of-concept     |
| **Pro**      | $79           | 5 assistants, all messengers + voice, unlimited knowledge base  | Growing businesses (default) |
| **Business** | $199          | Unlimited assistants, deep analytics, dedicated account manager | Multi-department deployments |

| Cycle         | Discount | When it makes sense                          |
| ------------- | -------- | -------------------------------------------- |
| **Monthly**   | —        | You're still evaluating                      |
| **Quarterly** | −10%     | Stable usage, predictable headcount          |
| **Yearly**    | −20%     | Long-term commitment, lowest per-month price |

| Status        | Meaning                              |
| ------------- | ------------------------------------ |
| **Active**    | Subscription is live and functional  |
| **Pending**   | Payment being processed              |
| **Inactive**  | Paused (e.g., payment failed)        |
| **Cancelled** | Terminated — access until period end |

## Token usage [#token-usage]

Tokens are AI usage credits, deducted per chat session at **0.2 credits per interaction** (tracked separately from raw LLM tokens). Consumption scales with conversation length, AI model (GPT-4 / Claude Opus cost more), knowledge-base vector search, and tool-call rounds.

Track it in **Billing → Tokens**: current balance, usage over time, and a per-message breakdown (input/output tokens, model used). Running low? Upgrade the plan, switch to efficient models (GPT-4o Mini, Gemini Flash), shorten prompts, or trim the knowledge base.

## Payments [#payments]

Every charge lands in the **Payment history** table: date, status (succeeded, pending, rejected, refunded), amount, and one-click invoice download for accounting.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Next [#next]

* [Analytics & Metrics](/docs/analytics) — monitor token usage and conversation volumes
* [Assistants → AI Model Configuration](/docs/assistants#ai-model-configuration) — choose models by cost/quality
* [Companies & Workspaces](/docs/companies) — billing is per company