0Pricing
Stripe Payments & SaaS Billing Systems · Lekcja

Implementacja systemów rozliczeń opartych na użyciu

Zaprojektuj i zintegruj billing oparty na użyciu, w którym klienci są obciążani na podstawie wykorzystania usługi lub zasobu.

Implementacja systemów rozliczeń opartych na użyciu to bezpłatna lekcja Stripe Payments & SaaS Billing Systems na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Stripe Payments & SaaS Billing Systems, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Stripe Payments & SaaS Billing Systems zawiera 4 lekcji w sumie.

Części tej lekcji nie zostały jeszcze przetłumaczone i są wyświetlane po angielsku.

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:

  1. Create a Product: This represents the service itself (e.g., "Cloud Storage").
  2. 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.

Często zadawane pytania

Czy lekcja „Implementacja systemów rozliczeń opartych na użyciu” jest bezpłatna?

Tak — pełny tekst „Implementacja systemów rozliczeń opartych na użyciu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Stripe Payments & SaaS Billing Systems, przejdź na CoddyKit PRO. Kurs Stripe Payments & SaaS Billing Systems zawiera 4 lekcji w sumie.

Co nauczysz się w „Implementacja systemów rozliczeń opartych na użyciu”?

Zaprojektuj i zintegruj billing oparty na użyciu, w którym klienci są obciążani na podstawie wykorzystania usługi lub zasobu. Ćwiczysz Stripe Payments & SaaS Billing Systems z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Stripe Payments & SaaS Billing Systems?

Nie wymagamy żadnego doświadczenia. Stripe Payments & SaaS Billing Systems w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Implementacja systemów rozliczeń opartych na użyciu”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Stripe Payments & SaaS Billing Systems?

Tak. Każda lekcja Stripe Payments & SaaS Billing Systems zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Implementacja systemów rozliczeń opartych na użyciu
  2. Konfiguracja cen zależnych od liczby miejsc i progów
  3. Niestandardowe cykle i harmonogramy rozliczeń
  4. Szczegółowe omówienie progów cenowych wolumenowych i progresywnych
← Powrót do Stripe Payments & SaaS Billing Systems