Stripe Payments & SaaS Billing Systems · 강의

일할 계산과 사용량 기반 청구 구현

주기 중 변경 사항에 대한 일할 계산을 이해하고 적용하며 사용량 기반 구독 모델을 위한 사용량 측정 청구를 설정합니다.

레슨 2/411개 단계

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

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

Flexible Billing: Intro

Welcome to advanced subscription features! Many businesses need more flexible billing than just a fixed monthly or yearly fee.

Today, we'll dive into two powerful concepts: prorations and metered billing. These allow you to handle mid-cycle changes and usage-based pricing with ease.

What are Prorations?

Imagine a customer upgrades their subscription plan halfway through their billing cycle. What happens to the money they already paid for the cheaper plan?

Proration is the process of proportionally adjusting charges when a subscription changes mid-cycle. Stripe automatically calculates this for you.

Credit: For the unused portion of the old plan.
Charge: For the new plan's usage up to the end of the current cycle.

Stripe's Proration Logic

When you modify a subscription in Stripe (e.g., changing the price or quantity of a subscription item), Stripe automatically calculates the proration.

It creates line items on the customer's invoice: a credit for the unused time on the old plan and a charge for the new plan from the change date to the end of the current billing period.

This ensures fairness and accuracy for both you and your customers.

Implementing Prorated Changes

When updating a subscription via the Stripe API, prorations are typically handled by default. You can also explicitly control this behavior using the proration_behavior parameter.

CREATE_PRORATIONS ensures that proration items are added to the invoice immediately or at the end of the cycle.

Try running this conceptual Java code:

import com.stripe.Stripe;
import com.stripe.param.SubscriptionUpdateParams;

public class Main {
  public static void main(String[] args) {
    // In a real app, you'd set Stripe.apiKey and handle exceptions.
    // This snippet focuses on the update parameters.

    String subscriptionItemId = "si_EXISTING_ITEM_ID";
    String newPriceId = "price_NEW_PLAN_ID";

    SubscriptionUpdateParams params =
      SubscriptionUpdateParams.builder()
        .addItem(
          SubscriptionUpdateParams.Item.builder()
            .setId(subscriptionItemId) // ID of the existing subscription item
            .setPrice(newPriceId)     // The new price for the subscription
            .build()
        )
        .setProrationBehavior(SubscriptionUpdateParams.ProrationBehavior.CREATE_PRORATIONS)
        .build();

    System.out.println("Subscription update parameters created:");
    System.out.println("- New Price ID: " + newPriceId);
    System.out.println("- Proration Behavior: CREATE_PRORATIONS");
    System.out.println("Stripe will automatically calculate and apply prorations.");
  }
}

What is Metered Billing?

Metered billing (or usage-based billing) charges customers based on how much of a service they actually use, rather than a fixed amount.

Think of utility bills (electricity, water) or cloud services (data storage, API calls). Customers only pay for what they consume.

Examples: API requests, GB of storage, minutes of video streaming, number of active users.

Setting Up Metered Products

To implement metered billing, you first need to define a Product and a Price in Stripe with a usage_type set to metered.

This tells Stripe that the quantity for this price will be reported by your application, not fixed at subscription creation.

You'll also define the billing scheme (e.g., per_unit or tiered) and optional aggregation method.

Reporting Usage to Stripe

For metered billing, your application needs to track customer usage and report it to Stripe periodically, usually as it occurs or at regular intervals (e.g., daily).

This is done using the Usage Record API. You report the quantity of usage for a specific subscription_item.

Here's a conceptual Java example:

import com.stripe.Stripe;
import com.stripe.param.UsageRecordCreateParams;

public class Main {
  public static void main(String[] args) {
    // In a real app, you'd set Stripe.apiKey and handle exceptions.
    // This snippet focuses on creating a usage record.

    String subscriptionItemId = "si_METERED_ITEM_ID"; // The ID of the metered subscription item
    long quantityUsed = 10L; // The amount of usage to report

    UsageRecordCreateParams params =
      UsageRecordCreateParams.builder()
        .setQuantity(quantityUsed)
        .setTimestamp(System.currentTimeMillis() / 1000L) // Current time in seconds since epoch
        .setAction(UsageRecordCreateParams.Action.INCREMENT) // Add to existing usage
        .build();

    System.out.println("Usage record creation parameters created:");
    System.out.println("- Subscription Item ID: " + subscriptionItemId);
    System.out.println("- Quantity Reported: " + quantityUsed);
    System.out.println("- Action: INCREMENT (adds to previous usage)");
    System.out.println("This usage will be billed at the end of the current billing cycle.");
  }
}

How Metered Usage is Billed

Stripe aggregates all usage records reported for a specific metered subscription item within a billing period.

At the end of the billing cycle (or when an invoice is finalized), Stripe calculates the total usage and applies the corresponding price, adding it to the customer's invoice.

You can define how usage is aggregated (e.g., sum, last_ever, max) when creating the price.

Prorations vs. Metered: Recap

It's important to distinguish between prorations and metered billing:

Prorations: Adjust charges for changes to fixed-price subscription items mid-cycle (e.g., upgrading from Basic to Pro plan).
Metered Billing: Charges based on actual consumption of a service, with usage reported over time (e.g., paying per API call or GB of data).

Both offer powerful ways to make your billing more flexible and customer-friendly.

Quick Check: Flexible Billing

Which of the following scenarios would typically involve metered billing in Stripe?

인터랙티브 레슨에서 답해보세요

Recap: Prorations & Metered

Great job! You've learned how to handle flexible billing scenarios with Stripe:

Prorations: Automatically adjust charges when subscriptions change mid-cycle, ensuring fair billing.
Metered Billing: Charge customers based on their actual consumption, requiring you to report usage via the Stripe API.

These features are crucial for building dynamic and scalable SaaS platforms. Keep exploring to master more advanced Stripe capabilities!

무료로 시작

AI 튜터와 함께 Stripe Payments & SaaS Billing Systems을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 12
레슨: 48

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“일할 계산과 사용량 기반 청구 구현” 강의는 무료인가요?

네 — “일할 계산과 사용량 기반 청구 구현” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 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개 중 2번째 강의입니다.

“일할 계산과 사용량 기반 청구 구현” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

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