admin Tested: December 28, 2025

Stripe Dashboard

Manage subscription billing, enrollment statuses, pricing tiers, and payment configuration with integrated Stripe webhooks.

adminstripebillingsubscriptionspaymentswebhooks
Stripe Dashboard

Overview

The Stripe Dashboard provides centralized management of all subscription billing operations. Brokers pay monthly fees for county coverage, and this dashboard tracks enrollment statuses, manages pricing tiers, and handles payment events.

Key Features

Enrollment Statistics

Real-time metrics displayed in stat cards:

  • Total Enrollments: All broker county enrollments
  • Active: Currently active subscriptions
  • Past Due: Enrollments with failed payments (30-day grace period)
  • Canceled: Voluntarily canceled subscriptions

Active by Tier Breakdown

Visual distribution of enrollments across pricing tiers:

  • basic - Standard county coverage
  • premium - Enhanced visibility and features
  • enterprise - Multi-county enterprise plans

Tab Navigation

Enrollments Tab

Lists all broker county enrollments with:

  • Broker: Company name
  • County: Enrolled county and state
  • Tier: Subscription tier with badge
  • Status: Active, Past Due, Canceled, or Lapsed
  • Enrolled: Subscription start date
  • Renews: Next billing date

Prices Tab

Manage Stripe price configurations:

  • View existing price IDs
  • Configure tier pricing
  • Sync prices with Stripe

Configuration Tab

Stripe integration settings:

  • Webhook endpoint configuration
  • API key status
  • Test mode toggle

Test Mode Indicator

Clear “TEST MODE” banner when using Stripe test keys, preventing confusion between test and live transactions.

Payment Status Flow

Active → (payment fails) → Past Due → (30 days) → Lapsed

              (payment succeeds) → Active

Grace Period Policy

  • Day 0: Payment fails, status becomes PAST_DUE
  • Days 1-30: Broker remains visible to customers
  • Day 31: Enrollment lapses if payment not resolved

Webhook Events

The system processes Stripe webhooks for:

  • invoice.payment_succeeded - Activates/renews enrollment
  • invoice.payment_failed - Marks enrollment past due
  • customer.subscription.deleted - Cancels enrollment

Testing Results

  • ✅ Stats display accurate enrollment counts
  • ✅ Tier breakdown shows correct distribution
  • ✅ Enrollment table filters and sorts correctly
  • ✅ Test mode banner displays appropriately
  • ✅ Tab navigation switches views properly
  • ✅ Status badges reflect current state