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:

Die folgende Funktion wird jedoch nicht unterstützt:

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

Erstellen Sie einen Abrechnungszähler. Erfahren Sie mehr über die Konfiguration von Zählern.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/billing/meters \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/billing/meter_events \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d event_name=api_request \
  -d timestamp=1712096183 \
  -d identifier={{IDEMPOTENCY_KEY}} \
  -d "payload[stripe_customer_id]"={{CUSTOMER_ID}} \
  -d "payload[value]"=1

Erfahren Sie mehr über die Aufzeichnung der Nutzung.

OptionalAbfrage der gemeldeten Nutzung

Mit der Übersicht für Zählerereignisse können Sie die Nutzung für einen bestimmten Zeitraum abrufen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/billing/meters/{{METER_ID}}/event_summaries \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d start_time=1717249380 \
  -d end_time=1717249440

Abonnementpläne planen

Verwenden Sie Abonnementpläne, um automatisch am Ende des Rechnungsstellungszeitraums auf den neuen Preis zu wechseln. Weitere Informationen zu Abonnementplänen finden Sie unter Abonnementpläne.

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 über einen Zeitplan verfügt, müssen Sie den bestehenden Abonnementplan aktualisieren, um am Ende eines Rechnungsstellungszeitraums auf den neuen Preis zu wechseln. Wenn kein Plan für ein Abo existiert, erstellen Sie einen neuen.

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules/sub_sched_1P1H37DxxK6kAaV0Iggc537m \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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. Gehen Sie auf die Registerkarte Customers tab.
  2. Klicken Sie auf + Kundin/Kunden hinzufügen.
  3. Geben Sie den Namen der Kundin/des Kunden ein.
  4. Gehen Sie zu der neuen Kundin oder 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d from_subscription=
{{SUBSCRIPTION_ID}}

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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