A complete, production-ready Stripe API integration for Firebase projects that eliminates CORS issues and provides full type safety.

• ✅ 100% Stripe API Coverage - All 87 Stripe API endpoints implemented
• ✅ CORS-Free - Firebase Cloud Function proxy eliminates all CORS issues
• ✅ Fully Type-Safe - 1100+ TypeScript definitions with zero any types
• ✅ Environment Switching - Runtime switching between test/live without redeployment
• ✅ AI-Friendly - Consistent structure prevents AI coding errors
• ✅ Production-Ready - Used in production with comprehensive error handling

• services/stripe/ - 87 folders with 290+ service files covering all Stripe operations
• types/stripe/ - 77 modular type files with complete Stripe API type definitions
• components/stripe/ - Reusable Stripe UI components
• config/environment.ts - Environment configuration for test/live switching
• utils/firebase/config.ts - Firebase initialization and configuration
• services/errorHandler.ts - Centralized error handling for Stripe operations

• stripe-proxy.ts - Complete Stripe API proxy with all endpoints
• cors-helper.ts - CORS configuration and handling utilities
• environment.ts - Runtime environment switching (test/live)
• services/errorHandler.ts - Error handling for Cloud Functions

# Copy frontend files cp -r src/services/stripe YOUR_PROJECT/src/services/ cp -r src/types/stripe YOUR_PROJECT/src/types/ cp -r src/components/stripe YOUR_PROJECT/src/components/ cp src/config/environment.ts YOUR_PROJECT/src/config/ cp src/utils/firebase/config.ts YOUR_PROJECT/src/utils/firebase/ cp src/services/errorHandler.ts YOUR_PROJECT/src/services/ # Copy backend files cp functions/src/stripe-proxy.ts YOUR_PROJECT/functions/src/ cp functions/src/cors-helper.ts YOUR_PROJECT/functions/src/ cp functions/src/environment.ts YOUR_PROJECT/functions/src/ cp functions/src/services/errorHandler.ts YOUR_PROJECT/functions/src/services/

# Set up Stripe test credentials firebase functions:secrets:set STRIPE_TEST_SECRET_KEY firebase functions:secrets:set STRIPE_TEST_PUBLISHABLE_KEY firebase functions:secrets:set STRIPE_TEST_ACCOUNT_ID # Set up Stripe live credentials firebase functions:secrets:set STRIPE_LIVE_SECRET_KEY firebase functions:secrets:set STRIPE_LIVE_PUBLISHABLE_KEY firebase functions:secrets:set STRIPE_LIVE_ACCOUNT_ID

Create /config/stripe document in Firestore:

{ "environment": "test", "testPublishableKey": "pk_test_...", "livePublishableKey": "pk_live_..." }

firebase deploy --only functions:stripeProxy

import { customersCreateService } from 'src/services/stripe'; // Create a customer const result = await customersCreateService.create({ email: 'customer@example.com', name: 'John Doe', phone: '+1234567890' }); if (result.success) { console.log('Customer created:', result.customer?.id); }

• Customers, PaymentIntents, PaymentMethods, Charges, Refunds
• Checkout Sessions, Payment Links
• Subscriptions, Invoices, Invoice Items

• Accounts, Account Links, Account Sessions
• Transfers, Payouts, Application Fees
• External Accounts, Persons, Capabilities

• Terminal, Identity, Issuing, Treasury
• Climate, Crypto, Entitlements, Financial Connections
• Tax, Radar, Sigma, Reporting, Reviews
• OAuth, Webhooks, Test Helpers

• Events, Event Destinations
• Core Accounts, Account Links
• Billing Meters, Meter Events, Licensed Items

The stripeProxy Cloud Function acts as a proxy between your frontend and Stripe API:

Frontend → Firebase Function → Stripe API (CORS-free) (authenticated) 

Switch between test and live environments without redeployment:

1. Update Firestore /config/stripe document: { environment: "live" }
2. Changes take effect immediately
3. No function redeployment needed

All services use centralized types from src/types/stripe/:

// Type-safe parameters const params: CustomerCreateParams = { email: 'test@example.com', // ✅ Type-checked name: 'John Doe', // ✅ Type-checked invalidField: 'value' // ❌ TypeScript error };

• All types match Stripe API documentation exactly (snake_case)
• JSDoc comments include Stripe API reference links
• Consistent error handling across all services
• Predictable file structure (alphabetically organized)

All services use ErrorHandler for consistent error management:

import { ErrorHandler, ErrorContext } from 'src/services/errorHandler'; try { const result = await stripe.customers.create(params); } catch (error) { const context: ErrorContext = { operation: 'createCustomer', customerEmail: params.email }; const errorResult = ErrorHandler.handleStripeError(error, context); return { success: false, error: errorResult.userMessage }; }

• Firebase Project with Functions enabled
• Node.js 20+
• TypeScript 5.0+
• Firebase Admin SDK
• Stripe Node SDK

This is a production-tested implementation. Feel free to use in your own projects!

MIT License - Use freely in your projects

Created by Eric Wiedemann to solve Stripe CORS issues in Firebase projects.

Twizbee - Building better developer tools and solutions.

Need help? Check the Stripe API documentation: https://docs.stripe.com/api