Billing and usage

SignalDock bills per organization, in euro, excluding VAT. Plans and limits live in @signaldock/domain/billing; the marketing pricing page and the app read the same definitions.

PlansCopy Anchor Link

Starter and Growth are self-serve. Scale is sold directly and invoiced in EUR.

MeteringCopy Anchor Link

The pipeline records one row in usage_events per metered unit:

• signal_processed, research_brief, and message_sent count towards the plan limits above;
• message_drafted, enrichment_lookup, and ai_tokens are recorded for cost insight only.

Usage resets on the first of each month (UTC). Settings → Billing shows the current plan, a meter per limit, and the AI tokens used this month.

At a limitCopy Anchor Link

Limits are soft. Nothing is deleted and nothing fails loudly:

• over the signal limit, signals are still ingested but not scored;
• over the research limit, research briefs pause;
• over the message limit, sequences hold their next send until the next period or an upgrade.

When an invoice is past due or a subscription is canceled, the organization falls back to Starter limits instead of stopping.

StripeCopy Anchor Link

Checkout and the customer portal are Stripe-hosted; SignalDock never sees card details. The plan changes only when Stripe confirms it through the webhook, so returning from checkout shows a short "payment received" notice until the event arrives.

The API receives Stripe events at POST /api/webhooks/stripe and verifies the Stripe-Signature header. It handles checkout.session.completed and customer.subscription.created, .updated, and .deleted; other events are acknowledged and ignored.

ConfigurationCopy Anchor Link

Set these on the API service (they are listed in turbo's globalPassThroughEnv):

Price ids are not env: they live in the platform_settings row stripe.prices, for example {"growth": "price_...", "scale": "price_..."}. Set them with the secret key (SQL editor or admin client).

Without STRIPE_SECRET_KEY, billing stays read-only: every organization is on its stored plan and the upgrade buttons return an error.

APICopy Anchor Link

Only organization owners and admins can start checkout or open the portal.