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.
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_4eC39HqLyjWDarjtT1zdp7dc
Stripe.api_version = '2024-11-20.acacia'
Oder legen Sie die Version anfragebasiert fest:
require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
{
stripe_version: '2024-11-20.acacia',
}
)
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.