Stripe Setup Guide

This guide provides comprehensive instructions for setting up your Stripe Dashboard to work seamlessly with the AInstein subscription system. Following these steps will ensure that all products, prices, webhooks, and features are correctly configured.

Step 1: Create Products and Prices

First, you need to define your subscription plans and any add-ons as products in Stripe. Each product will have one or more prices associated with it (e.g., monthly and yearly).

Step 2: Configure Webhooks

Webhooks are essential for Stripe to communicate real-time events (like successful payments or cancellations) back to your application.

1. In your Stripe Dashboard, go to Developers → Webhooks.
2. Click + Add endpoint.
3. Set the Endpoint URL to https://<your-domain>/api/stripe/webhooks.
4. Click + Select events and add the following:
   • checkout.session.completed
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
   • invoice.payment_succeeded
   • invoice.payment_failed
5. After creating the endpoint, find the Signing secret and copy it.
6. Add this secret to your environment variables as STRIPE_WEBHOOK_SECRET.

Step 3: Set Up Stripe Connect (for Resellers)

If you plan to support resellers or affiliates who earn a commission, you must configure Stripe Connect.

1. Go to the Connect section in your Stripe Dashboard and complete the platform profile setup.
2. Choose the Express account type for a streamlined onboarding experience for your resellers.
3. In your Connect settings, you can configure details like application fees and branding.

Step 4: Configure the Customer Portal

The Stripe Customer Portal allows your users to manage their subscriptions, update payment methods, and view their invoice history without requiring you to build a custom interface.

1. Go to Billing → Customer portal.
2. Activate and configure the portal with your branding.
3. Enable the actions you want to allow, such as:
   • Updating subscriptions (upgrading/downgrading plans).
   • Canceling subscriptions.
   • Updating payment methods.
   • Viewing invoice history.

Step 5: Get Price IDs for Environment

Your application needs the specific Price IDs from Stripe to create checkout sessions.

1. Navigate to the Products section.
2. For each product, you will see a list of associated prices.
3. Copy the ID for each price (it will start with price_...).
4. Add these IDs to your application's environment variables, mapping them to descriptive names, for example:

   # Base Plans - Monthly
   NEXT_PUBLIC_PRICE_GROWTH_MONTHLY=price_1P...
   # Base Plans - Yearly
   NEXT_PUBLIC_PRICE_GROWTH_YEARLY=price_1P...
   # Add-ons - Monthly
   NEXT_PUBLIC_PRICE_MULTILINGUAL_MONTHLY=price_1P...

Step 6: Test Your Integration

Always test your integration thoroughly in Test mode before going live.

Once you have completed and tested these steps, you can switch to Live mode and repeat the process with your live API keys and product information.