Legen Sie eine Stripe API-Version fest

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

Ihr Konto hat eine Standard-API-Version, die definiert, wie Sie die API aufrufen, auf welche Funktionen Sie Zugriff haben und was Sie garantiert als Teil der Antwort zurückbekommen. Webhook-Ereignisobjekte basieren auf Ihrer Standard-API-Version, die sich von der im SDK verwendeten API-Version unterscheiden kann. Um sicherzustellen, dass diese Versionen übereinstimmen, empfehlen wir Ihnen die Registrierung eines Webhook-Endpoints mit der gleichen API-Version wie das SDK. Ihre Version finden Sie unter Von API-Anfragen verwendete API-Versionen anzeigen.

Grundlagen der Versionierung

Wählen Sie Ihre SDK-Sprache, um loszulegen. Wenn Sie curl oder die Stripe-CLI anstelle eines SDK verwenden, finden Sie weitere Informationen auf unserer Versionierungsseite.

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-05-28.basil'

Oder legen Sie die Version anfragebasiert fest:

require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
  'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
  {
    stripe_version: '2025-05-28.basil',
  }
)
intent.capture

Notiz

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 aktuelle Version des Ruby SDK zu verwenden, und legen Sie die neue API-Version fest, wenn Sie Ihre Aufrufe tätigen.

Siehe auch

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

Stripe-Versionsverwaltung und Support-Richtlinien