Stripe

The Stripe integration pulls invoice and payment data into the Finance Panel on the dashboard.

What It Does

• Invoice tracking — displays recent invoices, payment status, and amounts
• Revenue data — feeds into the finance panel's revenue metrics
• Webhook processing — listens for invoice.paid and checkout.session.completed events

Setup

1. Create a Restricted API Key

1. Go to dashboard.stripe.com/apikeys
2. Click Create restricted key
3. Grant permissions: Invoices: Read, Customers: Read, Checkout Sessions: Read
4. Copy the key

Use test mode keys (starting with sk_test_) during development.

2. Set Up a Webhook (Optional)

1. Go to Developers > Webhooks > Add endpoint
2. URL: https://your-hq-url/api/webhooks/stripe
3. Events: invoice.paid, checkout.session.completed
4. Copy the signing secret

3. Configure Environment Variables

# In gridwork-hq/.env.local
STRIPE_SECRET_KEY=sk_test_your-key
STRIPE_WEBHOOK_SECRET=whsec_your-signing-secret

Environment Variables

Without This Integration

Without Stripe configured:

• The Finance Panel shows locally-stored revenue data only (manual entries via SQLite)
• No Stripe invoice data appears on the dashboard
• Revenue tracking still works through manual entry in the dashboard