إدارة الاشتراكات
نفّذ منطق الفوترة المتكررة باستخدام Stripe Subscriptions، بما في ذلك إنشاء الخطط ودورات اشتراك العملاء.
إدارة الاشتراكات درس مجاني في AI Powered SaaS: Stripe + Auth + Billing + Deploy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في 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/7) وفتح باقي دورة 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/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ AI Powered SaaS: Stripe + Auth + Billing + Deploy؟
لا تُشترط خبرة سابقة. AI Powered SaaS: Stripe + Auth + Billing + Deploy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «إدارة الاشتراكات»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس AI Powered SaaS: Stripe + Auth + Billing + Deploy هذا؟
نعم. كل درس في AI Powered SaaS: Stripe + Auth + Billing + Deploy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- إدارة الاشتراكات
- التعامل مع Webhooks في Stripe
- بوابة العملاء وسجل الفوترة
- الفوترة بالقياس والتسعير حسب الاستخدام