サブスクリプション管理
Stripe Subscriptionsを使って継続課金のロジックを実装し、プランの作成や顧客のサブスクリプションサイクルを管理します。
「サブスクリプション管理」はCoddyKit上の無料AI Powered SaaS: Stripe + Auth + Billing + Deployレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAI Powered SaaS: Stripe + Auth + Billing + Deploy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 AI Powered SaaS: Stripe + Auth + Billing + Deployコースには全4レッスンが含まれています。
このレッスンの一部はまだ翻訳されておらず、英語で表示されています。
Why Recurring Billing?
Welcome to subscription management! For many SaaS businesses, recurring revenue is crucial. It provides predictable income and helps foster long-term customer relationships.
Stripe Subscriptions make it easy to implement recurring billing without handling complex payment logic yourself, allowing you to focus on your product.
Products & Prices Revisited
Before creating a subscription, you need to define what customers are subscribing to. Stripe uses two key concepts that work together:
- Products: These represent the service or good you offer (e.g., "Basic Plan", "Premium AI Access").
- Prices: These define how much and how often you charge for a product (e.g., "$10/month", "$100/year").
A single product can have multiple prices, offering flexibility for different billing cycles or tiers.
Define Your SaaS Product
First, let's create a Stripe Product. This object represents your core service or plan, like a "Pro AI Plan" for your SaaS. You can create products via the Stripe Dashboard or programmatically.
Here's how to create a product using the Stripe Python API:
import stripe
stripe.api_key = "sk_test_YOUR_SECRET_KEY" # Use your actual test key
try:
product = stripe.Product.create(
name="Pro AI Plan",
description="Access to advanced AI features and higher usage limits."
)
print(f"Product created: {product.id}")
print(f"Name: {product.name}")
except stripe.error.StripeError as e:
print(f"Error creating product: {e}")Set Your Recurring Price
Once you have a Product, you define its Price. For subscriptions, this price must be recurring. You specify the currency, amount (in cents), and the billing interval (e.g., month, year).
Let's create a monthly recurring price for our "Pro AI Plan" (replace PRODUCT_ID with the ID from the previous step):
import stripe
stripe.api_key = "sk_test_YOUR_SECRET_KEY" # Use your actual test key
# IMPORTANT: Replace with an actual product ID from your Stripe account
# Example: 'prod_Nq7sN8sN8sN8sN'
PRODUCT_ID = "prod_YOUR_PRODUCT_ID"
try:
price = stripe.Price.create(
unit_amount=2000, # $20.00 in cents
currency="usd",
recurring={"interval": "month"},
product=PRODUCT_ID,
)
print(f"Price created: {price.id}")
print(f"Amount: ${price.unit_amount / 100:.2f} / {price.recurring.interval}")
except stripe.error.StripeError as e:
print(f"Error creating price: {e}")Preparing Your Customer
Every subscription in Stripe is tied to a Customer object. This object holds essential details like their email, payment methods, and billing history.
When a user signs up for your SaaS, you'll typically create a Stripe Customer for them. If they already exist, you'll retrieve their existing customer ID to associate new subscriptions.
Registering a New Customer
To link a user to a subscription, we first need to create a Customer object in Stripe. This is a one-time process for each unique user in your system.
Here's how to create a new customer in Stripe:
import stripe
stripe.api_key = "sk_test_YOUR_SECRET_KEY" # Use your actual test key
try:
customer = stripe.Customer.create(
email="janedoe@example.com",
name="Jane Doe",
description="Customer for Pro AI Plan"
)
print(f"Customer created: {customer.id}")
print(f"Email: {customer.email}")
except stripe.error.StripeError as e:
print(f"Error creating customer: {e}")Activating the Subscription
Now for the main event! With a Product, a Recurring Price, and a Customer, you can create a subscription. This action links the customer to the chosen plan and initiates recurring billing.
When creating a subscription, you specify the customer ID and the price ID. Stripe handles the recurring billing and invoicing automatically.
import stripe
stripe.api_key = "sk_test_YOUR_SECRET_KEY" # Use your actual test key
# IMPORTANT: Replace with actual customer ID (e.g., 'cus_Nq7sN8sN8sN8sN')
CUSTOMER_ID = "cus_YOUR_CUSTOMER_ID"
# IMPORTANT: Replace with actual price ID (e.g., 'price_1Nq7sN8sN8sN8sN')
PRICE_ID = "price_YOUR_PRICE_ID"
try:
subscription = stripe.Subscription.create(
customer=CUSTOMER_ID,
items=[{"price": PRICE_ID}],
# 'expand' helps fetch related objects like the initial invoice
expand=["latest_invoice.payment_intent"]
)
print(f"Subscription created: {subscription.id}")
print(f"Status: {subscription.status}")
if subscription.latest_invoice and subscription.latest_invoice.payment_intent:
print(f"Initial Payment Intent Status: {subscription.latest_invoice.payment_intent.status}")
except stripe.error.StripeError as e:
print(f"Error creating subscription: {e}")Lifecycle of a Subscription
Stripe subscriptions go through various statuses indicating their current state. Monitoring these statuses is key for managing user access and support:
trialing: Customer is in a trial period.active: Subscription is active and billing successfully.past_due: A payment failed, and Stripe is attempting to recover.canceled: Subscription has been canceled.unpaid: Subscription has exhausted its dunning attempts and is unpaid.
Managing Active Subscriptions
Customers might want to upgrade, downgrade, or cancel their subscriptions. Stripe's API provides methods to handle these actions gracefully:
- Updating: Change the price, quantity, or add/remove items using
stripe.Subscription.modify(). - Cancelling: End a subscription immediately or at the end of the current billing period using
stripe.Subscription.cancel().
These actions often trigger webhooks, which are crucial for keeping your application in sync with Stripe!
Subscription Flow Quiz
Which of the following are essential steps in creating a new recurring subscription for a user in Stripe?
Recap: Your First Subscriptions
Great job! You've learned how to implement recurring billing with Stripe Subscriptions.
- We covered creating Products and Prices that form the basis of your subscription plans.
- We explored managing Customers, who are the recipients of these subscriptions.
- And we successfully created a Subscription, understanding its lifecycle and basic management.
Next, we'll dive into handling Stripe Webhooks to react to payment events and subscription changes in real-time, making your application dynamic and responsive!
よくある質問
「サブスクリプション管理」レッスンは無料ですか？
はい。「サブスクリプション管理」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、AI Powered SaaS: Stripe + Auth + Billing + Deployコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 AI Powered SaaS: Stripe + Auth + Billing + Deployコースには全4レッスンが含まれています。
「サブスクリプション管理」で何を学びますか？
Stripe Subscriptionsを使って継続課金のロジックを実装し、プランの作成や顧客のサブスクリプションサイクルを管理します。 ブラウザで直接実行するハンズオンコードでAI Powered SaaS: Stripe + Auth + Billing + Deployを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
AI Powered SaaS: Stripe + Auth + Billing + Deployを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのAI Powered SaaS: Stripe + Auth + Billing + Deployは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「サブスクリプション管理」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このAI Powered SaaS: Stripe + Auth + Billing + Deployレッスンでコードを書いて実行できますか？
はい。すべてのAI Powered SaaS: Stripe + Auth + Billing + Deployレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。