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.

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.

Siehe auch

Umgang mit der Webhook-Versionierung