drf-stripe-subscription
An out-of-box Django REST framework solution for payment and subscription management using Stripe. The goal of this package is to utilize Stripe provided UI and features as much as possible to manage subscription product models. This package helps you make use of Stripe's hosted UI for customer checkout, billing management, as well as for admin to manage product, pricing, and customer subscriptions.
- Django data models representing Stripe data objects
- Supports Stripe Webhook for managing changes with your products, prices, and customer subscriptions
- Django management commands for synchronizing data with Stripe
- Django REST API endpoints supporting Stripe Checkout Session and Customer Portal
Installation & Setup
pip install drf-stripe-subscription
Include the following drf_stripe settings in Django project settings.py:
DRF_STRIPE = {
"STRIPE_API_SECRET": "my_stripe_api_key",
"STRIPE_WEBHOOK_SECRET": "my_stripe_webhook_key",
"FRONT_END_BASE_URL": "http://localhost:3000",
}
Include drf_stripe in Django INSTALLED_APPS setting:
INSTALLED_APPS = (
...,
"rest_framework",
"drf_stripe",
...
)
Include drf_stripe.url routing in Django project's urls.py, ie:
from django.urls import include, path
urlpatterns = [
path("stripe/", include("drf_stripe.urls")),
...
]
Run migrations command:
python manage.py migrate
Pull Product and Price data from Stripe into Django database using the following command:
python manage.py update_stripe_products
Finally, start Django development server
python manage.py runserver
as well as Stripe CLI to forward Stripe webhook requests:
stripe listen --forward-to 127.0.0.1:8000/stripe/webhook/
Usage
The following REST API endpoints are provided:
List product prices to subscribe
my-site.com/stripe/subscribable-product/
This endpoint is available to both anonymous users and authenticated users. Anonymous users will see a list of all currently available products. For authenticated users, this will be a list of currently available products without any products that the user has already subscribed currently.
List user's current subscriptions
my-site.com/stripe/my-subscription/
This endpoint provides a list of active subscriptions for the current user.
List user's current subscription items
my-site.com/stripe/my-subscription-items/
This endpoint provides a list of active subscription items for the current user.
Create a checkout session using Stripe hosted Checkout page
my-site.com/stripe/checkout/
This endpoint creates Stripe Checkout Session
Make request with the follow request data:
{"price_id": "price_stripe_price_id_to_be_checked_out"}
The response will contain a session_id which can be used by Stripe:
{"session_id": "stripe_checkout_session_id"}
This session_id is a unique identifier for a Stripe Checkout Session, and can be used by redirectToCheckout in Stripe.js. You can implement this in your frontend application to redirect to a Stripe hosted Checkout page after fetching the session id.
By default, the Stripe Checkout page will redirect the user back to your application at either mysite.com/payment/session={{CHECKOUT_SESSION_ID}} if the checkout is successful, or mysite.com/manage-subscription/ if checkout is cancelled.
Stripe Customer Portal
mysite.com/stripe/customer-portal
This will create a Stripe billing portal session, and return the url to that session:
{"url": "url_to_Stripe_billing_portal_session"
This is a link that you can use in your frontend application to redirect a user to Stripe Customer Portal and back to your application. By default, Stripe Customer Portal will redirect the user back to your frontend application at my-site.com/manage-subscription/
Stripe Webhook
mysite.com/stripe/webhook/
This the REST API endpoint Stripe servers can call to update your Django backend application. The following Stripe webhook events are currently supported:
product.created
product.updated
product.deleted
price.created
price.updated
price.deleted
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
With these Stripe events, you can:
- Manage your products and pricing model from Stripe Portal, and rely on webhook to update your Django application automatically.
- Manage your customer subscriptions from Stripe Portal, and rely on webhook to update your Django application automatically.
StripeUser
The StripeUser model comes with a few attributs that allow accessing information about the user quickly:
from drf_stripe.models import StripeUser
stripe_user = StripeUser.objects.get(user_id=django_user_id)
print(stripe_user.subscription_items)
print(stripe_user.current_subscription_items)
print(stripe_user.subscribed_products)
print(stripe_user.subscribed_features)
Product features
Stripe does not come with a way of managing features specific to your products and application. drf-stripe-subscription provides additional tables to manage features associated with each Stripe Product:
- Feature: this table contains feature_id and a description for the feature.
- ProductFeature: this table keeps track of the many-to-many relation between Product and Feature.
To assign features to a product, go to Stripe Dashboard -> Products -> Add Product/Edit Product: Under Product information, click on Additional options, add metadata.
Add an entry called features, the value of the entry should be a space-delimited string describing a set of features, ie: FEATURE_A FEATURE_B FEATURE_C.
If you have Stripe CLI webhook running, you should see that your Django server has automatically received product information update, and created/updated the associated ProductFeature and Feature instances. Otherwise, you can also run the python manage.py update_stripe_products command again to synchronize all of your product data. The description attribute of each Feature instance will default to the same value as feature_id, you should update the description yourself if needed.
1 Sep 28, 2021
11 Dec 6, 2022
5 Feb 19, 2022
2 Sep 28, 2022
997 Dec 24, 2022
18 Sep 9, 2022
5 Nov 24, 2022
6 Aug 2, 2022
3 Jan 19, 2022
2 Dec 13, 2022
1 Aug 9, 2022
68 Oct 19, 2022
167 Nov 10, 2022
1.6k Jan 6, 2023
1.2k Jan 1, 2023
703 Dec 22, 2022
303 Dec 27, 2022
1 Nov 3, 2021
2 Dec 19, 2022