Stripe Payments & SaaS Billing Systems · 课时

实现基于用量的计费系统

设计并集成基于用量的计费，让客户根据其对服务或资源的使用量付费。

实现基于用量的计费系统 是 CoddyKit 上的免费 Stripe Payments & SaaS Billing Systems 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Stripe Payments & SaaS Billing Systems 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Stripe Payments & SaaS Billing Systems 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

What is Usage-Based Billing?

Usage-based billing, also known as metered billing, charges customers based on how much they use a product or service.

Instead of a fixed monthly fee, customers pay only for their actual consumption. This model is popular for services like cloud storage, API calls, or data processing.

It offers flexibility and fairness, aligning costs directly with value received.

Core Concepts: Meters & Events

At the heart of usage-based billing are meters and events.

Meter: This is the specific resource or action you track. Examples include "API calls," "GB stored," or "minutes used."
Event: A single occurrence that increments your meter. Every time a user makes an API call, stores a file, or uses a minute, an "event" happens.

Your system needs to record and report these events.

Designing Your Usage Meter

When designing your usage-based system, first decide what to meter. What defines "usage" for your service?

Example: For a cloud storage service, your meter could be "gigabytes stored."
Granularity: How often do you report usage? Instantly? Hourly? Daily? Stripe typically aggregates usage over a billing cycle.

Clearly defining your meter ensures accurate billing.

Stripe's Metered Billing

Stripe supports usage-based billing through metered prices.

You define a product (e.g., "API Access") and then a price that specifies a cost "per unit" (e.g., $0.01 per API call). Instead of setting a fixed quantity for a subscription item, you report usage records to Stripe.

Stripe then aggregates these usage records over the billing period and charges the customer accordingly.

Product & Price Setup (Conceptual)

To set up usage-based billing in Stripe, you'd typically:

Create a Product: This represents the service itself (e.g., "Cloud Storage").
Create a Price: Link this price to your product. Crucially, set its recurring.usage_type to 'metered' and specify the unit_amount (cost per unit) or tiers for graduated pricing.

This tells Stripe that the price is based on reported usage.

Reporting Usage via API

Once your customer is subscribed to a metered price, you'll need to report their usage to Stripe using the API.

You'll send a Usage Record for a specific Subscription Item, indicating the quantity used. Stripe then adds this quantity to the customer's current billing cycle total.

This is usually done server-side from your application as usage events occur.

Code: Reporting Usage

Here's a simplified Java example showing how you might report usage to Stripe. You'd replace placeholders with your actual keys and IDs.

This example reports '10' units of usage for a specific subscription item.

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.UsageRecord;
import com.stripe.param.UsageRecordCreateParams;

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

    String subscriptionItemId = "si_YOUR_SUBSCRIPTION_ITEM_ID"; // Get this from your subscription
    Long quantityToReport = 10L; // The amount of usage to report

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

      UsageRecord usageRecord = UsageRecord.createOnSubscriptionItem(
        subscriptionItemId, params
      );

      System.out.println("Usage reported successfully: " + usageRecord.getId());
    } catch (StripeException e) {
      System.err.println("Error reporting usage: " + e.getMessage());
    }
  }
}

Billing Cycles & Aggregation

Stripe aggregates all usage records for a specific subscription item within a billing cycle.

When the billing cycle ends, Stripe calculates the total usage based on the configured aggregate_usage for that price. This total is then multiplied by the unit price (or applied to tiers) to determine the final charge for that period.

The invoice is then generated and finalized.

Different Aggregation Types

Stripe offers different ways to aggregate usage for a metered price:

sum: (Default) Adds up all reported usage quantities over the billing period. Perfect for API calls or data transfer.
max: Uses the highest reported usage quantity during the period. Useful for "peak usage" models, like concurrent users.
last_ever: Uses the last reported usage quantity. Great for "snapshot" billing, like storage used at the end of the period.

Choose the type that best fits your service.

Quick Check: Usage Billing

Which of the following scenarios is best suited for a 'last_ever' aggregation type in Stripe's usage-based billing?

Recap: Usage-Based Billing

You've learned how to design and implement usage-based billing with Stripe!

We covered the core concepts of meters and events.
Explored how Stripe uses metered prices and usage records.
Saw a code example for reporting usage via the API.
Understood different aggregation types like sum, max, and last_ever.

This model offers great flexibility for both you and your customers.

常见问题解答

「实现基于用量的计费系统」课时是免费的吗？

是的 — 「实现基于用量的计费系统」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Stripe Payments & SaaS Billing Systems 课程的其余内容，请升级到 CoddyKit PRO。 Stripe Payments & SaaS Billing Systems 课程共包含 4 节课。

「实现基于用量的计费系统」这节课中我会学到什么？

设计并集成基于用量的计费，让客户根据其对服务或资源的使用量付费。你通过在浏览器中直接运行的动手代码来练习 Stripe Payments & SaaS Billing Systems，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Stripe Payments & SaaS Billing Systems 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Stripe Payments & SaaS Billing Systems 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「实现基于用量的计费系统」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Stripe Payments & SaaS Billing Systems 课中编写并运行代码吗？

能。每节 Stripe Payments & SaaS Billing Systems 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Stripe Payments & SaaS Billing Systems