Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden

Migration zu Abrechnungszählern

So migrieren Sie von Nutzungsdaten zu Abrechnungszählern.

Stripe stellt die Abrechnung mit Nutzungsdatensätzen ein. In Zukunft können Sie zu Abrechnungszählern wechseln, unserer einzigen Lösung für die nutzungsbasierte Abrechnung. Abrechnungszähler bieten folgende Vorteile:

  • Nutzungsberichterstattung mit hohem Durchsatz
  • Eine einstündige Berichtsfrist für die Erstellung von Rechnungen
  • Collect usage before creating a subscription

Die folgenden Funktionen werden jedoch nicht unterstützt:

  • max, last_ever und last_during_period Aggregation
  • Nutzungsdaten im Dashboard melden

Sie können während dem Umstieg auf Abrechnungszähler weiterhin Nutzungsdaten verwenden.

Übersicht über Abrechnungszähler

Mit Abrechnungszählern können Sie die Nutzung eines bestimmten Ereignisses verfolgen. Es unterstützt die Eingabe und Aggregation von Ereignissen mit hohem Durchsatz.

Im Gegensatz zu Nutzungsdaten müssen Kundinnen/Kunden bei Abrechnungszählern keine Abonnements haben, bevor sie die Nutzung melden können. Ein Zähler kann die Nutzung mehrere Kundinnen/Kunden messen.

Weitere Infos zu Abrechnungszählern finden Sie in unserem Implementierungsleitfaden.

Zähler erstellen

Create a billing meter. Learn more about configuring meters.

Command Line
curl https://api.stripe.com/v1/billing/meters \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d display_name="Alpaca AI" \
  -d event_name=api_request \
  -d "default_aggregation[formula]"=sum

Neuen Preis erstellen

Erstellen Sie einen neuen Preis für den Abrechnungszähler. Stellen Sie sicher, dass der neue Preis für dasselbe Produkt gilt wie Ihr alter Preis.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d product={{PRODUCT_ID}} \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d "recurring[meter]"={{METER_ID}} \
  -d currency=usd \
  -d unit_amount=100

Aufzeichnung der Nutzung starten

Notiz

Sie müssen weiterhin Nutzungsdaten an Stripe senden, bis die Migration abgeschlossen ist.

Melden Sie die Nutzungsdaten mit der Billing Meter API. Stripe zeigt diese Nutzung erst dann auf Kundenrechnungen wider, wenn der neue Preis abonniert wurde.

Command Line
curl https://api.stripe.com/v1/billing/meter_events \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d event_name=api_request \
  -d timestamp=1712096183 \
  -d identifier={{IDEMPOTENCY_KEY}} \
  -d "payload[stripe_customer_id]"={{CUSTOMER_ID}} \
  -d "payload[value]"=1

Learn more about recording usage.

Abonnementpläne planen

Verwenden Sie Abonnementpläne, um am Ende eines Abrechnungszyklus automatisch eine Migration auf den neuen Preis vorzunehmen. Weitere Informationen zu Abonnementplänen.

Listen Sie die mit dem alten Preis verknüpften Abonnements auf.

Command Line
curl -G https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d price={{OLD_PRICE_ID}} \
  -d "expand[]"="data.schedule"

Stripe gibt eine Liste von Abonnements zurück, die mit dem alten Preis verknüpft sind. Beispiel:

{
  "object": "list",
  "data": [
    {
      "id": 
"sub_1P1Y6gDxxK6kAaV0rS7ojBjh"
,
      "object": "subscription",
      ...
      "items": {
        "object": "list",
        "data": [
          {
            "id": 
"si_PrGdqMmuM1DGbQ"
,
            "object": "subscription_item",
            ...
            "price": {
              "id": "{{OLD_PRICE_ID}}",
              "object": "price",
              ...
              "recurring": {
                "aggregate_usage": "sum",
                "interval": "month",
                "interval_count": 1,
                "trial_period_days": null,
                "usage_type": "metered"
              },
              ...
            },
            ...
          }
        ],
        ...
      },
      ...
      "schedule": {
        "id": 
"sub_sched_1P1XxjDxxK6kAaV0YygN4tf7"
,
        "object": "subscription_schedule",
        ...
        "current_phase": {
          "end_date": 1714759200,
          "start_date": 1712167200
        },
        ...
        "phases": [
          {
            ...
            "end_date": 1714759200,
            ...
            "items": [
              {
                ...
                "price": "{{OLD_PRICE_ID}}",
                ...
              }
            ],
            ...
            "start_date": 1712167200,
            ...
            "trial_end": 1712772000
          }
        ],
        ...
      },
      ...
    },
    ...
  ],
  "has_more": false,
  "url": "/v1/subscriptions"
}

Wenn ein Abonnement einen Zeitplan hat, müssen Sie den vorhandenen Abonnementplan aktualisieren, um am Ende eines Abrechnungszyklus die Migration zu dem neuen Preis vorzunehmen. Wenn kein Zeitplan für ein Abonnement vorhanden ist, erstellen Sie einen.

Erstellen Sie einen Abonnementplan für jedes Abonnement, das mit dem alten Preis verknüpft ist.

Command Line
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d from_subscription=
{{SUBSCRIPTION_ID}}

Stripe gibt ein neues Abonnementplan-Objekt zurück:

{
  "id": 
"sub_sched_1P1H37DxxK6kAaV0Iggc537m"
,
  "object": "subscription_schedule",
  ...
  "current_phase": {
    "end_date": 1714693634,
    "start_date": 1712101634
  },
  ...
  "phases": [
    {
      ...
      "end_date": 1714693634,
      ...
      "items": [
        {
          ...
          "price": "{{OLD_PRICE_ID}}",
          ...
        }
      ],
      ...
      "start_date": 1712101634,
      ...
    }
  ],
  ...
  "status": "active",
  ...
}

Aktualisieren Sie den Abonnementzeitplan, um eine phase mit dem neuen Preis hinzuzufügen.

Command Line
curl https://api.stripe.com/v1/subscription_schedules/sub_sched_1P1H37DxxK6kAaV0Iggc537m \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "phases[0][start_date]"=1712101634 \
  -d "phases[0][end_date]"=1714693634 \
  -d "phases[0][items][0][price]"={{OLD_PRICE_ID}} \
  -d "phases[1][items][0][price]"={{NEW_PRICE_ID}}

Migration testen

Erstellen Sie eine Testkundin/einen Testkunden mit einem Abonnement, das dem alten Preis zugeordnet ist.

  1. Rufen Sie die Registerkarte Kundinnen/Kunden auf.
  2. Klicken Sie auf + Kundin/Kunden hinzufügen.
  3. Geben Sie den Namen der Kundin/des Kunden ein.
  4. Navigieren Sie zu der neuen Kundin/dem neuen Kunden.
  5. Klicken Sie neben der Kopfzeile mit den Abonnements auf +, um die Abonnementschublade zu öffnen.
  6. Wählen Sie den alten Preis.
  7. Klicken Sie auf Testabonnement erstellen.

Erstellen Sie einen Abonnementplan für dieses Abonnement.

Command Line
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d from_subscription=
{{SUBSCRIPTION_ID}}

Fügen Sie dem Abonnementplan eine phase hinzu, um auf den neuen Preis umzustellen.

Command Line
curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "phases[0][start_date]"=1710952582 \
  -d "phases[0][end_date]"=1713630982 \
  -d "phases[0][items][0][price]"={{OLD_PRICE_ID}} \
  -d "phases[1][items][0][price]"={{NEW_PRICE_ID}}

Simulieren Sie den Abonnementwechsel mit einer Test-Uhr.

Erfahren Sie mehr über das Testen von Abonnementintegrationen. Mithilfe von Test-Uhren können Sie verschiedene Szenarien testen und so auch die Nutzungsberichte simulieren. Mehr erfahren über Test-Uhren.

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc