Platform Billing Operator and Finance

Stripe and Billing Operations

Operate Stripe-backed subscriptions and payments with safe go-live and incident practices.

Prerequisites

- Stripe products/prices created

- Webhook endpoint and secret configured

- Billing feature flag ready for production

Step-by-step workflow

1) Go-live readiness

- Verify price IDs exist for all organizer and studio SKUs.

- Set environment variables and webhook secrets in production runtime.

- Confirm customer portal behavior for upgrade/downgrade/cancel flows.

2) Runtime operations

- Monitor subscription lifecycle webhooks and payment success/failure events.

- Reconcile plan access with app-level tier guards.

3) Incident response

- For payment failures, validate webhook delivery first, then customer status.

- For unexpected access, inspect subscription records and per-event entitlements.

Validation checklist

- Webhook endpoint receives and verifies required event types.

- Billing UI reflects active subscription/per-event purchase state.

- Test-mode purchase flow passes end-to-end before production launch.

Common failure modes and fixes

Subscription paid but access not updated

- Inspect webhook processing logs and related Firestore subscription documents.

Portal cannot load for a customer

- Ensure customer object exists and portal configuration is enabled in Stripe.