Stripe Payments & SaaS Billing Systems · 강의

체험 기간과 요금제 업그레이드 처리

신규 구독자를 위한 체험 기간을 구현하고 서로 다른 구독 요금제 간의 원활한 업그레이드와 다운그레이드를 관리합니다.

체험 기간과 요금제 업그레이드 처리은(는) CoddyKit의 무료 Stripe Payments & SaaS Billing Systems 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Stripe Payments & SaaS Billing Systems 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Stripe Payments & SaaS Billing Systems 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

Flexible Subscriptions Intro

Welcome! In this lesson, we'll dive into making your subscription service more flexible and user-friendly. We'll cover two key features:

Trial Periods: Attract new users with a taste of your service.
Plan Upgrades/Downgrades: Allow users to adjust their plan as their needs evolve.

These features are crucial for improving customer satisfaction and retention.

Understanding Trial Periods

A trial period gives users free access to your service for a limited time before they are charged. It's a great way to:

Let users experience your full features.
Build trust and demonstrate value.
Reduce friction for new sign-ups.

Stripe handles the billing logic automatically once the trial ends.

Setting Up a Trial Period

You can define a trial period when creating or updating a Price in Stripe. This sets the default trial duration for any subscription created with that price.

In the Stripe Dashboard, when you create a new Price, look for the 'Trial period' option and specify the number of days (e.g., 7 or 30 days).

Via the API, you use the trial_period_days parameter.

Creating a Subscription with Trial

To create a new subscription that includes a trial, you simply pass the trial_period_days parameter when creating the subscription. Stripe will automatically manage the trial start and end dates.

Try running this Java example:

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Subscription;
import com.stripe.param.SubscriptionCreateParams;
import java.util.ArrayList;
import java.util.List;

public class Main {
  public static void main(String[] args) {
    Stripe.apiKey = "sk_test_YOUR_SECRET_KEY"; // Replace with your actual test secret key

    try {
      List<SubscriptionCreateParams.Item> items = new ArrayList<>();
      items.add(
        SubscriptionCreateParams.Item.builder()
          .setPrice("price_1OQ2eFLkd2M9gC7q0L1xP5cW") // Replace with YOUR Price ID
          .build()
      );

      SubscriptionCreateParams params = SubscriptionCreateParams.builder()
        .setCustomer("cus_Pq34567890abcdef") // Replace with YOUR Customer ID
        .addAllItem(items)
        .setTrialPeriodDays(7) // Sets a 7-day trial
        .build();

      Subscription subscription = Subscription.create(params);

      System.out.println("Subscription created with trial:");
      System.out.println("ID: " + subscription.getId());
      System.out.println("Status: " + subscription.getStatus());
      System.out.println("Trial End (Unix timestamp): " + subscription.getTrialEnd());

    } catch (StripeException e) {
      System.err.println("Error creating subscription: " + e.getMessage());
    }
  }
}

Monitoring Trial Status

You can check a subscription's status to see if it's currently in a trial. A subscription in trial will have a status of trialing and the trial_end field will contain a Unix timestamp indicating when the trial concludes.

This allows your application to display appropriate messaging to the user.

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Subscription;

public class Main {
  public static void main(String[] args) {
    Stripe.apiKey = "sk_test_YOUR_SECRET_KEY";

    try {
      String subscriptionId = "sub_12345ABCDEF"; // Replace with an existing Subscription ID
      Subscription subscription = Subscription.retrieve(subscriptionId);

      System.out.println("Subscription ID: " + subscription.getId());
      System.out.println("Current Status: " + subscription.getStatus());

      if ("trialing".equals(subscription.getStatus())) {
        System.out.println("This subscription is currently in a trial period.");
        System.out.println("Trial ends on: " + subscription.getTrialEnd());
      } else if ("active".equals(subscription.getStatus())) {
        System.out.println("This subscription is active and being billed.");
      } else {
        System.out.println("Subscription status: " + subscription.getStatus());
      }

    } catch (StripeException e) {
      System.err.println("Error retrieving subscription: " + e.getMessage());
    }
  }
}

Preparing for Trial End

It's good practice to notify users before their trial ends. This gives them time to decide whether to continue or cancel, reducing unexpected charges and potential disputes.

Stripe sends a webhook event called customer.subscription.trial_will_end a few days before the trial concludes. You can configure this notification period in your Stripe settings.

Your application should listen for this webhook to send custom email reminders.

Understanding Plan Changes

As your users' needs change, they might want to switch to a different subscription plan. Stripe makes it easy to handle upgrades (moving to a higher-tier plan) and downgrades (moving to a lower-tier plan).

When you update a subscription, Stripe automatically handles the complex billing calculations, including prorations, to ensure fair charges.

Upgrading a Subscription

To upgrade a subscription, you update the existing subscription's items array, replacing the old Price ID with the new, higher-tier Price ID. Stripe will then adjust the billing accordingly.

The proration_behavior parameter lets you control how charges are calculated for the change. always_invoice is a common choice.

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Subscription;
import com.stripe.param.SubscriptionUpdateParams;
import java.util.ArrayList;
import java.util.List;

public class Main {
  public static void main(String[] args) {
    Stripe.apiKey = "sk_test_YOUR_SECRET_KEY";

    try {
      String subscriptionId = "sub_12345ABCDEF"; // Replace with the Subscription ID to update
      String currentSubscriptionItemId = "si_GHIJKLMN"; // Get from the existing subscription's items
      String newPriceId = "price_67890UVWXY"; // Replace with the ID of the new, higher-tier Price

      Subscription resource = Subscription.retrieve(subscriptionId);

      List<SubscriptionUpdateParams.Item> items = new ArrayList<>();
      items.add(
        SubscriptionUpdateParams.Item.builder()
          .setId(currentSubscriptionItemId)
          .setPrice(newPriceId)
          .build()
      );

      SubscriptionUpdateParams params = SubscriptionUpdateParams.builder()
        .addAllItem(items)
        .setProrationBehavior(SubscriptionUpdateParams.ProrationBehavior.ALWAYS_INVOICE) // Prorate and invoice immediately
        .build();

      Subscription updatedSubscription = resource.update(params);

      System.out.println("Subscription upgraded successfully:");
      System.out.println("ID: " + updatedSubscription.getId());
      System.out.println("Status: " + updatedSubscription.getStatus());
      System.out.println("New Price ID: " + updatedSubscription.getItems().getData().get(0).getPrice().getId());

    } catch (StripeException e) {
      System.err.println("Error updating subscription: " + e.getMessage());
    }
  }
}

Handling Plan Downgrades

Downgrading a subscription follows the same API pattern as upgrading. You update the subscription's items array with the ID of the new, lower-tier Price.

Stripe will automatically calculate any credits or refunds due to the customer based on the proration_behavior you specify. For more details on proration, refer to the 'Implementing Prorations' lesson.

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Subscription;
import com.stripe.param.SubscriptionUpdateParams;
import java.util.ArrayList;
import java.util.List;

public class Main {
  public static void main(String[] args) {
    Stripe.apiKey = "sk_test_YOUR_SECRET_KEY";

    try {
      String subscriptionId = "sub_12345ABCDEF"; // Replace with the Subscription ID to update
      String currentSubscriptionItemId = "si_GHIJKLMN"; // Get from the existing subscription's items
      String newPriceId = "price_ZZZZAASSDD"; // Replace with the ID of the new, lower-tier Price

      Subscription resource = Subscription.retrieve(subscriptionId);

      List<SubscriptionUpdateParams.Item> items = new ArrayList<>();
      items.add(
        SubscriptionUpdateParams.Item.builder()
          .setId(currentSubscriptionItemId)
          .setPrice(newPriceId)
          .build()
      );

      SubscriptionUpdateParams params = SubscriptionUpdateParams.builder()
        .addAllItem(items)
        .setProrationBehavior(SubscriptionUpdateParams.ProrationBehavior.CREATE_PRORATIONS) // Create prorations but don't invoice immediately
        .build();

      Subscription updatedSubscription = resource.update(params);

      System.out.println("Subscription downgraded successfully:");
      System.out.println("ID: " + updatedSubscription.getId());
      System.out.println("Status: " + updatedSubscription.getStatus());
      System.out.println("New Price ID: " + updatedSubscription.getItems().getData().get(0).getPrice().getId());

    } catch (StripeException e) {
      System.err.println("Error updating subscription: " + e.getMessage());
    }
  }
}

Quick Check: Trial End

To notify a user that their subscription trial is about to end, which Stripe webhook event would you typically configure your application to listen for?

Recap & Next Steps

Great job! You've learned how to implement crucial features for flexible subscriptions:

How to define and create subscriptions with trial periods.
How to monitor a subscription's trial status.
The importance of the customer.subscription.trial_will_end webhook.
How to programmatically upgrade and downgrade subscription plans using the Stripe API.

These tools empower you to offer a dynamic and user-friendly subscription experience. Next, we'll explore prorations and metered billing in more detail!

자주 묻는 질문

“체험 기간과 요금제 업그레이드 처리” 강의는 무료인가요?

네 — “체험 기간과 요금제 업그레이드 처리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Stripe Payments & SaaS Billing Systems 강의 전체를 잠금 해제할 수 있습니다. Stripe Payments & SaaS Billing Systems 강의에는 총 4개의 강의가 포함되어 있습니다.

“체험 기간과 요금제 업그레이드 처리”에서 뭘 배우나요?

신규 구독자를 위한 체험 기간을 구현하고 서로 다른 구독 요금제 간의 원활한 업그레이드와 다운그레이드를 관리합니다. 브라우저에서 직접 실행하는 실습 코드로 Stripe Payments & SaaS Billing Systems을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Stripe Payments & SaaS Billing Systems을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Stripe Payments & SaaS Billing Systems은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“체험 기간과 요금제 업그레이드 처리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Stripe Payments & SaaS Billing Systems 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Stripe Payments & SaaS Billing Systems 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Stripe Payments & SaaS Billing Systems(으)로 돌아가기