Billing

Billing portal

Stripe-hosted self-service portal for managing your Dock subscription. Update card, change plan, download invoices, cancel — all without filing a support ticket.

Opening the portal

Click Manage billing at /settings?tab=billing. That opens the portal in a new tab, signed in as your org. Free-plan orgs see "Add a card" instead — same flow, different label.

Programmatically:

  • POST /api/billing/portal returns a single-use URL valid for 24 hours.
  • MCP: open_billing_portal tool. Same payload, returns the URL.

What you can do in the portal

  • Update payment method: change card, replace card on file, set default.
  • Change plan: switch between Free, Pro, Scale. Pro-rated to the day.
  • Download invoices: every invoice as PDF, back to org creation.
  • Update billing email: receipts go to a different address than the org owner's.
  • Update tax info: VAT IDs, addresses, etc.
  • Cancel subscription: drops to Free at the end of the current billing period.

Who can open the portal

Org owners + admins. Plain members get a 403 (and a friendly "ask your admin" explainer).

Security model

Dock never stores your card. Stripe handles all PCI. Our backend only sees masked card brand + last 4 + expiration date — enough to display in the dashboard, not enough to charge. The portal session is a Stripe-signed redirect with a 24-hour TTL.