Legen Sie eine Stripe API-Version fest

Befolgen Sie diese Richtlinien, um sicherzustellen, dass die API-Versionen in Ihrer gesamten Stripe-Integration übereinstimmen.

Your account has a default API version, which defines how you call the API, what functionality you have access to, and what you’re guaranteed to get back as part of the response. However, when using our server-side SDKs, your API calls to Stripe use the API version that was current when the SDK was released. You can’t target a different version when using a strongly typed language such as Java, Go, or .NET.

To set an API version when using curl or Stripe CLI instead of an SDK, refer to our versioning page.

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-10-29.clover'

Oder legen Sie die Version anfragebasiert fest:

require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
  'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
  {
    stripe_version: '2025-10-29.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:

You can upgrade your account’s default API version in Workbench. Update your code to use the latest version of the SDK and set the new API version when making your calls.

Siehe auch

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

Stripe-Versionsverwaltung und Support-Richtlinien