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

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, 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 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.

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 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:

require 'stripe'
Stripe.api_key = 
sk_test_BQokikJOvBiI2HlWgH4olfQ2

Stripe.api_version = '2025-11-17.clover'

Oder legen Sie die Version anfragebasiert fest:

require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
  'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
  {
    stripe_version: '2025-11-17.clover',
  }
)
intent.capture

Hinweis

Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben.

Ihre API-Version aktualisieren

Vor einem Upgrade Ihrer API-Version sollten Sie die folgenden Ressourcen beachten:

Sie können die Standard-API-Version Ihres Kontos in Workbench 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.

Siehe auch

Stripe SDKs befolgen ihre eigenen Versionsrichtlinien. Unter folgendem Link erfahren Sie mehr.