Stripe-Versionsverwaltung und Support-Richtlinie

Erfahren Sie mehr über die Versionsverwaltung und die Support-Richtlinie von Stripe.

Stripe API-Versionen

Ab der Version 2024-09-30.acacia folgt Stripe einem neuen API-Veröffentlichungsprozess, bei dem wir monatlich neue API-Versionen ohne Änderungen freigeben. Zweimal im Jahr veröffentlichen wir eine neue Version (zum Beispiel acacia), die mit einer API-Version beginnt, die wichtige Änderungen enthält.

Sie können mit jeder monatlichen API-Version neue Nebenversionen der SDKs und mit jeder der zweimal jährlich erscheinenden Hauptversionen neue Hauptversionen der SDKs erwarten.

Manchmal sehen Sie ein größeres Versionsupdate für die SDKs mit den monatlichen API-Versionsupdates, wenn die SDKs wichtige Änderungen für den Versand enthalten.

Was Sie von einer neuen API-Version erwarten können, erfahren Sie unter API-Upgrades.

Stripe SDK-Versionen

Die SDK-Versionierungsrichtlinie von Stripe basiert auf dem semantischen Versionierungsstandard. In Version 4.3.2 steht beispielsweise 4 für major, 3 für minor und 2 für patch. Wenn wir eine neue SDK-Version mit neuen Funktionen oder Fehlerbehebungen veröffentlichen, wird je nach Art der eingeführten Änderung eine dieser drei Versionskomponenten inkrementiert.

Major. Wir erweitern die Versionskomponente major, wenn die Version bahnbrechende Änderungen enthält, die mit der letzten Version nicht abwärtskompatibel sind: um einen erforderlichen Parameter hinzuzufügen, ändern Sie einen Typ, eine Eigenschaft, eine Methode oder einen Parameter. Zum Beispiel das Umbenennen der Ausnahmeklassen des SDK.
Minor. Wir erweitern die Versionskomponente minor, wenn die Version neue Funktionen enthält, die mit der neuesten Version abwärtskompatibel sind: um einen neuen Typ, eine neue Eigenschaft, eine neue Methode, einen neuen optionalen Parameter oder einen unterstützten Parameterwert hinzuzufügen. Zum Beispiel die Erläuterung der Meldung zum Löschen der Metadaten des SDK.
** Patch**. Wir erweitern die Versionskomponente patch, wenn die Version abwärtskompatible Fehlerbehebungen enthält: um ein Verhalten zu ändern, wenn durch die Korrektur dieses Verhaltens keine dokumentierten Typen, Eigenschaften, Methoden oder Parameter geändert werden. Zum Beispiel die Behebung eines Fehlers, bei dem Datei-Uploads nicht korrekt aufgelistet wurden.

Jede SDK-Version verwendet die API-Version, die zum Zeitpunkt ihrer Veröffentlichung aktuell ist, um API-Anfragen zu stellen. Auf der Seite Versioning erfahren Sie, wie Sie dies überschreiben können.

Support-Richtlinie für das Stripe SDK

Neue Funktionen und Fehlerbehebungen werden in der neuesten Hauptversion des SDK veröffentlicht. Wenn Sie eine ältere major SDK-Version verwenden, empfehlen wir ein Upgrade auf die neueste Hauptversion, um diese Funktionen und Fehlerbehebungen zu nutzen. Ältere Hauptversionen des Pakets können weiterhin verwendet werden, erhalten jedoch keine zusätzlichen Updates.

Migrationsleitfäden

Wir stellen Ihnen Migrationsanleitungen zur Verfügung, die Ihnen beim Upgrade von älteren SDK-Versionen helfen. Sie finden sie im Wiki-Bereich unserer SDK-GitHub-Repositorys. In demselben Wiki finden Sie auch die Zuordnung der SDK-Hauptversionen zu den API-Versionen.

Richtlinie zur Unterstützung von Stripe-SDK-Sprachversionen

Um eine bessere Planbarkeit zu gewährleisten, werden wir ab September 2025 Angaben dazu machen, wie lange wir jede Sprachversion unterstützen und alle bevorstehenden Support-Einstellungen im Voraus ankündigen.

Sobald Versionen einer Sprache das End-of-Life erreichen, werden wir die Unterstützung dieser Versionen im entsprechenden SDK schrittweise einstellen. Bereits veröffentlichte SDK-Versionen funktionieren weiterhin wie gewohnt, aber Sie müssen Ihre Runtime aktualisieren, um die neueste SDK-Version zu verwenden.

Sobald eine Sprachversion ihr End-of-Life erreicht, kennzeichnen wir sie in den unten stehenden Tabellen als „veraltet” und es beginnt ihr „erweitertes Supportfenster“. Während dieses Zeitraums testen wir das SDK weiterhin mit dieser Version und stellen sicher, dass alle unsere Abhängigkeiten weiterhin funktionieren. Die genaue Länge des erweiterten Supportfensters variiert je nach Sprache, liegt aber immer zwischen 1 und 2 Jahren.

Nach Ablauf des erweiterten Supportzeitraums für eine Version stellt das SDK die Unterstützung im Rahmen der nächsten geplanten Hauptversion ein. Wir werden alle Laufzeitverwerfungen im Voraus auf dieser Seite, in der README-Datei des jeweiligen SDKs und im Changelog der jeweiligen Sprache ankündigen.

Auch wenn ein SDK möglicherweise weiterhin mit einer nicht unterstützten Sprachversion funktioniert, sollten Sie es nicht weiterverwenden. SDKs, die auf nicht unterstützten Versionen ausgeführt werden, können in beliebigen Releases unerwartet ausfallen und die Ursache für diesen Ausfall wird unter Umständen nicht im Changelog aufgeführt.

Sprachpolitik

Wir unterstützen Python 3.7+. Dies umfasst alle Python-Versionen, die derzeit Sicherheitsunterstützung erhalten, sowie solche, die sich im erweiterten Support-Fenster befinden.

Python-Versionen, die ihr End-of-Life-Datum erreicht haben, erhalten ein erweitertes Support-Fenster von 1 Jahr (zwei Haupt-API-Releases). Wir stellen die Unterstützung für die älteste unterstützte Python-Version jeweils mit dem März-API-Release eines Jahres ein.

Zeitplan für die Einstellung

Python-Version	Status	End of Life	Support eingestellt	Letztes kompatibles SDK	Bemerkungen
3,10	unterstützt	Oktober 2026	März 2028	Folgt
3,9	unterstützt	Oktober 2025	März 2027	Folgt
3,8	veraltet	Oktober 2024:	2026. März	Folgt	Version 3.8 ist die erste Version, die gemäß dem in dieser Richtlinie definierten Zeitplan die Unterstützung verliert.
3,7	veraltet	Juni 2023	2026. März	Folgt	Um den Übergang zu dieser Richtlinie zu erleichtern, verlängern wir das Supportfenster für Version 3.7, damit Nutzer/innen mehr Zeit haben, ihre Integrationen zu aktualisieren.
3,6	nicht unterstützt	Dezember 2021	September 2025	`v12.5.1`	Die Entscheidung, Version 3.6 einzustellen, liegt vor dieser Richtlinie und folgt daher nicht dem oben beschriebenen Muster.

Freigabekanal für die öffentliche Vorschau

Wir haben einen Freigabekanal für die öffentliche Vorschau, der Vorschau-API-Versionen verwendet, die sich von den allgemeinen Verfügbarkeitsversionen unterscheiden. Zum Beispiel 2025-04-30.preview anstelle von 2025-04-30.basil.

Um auf die neuen Funktionen und Verbesserungen in der Vorschau-Phase zuzugreifen, verwenden Sie Versionen unserer SDKs mit dem Suffix beta oder b. Zum Beispiel 5.1.0b3 in Python und 5.1.0-beta.3 in anderen Sprach-SDKs.

Installationsanweisungen und Details zur Übergabe von Preview-Headern im Stripe-Version-Header finden Sie im Abschnitt Public Preview SDKs in den README-Dateien in den jeweiligen SDK-GitHub-Repositorys.

Freigabekanal für die private Vorschau

Wir veröffentlichen auch Funktionen in der Phase der privaten Vorschau, die einen rein Einladungs-basierten Zugriff erfordern. Diese Funktionen verwenden auch die Vorschau-API-Versionen.

Verwenden Sie Versionen unserer SDKs, die über das Suffix alpha oder a Suffix verfügen, um nach Einladung auf Funktionen und Erweiterungen der privaten Vorschau zuzugreifen. Beispiel: 5.1.0a3 in Python und 5.1.0-alpha.3 in SKDs in anderen Sprachen.

Installationsanweisungen und Details zur Übergabe von Vorschau-Headern im Stripe-Version-Header finden Sie im Abschnitt Private Vorschau-SDKs in den README-Dateien in den jeweiligen SDK-GitHub-Repositorys.

Siehe auch

Umgang mit der Webhook-Versionierung