Skip to main content

Dashboard Overview

The FinMatch Admin Dashboard provides a high-level overview of your platform with key metrics and quick access to all major sections.

Dashboard Sections​

📊 Overview Cards​

The dashboard displays four main cards:

  1. Merchants - Total number of merchants in your system
  2. Stripe - Billing and customer management
  3. Lenders - Active lender configurations
  4. Analytics - Latest data insights

How Merchant Count Works​

The dashboard loads the merchant count directly from the source of truth (merchants.json) for optimal performance.

Data Flow​

Dashboard → GCS (merchants.json) → Count Profiles → Display

Source of Truth: gs://finmatch-shared/merchants.json

Structure:

{
  "profiles": {
    "M000101": { ... },
    "FM-0294-8617-5039": { ... }
  }
}

Implementation​

The dashboard:

  1. Reads directly from GCS - https://storage.googleapis.com/finmatch-shared/merchants.json
  2. Counts profiles - Object.keys(profiles).length (excluding versionStamp)
  3. Displays count - Shows total number of merchants

Fallback: If GCS access fails (e.g., CORS not configured), the dashboard automatically falls back to the Merchant API.

Why Direct GCS Access?​

  • ✅ Faster - No API hop, direct access to source of truth
  • ✅ Simpler - One less network request
  • ✅ Less Load - Reduces API invocations
  • ✅ Consistent - Matches the pattern used throughout the admin dashboard

Quick Actions​

The dashboard provides quick action buttons to navigate to:

  • Manage Merchants - View and manage all merchant accounts
  • Stripe Billing - Manage Stripe customers and billing
  • View Lenders - Configure lender settings
  • Analytics Dashboard - View platform metrics

Next Steps​