# Legen Sie eine Stripe API-Version fest Befolgen Sie diese Richtlinien, um eine andere API-Version als die von Ihren SDKs genutzte zu verwenden. Ihr Konto verfügt über eine [Standard-API-Version](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api), die definiert, wie Sie die API aufrufen, auf welche Funktionalität Sie Zugriff haben und was Sie garantiert als Teil der Antwort zurückerhalten. Wenn Sie jedoch unsere [serverseitigen SDKs](https://docs.stripe.com/sdks.md#server-side-libraries) verwenden, nutzen Ihre API-Aufrufe an Stripe die API-Version, die zum Zeitpunkt der Veröffentlichung des SDK aktuell war. Sie können keine andere Version vorgeben, wenn Sie eine stark typisierte Sprache wie Java, Go oder .NET verwenden. #### Ruby ### Einstellen der API-Version Mit der Stripe-Ruby-Bibliothek können Sie die API-Version global oder auf Anfragebasis festlegen. Wenn Sie keine API-Version festlegen, verwenden neuere Versionen von stripe-ruby die API-Version, die zum Zeitpunkt der Veröffentlichung Ihrer Version von stripe-ruby aktuell war. Versionen von stripe-ruby vor [v9](https://github.com/stripe/stripe-ruby/blob/master/CHANGELOG.md#900---2023-08-16) verwenden die Standard-API-Version Ihres Kontos. Um die API-Version **global** mit dem SDK festzulegen, weisen Sie der Eigenschaft `Stripe.api_version` die Version zu: ```ruby require 'stripe' client = Stripe::StripeClient.new('<>', stripe_version: '2026-03-25.dahlia') ``` Oder legen Sie die Version anfragebasiert fest: ```ruby require 'stripe' client = Stripe::StripeClient.new('<>') intent = client.v1.payment_intents.retrieve( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', { stripe_version: '2026-03-25.dahlia', }, ) intent.capture ``` > Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben. #### Python ### Einstellen der API-Version Mit der Stripe-Python-Bibliothek können Sie die API-Version global oder auf Anfragebasis festlegen. Wenn Sie keine API-Version festlegen, verwenden neuere Versionen von stripe-python die API-Version, die zum Zeitpunkt der Veröffentlichung Ihrer Version von stripe-python aktuell war. Versionen von stripe-python vor [v6](https://github.com/stripe/stripe-python/blob/master/CHANGELOG.md#600---2023-08-16) verwenden die Standard-API-Version Ihres Kontos. Um die API-Version **global** mit dem SDK festzulegen, weisen Sie der Eigenschaft `stripe.api_version` die Version zu: ```python import stripe stripe.api_key = <> stripe.api_version = '2026-03-25.dahlia' ``` Oder legen Sie die Version anfragebasiert fest: ```python import stripe intent = stripe.PaymentIntent.retrieve( "pi_1DlIVK2eZvKYlo2CW4yj5l2C", stripe_version="2026-03-25.dahlia", ) intent.capture() ``` > Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben. #### PHP ### Einstellen der API-Version Mit der Stripe-PHP-Bibliothek können Sie die API-Version global oder auf Anfragebasis festlegen. Wenn Sie keine API-Version festlegen, verwenden neuere Versionen von stripe-php die API-Version, die zum Zeitpunkt der Veröffentlichung Ihrer Version von stripe-php aktuell war. Versionen von stripe-php vor [v11](https://github.com/stripe/stripe-php/blob/master/CHANGELOG.md#1100---2023-08-16) verwenden die Standard-API-Version Ihres Kontos. Um die API-Version **global** mit dem SDK festzulegen, übergeben Sie die Version an die Methode `\Stripe\Stripe::setApiVersion()`: ```php $stripe = new \Stripe\StripeClient([ "api_key" => "<>", "stripe_version" => "2026-03-25.dahlia" ]); ``` Oder legen Sie die Version anfragebasiert fest: ```php $intent = $stripe->paymentIntents->capture( 'pi_1DlIVK2eZvKYlo2CW4yj5l2C', [], ['stripe_version' => '2026-03-25.dahlia'] ); ``` > Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben. #### Java ### Einstellen der API-Version Da Java eine stark typisierte Programmiersprache ist, ist die im SDK verwendete API-Version *nicht veränderbar*. Es wird immer die API-Version verwendet, die zum Zeitpunkt der Veröffentlichung des SDKs aktuell ist. Wir empfehlen, keine andere API-Version für stark typisierte Programmiersprachen festzulegen, da die Antwortobjekte möglicherweise nicht mit den starken Typen im SDK übereinstimmen und zu Anfragefehlern führen können. Wenn beispielsweise die von Ihnen genutzte API-Version Parameter erfordert, die in den SDK-Typen nicht vorhanden sind, schlägt die Anfrage fehl. #### Node ### Einstellen der API-Version Mit der Stripe-Node-Bibliothek können Sie die API-Version global oder auf Anfragebasis festlegen. Wenn Sie keine API-Version festlegen, verwenden neuere Versionen von stripe-node die API-Version, die zum Zeitpunkt der Veröffentlichung Ihrer Version von stripe-node aktuell war. Versionen von stripe-node vor [v12](https://github.com/stripe/stripe-node/blob/master/CHANGELOG.md#1200---2023-04-06) verwenden die Standard-API-Version Ihres Kontos. Um die API-Version **global** mit dem SDK festzulegen, geben Sie die `apiVersion` an: ```javascript const stripe = require('stripe')('<>', { apiVersion: '2026-03-25.dahlia', }); ``` Oder legen Sie die Version anfragebasiert fest: ```javascript const intent = await stripe.paymentIntents.retrieve('pi_1DlIVK2eZvKYlo2CW4yj5l2C', { apiVersion: '2026-03-25.dahlia', }); ``` #### Nutzung von Typescript Die TypeScript-Typen entsprechen der zum Zeitpunkt der Veröffentlichung aktuellen API-Version. Diese Version ist in der [API_VERSION-Datei](https://github.com/stripe/stripe-node/blob/master/API_VERSION) kodiert. Importieren Sie Stripe als Standardimport und instanziieren Sie es als `new Stripe()` mit der neuesten API-Version. ```javascript import Stripe from 'stripe'; const stripe = new Stripe('<>', { apiVersion: '2026-03-25.dahlia' }); ``` #### Go ### Einstellen der API-Version Da Go eine stark typisierte Programmiersprache ist, ist die im SDK verwendete API-Version *nicht veränderbar*. Es wird immer die API-Version verwendet, die zum Zeitpunkt der Veröffentlichung des SDKs aktuell ist. Wir empfehlen, keine andere API-Version für stark typisierte Programmiersprachen festzulegen, da die Antwortobjekte möglicherweise nicht mit den starken Typen im SDK übereinstimmen und zu Anfragefehlern führen können. Wenn beispielsweise die von Ihnen genutzte API-Version Parameter erfordert, die in den SDK-Typen nicht vorhanden sind, schlägt die Anfrage fehl. #### .NET ### Einstellen der API-Version Da C\# eine stark typisierte Programmiersprache ist, ist die im .NET SDK verwendete API-Version *nicht veränderbar*. Es wird immer die API-Version verwendet, die zum Zeitpunkt der Veröffentlichung des SDKs aktuell ist. Wir empfehlen, keine andere API-Version für stark typisierte Programmiersprachen festzulegen, da die Antwortobjekte möglicherweise nicht mit den starken Typen im SDK übereinstimmen und zu Anfragefehlern führen können. Wenn beispielsweise die von Ihnen genutzte API-Version Parameter erfordert, die in den SDK-Typen nicht vorhanden sind, schlägt die Anfrage fehl. #### cURL ```sh curl https://api.stripe.com/v1/charges \ -u <>: \ -H "Stripe-Version: 2026-03-25.dahlia" ``` #### Stripe-CLI ```sh stripe charges create --stripe-version 2026-03-25.dahlia ``` ### Ihre API-Version aktualisieren Vor einem Upgrade [Ihrer API-Version](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api) sollten Sie die folgenden Ressourcen beachten: - [Stripe-API-Änderungsprotokoll](https://docs.stripe.com/changelog.md) - [Von API-Anfragen verwendete API-Versionen anzeigen](https://docs.stripe.com/workbench/guides.md#view-api-versions) Sie können die Standard-API-Version Ihres Kontos in [Workbench](https://dashboard.stripe.com/workbench/overview) aktualisieren. Aktualisieren Sie Ihren Code, um die neueste Version des SDK zu verwenden, und legen Sie beim Tätigen Ihrer Aufrufe die neue API-Version fest. ## See also Stripe SDKs befolgen ihre eigenen Versionsrichtlinien. Unter folgendem Link erfahren Sie mehr. - [Stripe-Versionsverwaltung und Support-Richtlinien](https://docs.stripe.com/sdks/versioning.md)