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

Hinweis

Bis jetzt ist diese Seite noch nicht in dieser Sprache verfügbar. Wir arbeiten aber verstärkt daran, unsere Dokumentation in weiteren Sprachen bereitzustellen, und werden die Übersetzung sofort anzeigen, sobald diese verfügbar ist.

Entfernt den Parameter für Iterationen für AbonnementpläneWichtige Änderungen

Das ändert sich

Wir haben den Parameter iterations entfernt, da duration seine Funktionalität ersetzt.

Warum ist dies eine wichtige Änderung?

Wir unterstützen nicht länger den Parameter Iterationen fürAbonnement-Zeitpläne.

Auswirkungen

Sie müssen Ihre Integration aktualisieren, um duration für die Bestimmung der Länge einer Abonnementplan-Phase in den folgenden API-Endpoints zu verwenden:

Die Verwendung von iterations in diesen Endpoints gibt jetzt einen Fehler zurück.

Vorher
Nachher
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
:" \
  -H "Stripe-Version: 2025-08-27.basil" \
  -d customer={{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]"={{PRICE_PREMIUM} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][iterations]"=3 \
  -d end_behavior=release
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 customer={{CUSTOMER_ID}} \
  -d start_date=now \
  -d "phases[0][items][0][price]"={{PRICE_PREMIUM} \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][duration][interval]"=month \
  -d "phases[0][duration][interval_count]"=3 \
  -d end_behavior=release

Änderungen

ParameterÄndernRessourcen oder Endpoints
iterationsEntfernt
Invoice#create_preview.schedule_details.phases[]SubscriptionSchedule#create.phases[]SubscriptionSchedule#update.phases[]

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-09-30.clover
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

Zugehörige Änderungen