Managing Your Subscription

Subscription management lives at Settings → Billing. Every action below is gated on the owner role — admins can view billing details but cannot make charges.

View current plan

The Billing page shows:

• Current plan tier (Free, Team, Business, Enterprise).
• Billing cycle (monthly / annual) and next renewal date.
• Active seat count vs. your plan's seat ceiling.
• Month-to-date usage for scans, registries, and members against plan limits.
• Invoices for the past 12 months with download links.

Upgrade or change plan

1. Click Change Plan.
2. Choose a tier and billing cycle.
3. Stripe Checkout opens in a new tab; complete payment.
4. The change takes effect immediately. Mid-cycle upgrades are prorated against the remaining time on the current cycle; downgrades take effect at renewal.

Behind the scenes the dashboard calls POST /api/billing/change-plan, which creates a Checkout Session with the new price ID and redirects you. Upon successful payment, Stripe sends a checkout.session.completed event to the HarborGuard webhook, which then updates your org's plan record.

Add or remove seats

For tiers billed per seat:

1. Click Adjust Seats.
2. Enter the new total.
3. Confirm. Stripe issues a prorated invoice immediately for added seats; removed seats reduce the next invoice.

The dashboard calls POST /api/billing/add-seats with the subscription and item IDs, then refreshes when the webhook reports the updated quantity.

Update payment method

1. Click Update payment method.
2. Stripe opens a SetupIntent flow in a new tab.
3. Enter the new card / bank details.
4. Future invoices charge the new method automatically.

View and download invoices

Invoices appear in the Billing history table. Click any row to open the Stripe-hosted invoice page or the PDF. Invoices are also recorded in the HarborGuard database and survive Stripe metadata changes.

Cancel

1. Click Cancel subscription.
2. Confirm in the modal.
3. Your account remains on the current plan until the end of the paid period; on cycle end, the org is downgraded to the Free tier.

To delete the organization entirely, contact support — billing cancellation by itself preserves your scan history and data.

Failed payments

If a charge fails:

• Stripe retries the payment per the configured Smart Retries schedule.
• HarborGuard records the failed invoice and surfaces a banner to owners and admins.
• After Stripe gives up, the subscription transitions to unpaid and the org is downgraded to Free at the end of the cycle.

Update your payment method to clear the dunning state.