Founderflow Logo

Payment Integration

Dual provider support for payments with both Stripe and Lemon Squeezy integration. Choose your preferred payment method or use both.

Dual Provider Support

The boilerplate supports both Stripe and Lemon Squeezy, allowing users to choose their preferred payment method or giving you flexibility in your payment strategy.

S

Stripe Integration

  • Checkout Sessions for secure payment processing
  • Subscriptions with recurring billing
  • Webhooks for payment status updates
  • Customer Portal for self-service billing
L

Lemon Squeezy Integration

  • Checkout Links for simple payment links
  • Subscriptions with recurring billing
  • Webhooks for payment notifications
  • Built-in customer portal

Payment Flow

1

User Selects Plan

User chooses a subscription plan from the pricing page

2

Checkout Session Created

Payment provider creates a secure checkout session

3

Payment Processed

User completes payment through the provider's secure checkout

4

Webhook Updates Subscription

Webhook updates user's subscription status in the database

5

Access Granted

User receives credits or premium access based on their plan

Environment Variables

Configure these environment variables for payment providers:

Stripe Configuration

.env - Stripe
# Stripe
STRIPE_SECRET_KEY=sk_test_...
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

Lemon Squeezy Configuration

.env - Lemon Squeezy
# Lemon Squeezy
LEMON_SQUEEZY_API_KEY=sk_test_...
LEMON_SQUEEZY_STORE_ID=your_store_id
LEMON_SQUEEZY_WEBHOOK_SECRET=your_webhook_secret

Key Files

lib/stripe.ts

Stripe configuration and utility functions

/lib/stripe.ts

lib/lemonsqueezy.ts

Lemon Squeezy configuration and utility functions

/lib/lemonsqueezy.ts

app/api/payments/

Payment processing API routes

/app/api/payments/

app/api/webhook/

Webhook handlers for payment notifications

/app/api/webhook/

Setup Guide

Stripe Setup

  1. Visit stripe.com and create an account
  2. Get your API keys from the dashboard (test keys for development)
  3. Create products and prices for your subscription plans
  4. Set up webhook endpoints for payment events
  5. Add the webhook signing secret to your environment variables

Lemon Squeezy Setup

  1. Visit lemonsqueezy.com and create an account
  2. Create a store and get your API key
  3. Create products and variants for your subscription plans
  4. Set up webhook endpoints for order events
  5. Add the webhook secret to your environment variables

Next Steps

After setting up payments, explore these related areas:

Stripe Deep Dive

Detailed Stripe integration guide with examples.

Lemon Squeezy Deep Dive

Detailed Lemon Squeezy integration guide with examples.