# Kreditbasiertes Preismodell einrichten Von Kunden vorbestellte Gutschriften abbuchen Mit Gutschriften können Sie einen festen Geldbetrag für die Nutzung Ihrer nutzungsbasierten Produkte anbieten. Dieses Modell eignet sich gut, wenn Sie Ihren Kundinnen und Kunden im Voraus Planbarkeit bieten und gleichzeitig den Umsatz direkt an der Nutzung ausrichten möchten. Wenn Sie beispielsweise eine API verkaufen, die Bilder und Cloud-Speicher verarbeitet, können Kund/innen zu Beginn des Monats Gutschriften in 100 USD kaufen. Sie können den Geldbetrag für eine beliebige Kombination aus API-Nutzung und Cloud-Speichernutzung ausgeben und am Ende des Monats einen Zuschlag für beide Dienste zahlen, wenn ihre Nutzung 100 USD übersteigt. Gutschriften gelten unterschiedslos für alle Zähler. Um spezifische Grenzwerte für Ihre verschiedenen verbrauchsbasierten Produkte festzulegen (z. B. 100 API-Anfragen und 3 GB Speicherplatz), verwenden Sie das Modell mit [pauschaler Transaktionsgebühr und Überschreitungsgebühr](https://docs.stripe.com/billing/subscriptions/usage-based-v1/use-cases/flat-fee-and-overages.md). ## Sie werden Folgendes entwickeln In diesem Leitfaden erstellen Sie das folgende Abo für das fiktive Unternehmen Hypernian, das LLM-Dienste anbietet. Es berechnet Kundinnen und Kunden die folgenden Preise: | Gutschriften | Gebühr | | ------------- | ------ | | Pro Nutzer/in | 10 USD | | Nutzung | Gebühr | | ------------- | ------------------ | | Eingabe-Token | 0.03 USD pro Token | | Ausgabe-Token | 0.05 USD pro Token | ## Zähler erstellen Zähler legen fest, wie Zählerereignisse über einen Rechnungsstellungszeitraum aggregiert werden. Zählerereignisse repräsentieren alle Aktionen, die Kund/innen in Ihrem System ausführen (z. B. API-Anfragen). Zähler sind an Preise gekoppelt und bilden die Grundlage für die Abrechnung. Beim Hypernian-Beispiel sind Zählerereignisse die Anzahl der Input- und Output-Token, die ein/e Kund/in in einer Abfrage verwendet. Der Zählerstand entspricht der Summe der Token über einen Monat. In diesem Beispiel erstellen Sie für jeden Token-Typ einen Zähler. Sie können das Stripe Dashboard oder die API zum [Konfigurieren eines Zählers](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure.md) verwenden. Um die API mit der Stripe CLI zum Erstellen eines Zählers zu verwenden, [starten Sie mit der Stripe CLI](https://docs.stripe.com/stripe-cli.md). #### Dashboard 1. Klicken Sie auf der Seite [Zähler](https://dashboard.stripe.com/test/meters) auf **Zähler erstellen**. 1. Gehen Sie auf der Seite **Zähler erstellen** wie folgt vor: - Geben Sie für **Zählername** den Namen des Zählers ein, der angezeigt wird und für organisatorische Zwecke dient. Für das Hypernian-Beispiel geben Sie „Hypernian-Input-Token“ ein. - Geben Sie für **Ereignisname** den Namen ein, der in Zählerereignissen angezeigt werden soll, wenn die Nutzung an Stripe gemeldet wird. Für das Hypernian-Beispiel geben Sie „hypernian_input_tokens“ ein. - Legen Sie die **Aggregationsmethode** im Dropdown-Menü fest: - Wählen Sie im Hypernian-Beispiel **Summe** aus. Dadurch werden die *gemeldeten Werte addiert* (in diesem Beispiel die Anzahl der von einer Kundin oder einem Kunden verwendeten Token), um die abrechenbare Nutzung zu ermitteln. - Wählen Sie **Anzahl**, um Ereignisse auf Grundlage der gemeldeten *Anzahl* abzurechnen. - Wählen Sie **Zuletzt** für die auf dem *letzten* gemeldeten Wert basierende Rechnung. - Verwenden Sie den Vorschaubereich , um beispielhafte Nutzungsereignisse festzulegen und die Aggregationsmethode zu verifizieren. - Klicken Sie auf **Zähler erstellen**. - Um einen Zähler für Output-Token zu erstellen, wiederholen Sie die vorherigen Schritte und legen Sie den Zählernamen auf „Hypernian-Output-Token“ und den Ereignisnamen auf „hypernian_output_tokens“ fest. - (Optional) Geben Sie unter **Erweiterte Einstellungen** die **Dimensionen** an, mit denen Sie Ihre Nutzungsdaten kennzeichnen möchten. Um granulare, segmentspezifische Warnungen zu generieren oder die Nutzung auf der Grundlage einer Kombination von Attributen zu bewerten, übermitteln Sie Ihre Nutzungsdaten mit Dimensionen, die für Analysen und Berichte ausgefüllt werden. Einige Beispiel-Dimensionen sind LLM-Modell, Token-Typ, Region und Ereignistyp. #### API ```curl curl https://api.stripe.com/v1/billing/meters \ -u "<>:" \ -d "display_name=Hypernian Input tokens" \ -d event_name=hypernian_input_tokens \ -d "default_aggregation[formula]=sum" \ -d "customer_mapping[event_payload_key]=stripe_customer_id" \ -d "customer_mapping[type]=by_id" \ -d "value_settings[event_payload_key]=value" ``` Um einen Zähler für Ausgabe-Token zu erstellen, wiederholen Sie den vorherigen Schritt mit den folgenden Werten. ```curl curl https://api.stripe.com/v1/billing/meters \ -u "<>:" \ -d "display_name=Hypernian Output tokens" \ -d event_name=hypernian_output_tokens \ -d "default_aggregation[formula]=sum" \ -d "customer_mapping[event_payload_key]=stripe_customer_id" \ -d "customer_mapping[type]=by_id" \ -d "value_settings[event_payload_key]=value" ``` ## Preismodell erstellen Verwenden Sie das Stripe-Dashboard oder die API, um ein [Preismodell](https://docs.stripe.com/products-prices/pricing-models.md) zu erstellen, das Ihre [Produkte](https://docs.stripe.com/api/products.md) und deren Preisoptionen umfasst. [Preise](https://docs.stripe.com/api/prices.md) legen die Stückkosten, die Währung und den Rechnungsstellungszeitraum fest. Für das Hypernian-Beispiel erstellen Sie zwei Produkte mit jeweils einem Zähler mit monatlicher Abrechnung. Verwenden Sie den Zähler, den Sie im vorherigen Schritt erstellt haben. #### Dashboard 1. Klicken Sie auf der Seite [Product Catalog](https://dashboard.stripe.com/products?active=true) auf **Produkt erstellen**. 1. Gehen Sie auf der Seite **Produkt hinzufügen** wie folgt vor: - Geben Sie bei **Name** den Namen Ihres Produkts ein. Geben Sie für das Hypernian-Beispiel `Hypernian` ein. - (Optional) Fügen Sie als **Beschreibung** eine Beschreibung hinzu, die im [Bezahlvorgang](https://docs.stripe.com/payments/checkout.md), im [Kundenportal](https://docs.stripe.com/customer-management.md) und in [Angeboten](https://docs.stripe.com/quotes.md) angezeigt wird. - Wählen Sie **Wiederkehrend** aus. - Wählen Sie unter **Rechnungsstellungszeitraum** die Option **Weitere Preisoptionen** aus. 1. Gehen Sie auf der Seite **Preis hinzufügen** wie folgt vor: - Wählen Sie unter **Preismodell auswählen** die Optionen **Nutzungsbasiert** aus. - Wählen Sie Ihre Preisstruktur: - Wählen Sie im Hypernian-Beispiel **Pro Einheit** aus. Legen Sie unter **Preis** den **Betrag** auf `0,03 USD` fest. - Wählen Sie unter **Zähler** das von Ihnen erstellten Zähler aus und wählen Sie Hypernian-Input-Token aus dem Dropdown-Menü. - Wählen Sie unter **Rechnungsstellungszeitraum** die Option **Monatlich** aus. - Wählen Sie unter **Zähler** den von Ihnen erstellten Zähler aus. Wählen Sie im Hypernian-Beispiel **Hypernian-Input-Token** aus dem Dropdown-Menü. - Wählen Sie den entsprechenden **Rechnungsstellungszeitraum** aus. Wählen Sie für das Hypernian-Beispiel **Monatlich**. - Klicken Sie auf **Weiter**. 1. Wiederholen Sie die vorherigen Schritte und erstellen Sie ein Produkt mit der Bezeichnung „Hypernian-Output-Nutzung“ mit einem Preis von `0,05 USD`. Hängen Sie es mit demselben monatlichen Rechnungsstellungszeitraum an den **Hypernian-Output-Token-Zähler** an. #### API Erstellen Sie das Produkt und den Preis für die gestaffelte Preisgestaltung der Eingabe-Nutzung. ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "description=Input usage fee for Hypernian" \ -d "name=Hypernian Input Usage" ``` ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d currency=usd \ -d billing_scheme=per_unit \ -d "recurring[interval]=month" \ -d "recurring[interval_count]=1" \ -d "recurring[usage_type]=metered" \ -d "recurring[meter]={{METER_ID}}" \ -d unit_amount_decimal=3 ``` Erstellen Sie das Produkt und den Preis für die gestaffelte Preisgestaltung der Ausgabe-Nutzung. ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "description=Ouput usage fee for Hypernian" \ -d "name=Hypernian Output Usage" ``` ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d currency=usd \ -d billing_scheme=per_unit \ -d "recurring[interval]=month" \ -d "recurring[interval_count]=1" \ -d "recurring[usage_type]=metered" \ -d "recurring[meter]={{METER_ID}}" \ -d unit_amount_decimal=5 ``` ## Kundin/Kunden erstellen Wenn Ihre Integration [kundenseitig konfigurierte Konten](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) verwendet, ersetzen Sie in den Codebeispielen Verweise auf `Customer` und Ereignisse durch die entsprechenden Verweise auf die Accounts v2 API. Weitere Informationen finden Sie unter [Kundinnen und Kunden mit Kontoobjekten darstellen](https://docs.stripe.com/connect/use-accounts-as-customers.md). Erstellen Sie als Nächstes eine/n *Kunden/Kundin* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments). #### Dashboard 1. Klicken Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) auf **Kund/in hinzufügen**. 1. Gehen Sie auf der Seite **Kunden/Kundin erstellen** wie folgt vor: - Geben Sie für **Name** den Namen Ihres Kunden oder Ihrer Kundin ein. Für das Hypernian-Beispiel geben Sie `Jenny Rosen` ein. - (Optional) Fügen Sie eine E-Mail-Adresse und eine Beschreibung für Ihre/n Kund/in hinzu. - Klicken Sie auf **Kunden/Kundin hinzufügen**. #### API ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=Jenny Rosen" ``` ## Ihrem Kunden/Ihrer Kundin Abrechnungsgutschriften gewähren Verwenden Sie das Stripe-Dashboard oder die API, um eine Gutschriftgewährung für Ihre/n Kund/in zu erstellen. > #### Gutschriften werden am Ende des Abrechnungszeitraums mit zu zahlenden Beträgen verrechnet > > Bei dieser Version der nutzungsbasierten Abrechnung werden Gutschriften verrechnet, wenn die Rechnung am Ende des Abrechnungszeitraums erstellt wird. Mit der [erweiterten nutzungsbasierten Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/compare.md), die sich derzeit in der privaten Vorschau befindet, können Sie die Gewährung von Gutschriften einrichten, die in Echtzeit verrechnet werden. [Registrieren Sie sich](mailto:advanced-ubb-private-preview@stripe.com) für die private Vorschau, um Zugriff zu erhalten und mehr zu erfahren. Abrechnungsgutschriften gelten nur für Posten im [Abo](https://docs.stripe.com/api/invoices/object.md#invoice_object-subscription), die mit einem [Zählerpreis](https://docs.stripe.com/api/prices/object.md#price_object-recurring-meter) verknüpft sind. Die [Usage Records API](https://docs.stripe.com/api/usage_records.md) wird nicht unterstützt. #### Dashboard 1. Wählen Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) den Kundennamen aus. 1. Klicken Sie auf der Kundenseite unter **Gutschriftgewährungen** auf das Plus (**+**). 1. Gehen Sie auf der Seite **Neue Gutschriftgewährung** wie folgt vor: - Geben Sie unter **Name** einen Namen für Ihre Gutschriftgewährung ein. - Geben Sie unter **Betrag** den Betrag der Gutschriftgewährung an. Geben Sie für das Hypernian-Beispiel 10 ein. - (Optional) Geben Sie unter **Datum des Inkrafttretens** das Datum an, an dem die Gutschrift gewährt werden soll. - (Optional) Geben Sie unter **Ablaufdatum** gegebenenfalls das Datum an, an dem die Gutschriften ablaufen. - (Optional) Geben Sie unter **Priorität** die Priorität für diese Gutschriftgewährung an. - (Optional) Geben Sie unter **Anspruch** eine Liste der nutzungsbasierten Preise an, für die diese Gutschrift gewährt wird. - Klicken Sie auf **Gewährung erstellen**. #### API ```curl curl https://api.stripe.com/v1/billing/credit_grants \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "name=Credit grant" \ -d "applicability_config[scope][price_type]=metered" \ -d category=paid \ -d "amount[type]=monetary" \ -d "amount[monetary][value]=1000" \ -d "amount[monetary][currency]=usd" ``` ## Abo erstellen Mit [Abos](https://docs.stripe.com/api/subscriptions.md) können Sie wiederkehrende Beträge berechnen, indem Sie Kund/innen bestimmte Preise zuweisen. Verwenden Sie das Stripe Dashboard oder die API, um ein Abo zu erstellen, das den/die Kund/in, das Produkt und den nutzungsbasierten Preis umfasst. Im Hypernian-Beispiel erstellen Sie ein Abo für die Produkte Hypernian-Input-Token und Hypernian-Output-Token, das monatlich an Jenny Rosen abgerechnet wird. > Sie können einen einzelnen Zählerpreis mit einem oder mehreren Abos verknüpfen. > > Wenn Sie ein `billing_mode=flexible`-Abo erstellen, schließt Stripe nutzungsbasierte Rechnungsposten von der ersten Rechnung aus, da keine vorherige Nutzung zur Abrechnung vorliegt. Stripe erstellt eine Rechnung nur, wenn das Abo mit der zuvor aufgelaufenen Nutzung rückdatiert wird oder ausstehende Rechnungen vorhanden sind. Wenn Sie ein `billing_mode=classic`-Abo erstellen, generiert Stripe für jeden nutzungsbasierten Posten einen Rechnungsposten ohne Geldwert. #### Dashboard 1. Klicken Sie auf der Seite [Abos](https://dashboard.stripe.com/test/subscriptions) auf **Test-Abo erstellen**. 1. Gehen Sie auf der Seite **Testabo erstellen** wie folgt vor: - Wählen Sie unter **Kundin/Kundin** den Namen Ihrer Kundin/Ihres Kunden aus. Wählen Sie im Hypernian-Beispiel **Jenny Rosen**. - Unter **Produkt** wählen Sie Ihre Preise aus. Im Hypernian-Beispiel wählen Sie den Preis unter **Hypernian-Input-Nutzung** und **Hypernian-Output-Nutzung**. - (Optional) Ändern Sie die Abodetails und -einstellungen nach Bedarf. - Klicken Sie auf **Testabo erstellen**. #### API Sie können Ihre Kunden-ID auf der Seite mit den Kundendetails finden. Um Ihre Preis-ID zu finden, gehen Sie auf die Seite mit den jeweiligen Produktdetails und klicken Sie unter **Preisgestaltung** auf das Überlaufmenü (⋯). Wählen Sie **Preis-ID kopieren**. ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "items[0][price]={{INPUT_PRICE_ID}}" \ -d "items[1][price]={{OUTPUT_PRICE_ID}}" ``` ## Test-Zählerereignis senden Verwenden Sie [Zählerereignisse](https://docs.stripe.com/api/billing/meter-event.md) zur [Aufzeichnung der Kundennutzung](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) für Ihren Zähler. Am Ende des Rechnungsstellungszeitraums stellt Stripe die gemeldete Nutzung in Rechnung. Sie können Ihre nutzungsbasierte Abrechnung testen, indem Sie ein Zählerereignis über das Stripe-Dashboard oder die API senden. Wenn Sie die API verwenden, geben Sie die Kunden-ID und den Wert für die `payload` an. Nachdem Sie Zählerereignisse gesendet haben, können Sie die Nutzungsdetails für Ihren Zähler auf der Seite [Zähler](https://dashboard.stripe.com/test/meters) im Dashboard anzeigen. #### Dashboard 1. Wählen Sie auf der Seite [Zähler](https://dashboard.stripe.com/test/meters) den Namen des Zählers aus. Wählen Sie im Hypernian-Beispiel **Hypernian-Input-Token**. 1. Klicken Sie auf der Seite des Zählers auf **Nutzung hinzufügen** > **Nutzung manuell eingeben**. 1. Gehen Sie auf der Seite **Nutzung hinzufügen** wie folgt vor: - Wählen Sie Ihren Kunden/Ihre Kundin aus der Dropdown-Liste **Kunde/Kundin** aus. - Geben Sie für **Wert** einen Beispielwert ein. Geben Sie für das Hypernian-Beispiel `3000` ein. - Klicken Sie auf **Absenden**. #### API ```curl curl https://api.stripe.com/v1/billing/meter_events \ -u "<>:" \ -d event_name=hypernian_input_tokens \ -d "payload[stripe_customer_id]={{CUSTOMER_ID}}" \ -d "payload[value]=3000" ``` ## Erstellen Sie eine Rechnungsvorschau [Erstellen Sie eine Rechnungsvorschau](https://docs.stripe.com/api/invoices/create_preview.md), um eine Vorschau einer Kundenrechnung zu sehen, die Details wie Zählerpreis und Nutzungsmenge enthält. #### Dashboard 1. Wählen Sie auf der Seite [Abonnements](https://dashboard.stripe.com/test/subscriptions) ein Abo aus. Wählen Sie im Hypernian-Beispiel das Abo für **Jenny Rosen**. 1. Scrollen Sie auf der Seite mit den Abonnementdetails nach unten zum Abschnitt **Anstehende Rechnung**. In der Vorschau der Rechnung wird der Abonnementbetrag angezeigt, der dem Kunden/der Kundin zum angegebenen Datum in Rechnung gestellt werden soll. 1. Klicken Sie auf **Vollständige Rechnung anzeigen**, um die vollständigen Details für die anstehende Rechnung anzuzeigen, einschließlich: - Kunde/Kundin - Abrechnungsmethode - Erstellungsdatum - Verbundenes Abo - Abo-Details (Verbrauchsmenge und Zählerpreis) - Fälliger Betrag Stripe verarbeitet Zählerereignisse asynchron, sodass anstehende Rechnungen möglicherweise kürzlich empfangene Zählerereignisse nicht sofort widerspiegeln. #### API ```curl curl https://api.stripe.com/v1/invoices/create_preview \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" ``` ## Abrechnungsgutschriften auf Rechnungen anwenden Nachdem die Rechnung finalisiert wurde, wendet Stripe automatisch alle anwendbaren Abrechnung an. Das verfügbare Guthaben für die Gutschriftgewährung wird basierend auf der Höhe der auf die Rechnung angewendeten Abrechnungsgutschriften aktualisiert. Den Betrag der auf eine Rechnung angewendeten Abrechnungsgutschriften finden Sie im Stripe Dashboard. 1. Wählen Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) den Kundennamen aus. 1. Wählen Sie auf der Kundenseite unter **Rechnungen** eine Rechnung aus. 1. Suchen Sie auf der Rechnungsseite unter **Zwischensumme** die Zeile **Angewendete Gutschriften**. ## Verfügbare Abrechnungsgutschrift abrufen Verwenden Sie das Stripe-Dashboard oder die API, um das verfügbare Abrechnungsguthaben eines Kunden/einer Kundin anzuzeigen. Wenn Sie die API verwenden, rufen Sie den Endpoint [Guthabenübersicht](https://docs.stripe.com/api/billing/credit-balance-summary/retrieve.md) ab. #### Dashboard 1. Wählen Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) den Kundennamen aus. 1. Auf der Kundenseite finden Sie unter **Gutschriftgewährungen** eine Liste der gewährten Gutschriften, die auf Rechnungen angerechnet werden können. Sie können das [available_balance](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-available_balance) der Gutschriftgewährung in der Spalte **Verfügbar** einsehen. #### API ```curl curl -G https://api.stripe.com/v1/billing/credit_balance_summary \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "filter[type]=applicability_scope" \ -d "filter[applicability_scope][price_type]=metered" ``` ## Transaktionen für eine Gutschriftgewährung auflisten Verwenden Sie das Stripe-Dashboard oder die API, um die Transaktionen für eine bestimmte Gutschriftgewährung oder einen bestimmten Kunden/eine bestimmte Kundin anzuzeigen. Rufen Sie bei Verwendung der API den Endpoint [Guthabentransaktion](https://docs.stripe.com/api/billing/credit-balance-transaction/list.md) auf. #### Dashboard 1. Wählen Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) den Kundennamen aus. 1. Wählen Sie auf der Kundenseite unter **Gutschriftgewährungen** eine Gutschriftgewährung aus. 1. Details zu den Guthabentransaktionen anzeigen. #### API ```curl curl -G https://api.stripe.com/v1/billing/credit_balance_transactions \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d credit_grant={{CREDIT_GRANT_ID}} ``` ## Optional: Finanzierung der gewährten Gutschrift Verwenden Sie das Stripe Dashboard oder die API, um eine einmalige [Rechnung](https://docs.stripe.com/invoicing.md) zu erstellen, um Zahlungen von einer Kundin/einem Kunden einzuziehen. Überwachen Sie bei Verwendung der API den `invoice.paid`-[Webhook](https://docs.stripe.com/webhooks.md) und gewähren Sie Ihrer Kundin/Ihrem Kunden Abrechnungsgutschriften. #### Dashboard 1. Wählen Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) den Kundennamen aus. 1. Klicken Sie auf der Kundenseite auf **Rechnung erstellen**. 1. Befolgen Sie die Anweisungen zum [Erstellen einer Rechnung](https://docs.stripe.com/invoicing/dashboard.md). #### API ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "description=credit purchase" \ -d collection_method=charge_automatically ``` ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "description=billing credits purchase" \ -d unit_amount_decimal=1000 \ -d currency=usd \ -d invoice={{INVOICE_ID}} ``` ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" \ -d auto_advance=true ``` ## Optional: Rufen Sie die Nutzung für einen spezifischen Zeitraum ab Verwenden Sie die [Zählerereignisübersicht](https://docs.stripe.com/api/billing/meter-event-summary.md), um die Nutzung für einen benutzerdefinierten Zeitraum abzurufen. Die Zählerereignisübersicht gibt die zusammengefasste Nutzung eines Kunden/einer Kundin für einen Zeitraum zurück, der auf der vom Zähler definierten Aggregationsformel basiert. Im Hypernian-Beispiel gibt die Zählerereignis-Zusammenfassung die Summe der Tokens für eine bestimmte Kundin oder einen bestimmten Kunden, einen bestimmten Zähler und ein bestimmtes Zeitfenster zurück. Da Stripe Zählerereignisse asynchron verarbeitet, spiegeln anstehende Rechnungen möglicherweise kürzlich empfangene Zählerereignisse nicht sofort wider. ```curl curl -G https://api.stripe.com/v1/billing/meters/{{METER_ID}}/event_summaries \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d start_time=1717249380 \ -d end_time=1717249440 ```