Billing

Billing is where workspace admins review the active plan, watch usage against plan limits, add capacity, and manage the Stripe subscription for the workspace.

What Billing Controls

Area	What it manages
Current plan	Starter, Growth, Scale, or Bring Your Own AI.
Subscription status	Stripe subscription state such as active, past due, unpaid, incomplete, or canceled.
Usage meters	AI resolutions, operator seats, agents, API sources, indexed endpoints, public API calls, and live API checks.
Add-ons	Extra operator seats, extra agent/widget capacity, and multi-workflow add-ons.
Payment details	Payment method, invoices, cancellation, and supported subscription edits through Stripe Billing Portal.

Billing changes are workspace-scoped. The subscription belongs to the Woes workspace, not to an individual operator.

Current Plan Card

The top of Settings → Billing shows the workspace’s current plan and a projected monthly total. The current plan card uses the workspace’s selected plan plus active add-ons and usage overages. When Stripe is connected, the card also shows the Stripe subscription status. Common statuses:

Status	Meaning
`active`	The subscription is active and billing normally.
`past_due`	Stripe has a payment issue, but the subscription has not been canceled.
`unpaid`	Stripe has exhausted retry behavior or marked the invoice unpaid.
`incomplete`	Checkout or first payment has not completed successfully yet.
`canceled`	The subscription is canceled. Features may be reduced after sync.

Woes plans do not use trial periods. New subscriptions are paid plans confirmed through Stripe Checkout.

Manage Subscription

Use Manage subscription to open the Stripe Billing Portal for the workspace. The portal can be used to:

Update payment methods.
Review invoice history.
Update billing contact and tax information.
Cancel the subscription according to the portal policy.
Adjust supported subscription prices or quantities.

Woes creates the portal session server-side. Operators never handle Stripe secret keys, webhook secrets, or internal billing identifiers.

Changing Plans

Plan changes from Woes use Stripe Checkout.

Open Billing

Go to Settings → Billing.

Choose a plan

Select Starter, Growth, Scale, or Bring Your Own AI.

Complete Checkout

Stripe Checkout collects payment details and starts the subscription.

Return to Woes

Woes syncs the confirmed subscription and updates workspace limits after Stripe confirms the billing state.

Before Woes opens Checkout, it checks whether the target plan can support the workspace’s current usage and enabled features. For example, Woes will block a plan downgrade if the workspace has more agents, sources, endpoints, seats, or enabled channels than the target plan allows.

Add Capacity

Use Browse add-ons when you need more capacity without changing the base plan.

Add-on	What it does
Extra operator seat	Adds one more human workspace seat.
Extra AI agent + widget	Adds one more named agent and public widget key. It also enables multi-agent behavior.
Multi add-on	Unlocks multi-agent routing for lower tiers.
Extra API source bundles	Adds source capacity according to the active plan’s add-on pricing.
Extra AI resolutions	Billed as usage overage according to the active plan’s rate.

Plan-specific add-on prices are used when available. Woes falls back to generic add-on prices only when a plan-specific Stripe price is not configured.

Bring Your Own AI Plan

Bring Your Own AI is its own plan. It is shown in Billing and priced per user. When active, the Billing page labels the workspace as Bring Your Own AI and the AI agent can route model calls through the customer’s connected provider key. Bring Your Own AI includes:

Scale-grade support capacity.
Provider-key setup in Settings → Bring Your Own AI.
Unlimited Woes-side AI resolutions routed through the customer’s own provider.
Customer-paid model usage through the connected provider account.

See Bring Your Own AI.

Usage Meters

Billing shows usage for the current month.

Meter	How to read it
AI resolutions	AI-handled customer-facing answers counted against the monthly allowance.
Operator seats	Active workspace members consuming human operator capacity.
AI agents	Configured support agents and widget routing surfaces.
API sources	API context sources attached to the workspace.
Indexed endpoints	Endpoint-level records extracted from API context sources.
Public API calls	Successful authenticated REST API requests by workspace API key.
Live API checks	Authenticated source tests run by operators.

Monthly public API and live API check meters reset at the start of each UTC month.

Public API Usage By Key

Billing includes a Public API by key section. This shows current-month REST API usage grouped by API key prefix. This helps admins answer:

Which integration is driving API traffic?
Are revoked keys still visible historically?
Which server-side job should be investigated when API usage spikes?

Only key prefixes and usage counts are shown. Full woesk_ secrets and key hashes are never returned.

Stripe Sync

When Stripe is configured, Woes uses Stripe as the billing source of truth.

Stripe event	Woes behavior
Checkout completed	Reads the confirmed subscription and syncs workspace plan or add-on state.
Subscription updated	Reconciles subscription status, plan price, and supported quantity changes.
Subscription deleted	Marks subscription status and turns off canceled add-on capacity where applicable.

The Woes app stores only the Stripe customer id, subscription id, subscription status, and workspace entitlement values needed to enforce limits. It does not store card numbers or Stripe secret keys in workspace settings.

Permissions

Billing actions require workspace admin-level access. A user needs workspace write permission to change plans, buy add-ons, or open subscription management. Use Users and Permissions to limit Billing access to admins who should manage paid capacity.

Troubleshooting

Symptom	Check
Manage subscription does not open	Confirm Stripe is configured and the workspace has or can create a Stripe customer.
Plan still looks unchanged after Checkout	Wait for billing confirmation sync, then refresh Billing.
Downgrade is blocked	Current usage or enabled features exceed the target plan. Remove extras or choose a larger plan.
Add-on quantity looks wrong	Confirm the active Stripe subscription item quantity and wait for billing confirmation sync.
BYO AI settings are hidden	Switch to the Bring Your Own AI plan from Billing first.

​Billing

​What Billing Controls

​Current Plan Card

​Manage Subscription

​Changing Plans

​Add Capacity

​Bring Your Own AI Plan

​Usage Meters

​Public API Usage By Key

​Stripe Sync

​Permissions

​Troubleshooting

Billing

What Billing Controls

Current Plan Card

Manage Subscription

Changing Plans

Add Capacity

Bring Your Own AI Plan

Usage Meters

Public API Usage By Key

Stripe Sync

Permissions

Troubleshooting