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 verfügt über eine Standard-API-Version, die festlegt, wie Sie die API aufrufen, auf welche Funktionen Sie Zugriff haben und was Sie als Teil der Antwort garantiert zurückerhalten. Webhook-Ereignisobjekte basieren auf Ihrer Standard-API-Version, die sich von der vom SDK verwendeten API-Version unterscheiden kann. Um sicherzustellen, dass diese Versionen übereinstimmen, empfehlen wir, einen Webhook-Endpoint mit derselben API-Version zu registrieren, die vom SDK verwendet wird. Ihre Version finden Sie unter Standard-API-Version anzeigen.
Grundlagen der Versionierung
Wir haben einige grundlegende Konzepte behandelt, die Sie über in SDKs verwendete API-Versionen wissen müssen. Wählen Sie Ihre SDK-Sprache, um zu beginnen.
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-04-10'
Oder legen Sie die Version anfragebasiert fest:
require 'stripe'
intent = Stripe::PaymentIntent.retrieve(
'pi_1DlIVK2eZvKYlo2CW4yj5l2C',
{
stripe_version: '2024-04-10',
}
)
intent.capture
Notiz
Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben.
Aktualisieren Ihrer API-Version
Bevor Sie Ihre API-Version aktualisieren, lesen Sie die folgenden Ressourcen sorgfältig:
Sie können die Standard-API-Version Ihres Kontos im Entwickler- Dashboard aktualisieren. Aktualisieren Sie Ihren Code, um die neueste Version des Ruby SDK zu verwenden, und legen Sie bei Ihren Aufrufen die neue API-Version fest.
Siehe auch
Stripe SDKs befolgen ihre eigenen Versionsrichtlinien. Unter folgendem Link erfahren Sie mehr.