Stripe Subscriptions

Info

This process works for both subscriptions and one-time payments.

Setup

This guide shows how to implement Stripe Checkout for payment processing and configure webhooks to handle user access.

You need to have Stripe set up.

1. Create a product in Stripe:

   • Navigate to: Dashboard > Product Catalog > Add Product
   • Configure product details and pricing
   • Save the product

2. Copy the price ID (format: price_*) from the Pricing section and add it to STRIPE_PLANS in settings.py

3. Add the hero component to your template if not already done so:

   templates/index.html

   <!-- ... -->
   {% block content %}
       {% include 'components/hero.html' %}
   <!-- ... -->
   

   The hero component includes the checkout button:

   templates/hero.html

   <!-- ... -->
     <div class="flex justify-center lg:justify-start">
         {% include 'components/button-checkout.html' with price_id=STRIPE_PLANS.1.price_id %}
     </div>
   <!-- ... -->
   

4. Webhook Configuration:

   • Endpoint: https://<my-domain.com>/webhook/ - do not forget the trailing slash
   • Handles payment events and user access control
   • Updates has_access in user/models.py

   Info

   Local development requires a Stripe CLI webhook listener.

5. Testing:

   • Visit http://localhost:8000/
   • Test payments using card number: 4242 4242 4242 4242

6. Custom webhook logic can be added in app/views.py for:

   • Payment failure handling
   • Usage tracking
   • Event notifications

7. Users can manage their subscriptions with the button-account.html component (cancel, update credit card, etc.), which is shown by default in the navbar when the user is logged in.