Setup Payment with Stripe

Local Setup

Stripe CLI

Installation of Stripe CLI is only necessary for local development environments. Manual event triggering or webhook forwarding to localhost is optional.

1. Install Stripe CLI:

Using Homebrew:

brew install stripe/stripe-cli/stripe

2. Log in to Stripe CLI:

stripe login

Follow the authentication prompts to connect your Stripe account.

Start Supabase Edge Functions

1. Serve Edge Functions:

npm run supabase:webhook-serve

2. Forward Stripe events to local webhook:

npm run stripe:listen

3. Trigger Stripe events: Local event triggering example:

stripe trigger <EVENT>

Alternatively, trigger events directly from the Stripe dashboard.

Deployment

For production deployment, update environment variables following these steps:

1. Update Environment Variables:

   • Navigate to the Supabase dashboard
   • Select your project
   • Click Edge Functions in the sidebar
   • Select Manage secrets
   • Add or update edge function environment variables
   • Required environment variables:
     • BASE_SUPABASE_URL: Supabase URL
     • SERVICE_ROLE_KEY: Supabase service role key
     • STRIPE_WEBHOOK_SIGNING_SECRET: Stripe webhook signing secret
     • STRIPE_SECRET_KEY: Stripe secret key
     • STRIPE_PUBLISHABLE_KEY: Stripe publishable key

2. Deploy Edge Function:

npm run supabase:webhook-deploy

Payment Initialization

Two Supabase edge functions manage payment initialization:

1. payment-data-native: Handles native application payments by verifying or creating customers, generating ephemeral keys from Stripe, creating payment intents, and returning values to trigger the native Stripe SDK.

2. payment-data-web: Manages web application payments by verifying or creating customers, using the Stripe backend SDK with pricing and product details to generate payment URLs, then redirecting clients to complete transactions.

Products, Plans and Pricing Management

All the products, prices and their plans are managed on the Stripe dashboard. Consult Stripe's official documentation for additional guidance on product and pricing configuration.