Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Basilikum
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Entwickler-Tools
SDKs
API
Tests
Workbench
Ereignisziele
Arbeitsabläufe
Stripe-CLI
Stripe Shell
Entwickler-Dashboard
Agent-Toolkit
Mit LLMs entwickelnStripe für Visual Studio CodeStripe-StatuswarnungenHochgeladene Dateien
Sicherheit und Datenschutz
Sicherheit
Datenschutz
Extend Stripe
Stripe-Apps
Stripe Connectors
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwickler-ToolsChangelogAcacia2024-09-30.acacia

Fügt Unterstützung für das Abrufen von Thin-Ereignissen hinzu

Das ändert sich

Sie können jetzt Thin-Ereignisobjekte für jede Benachrichtigung vom Endpoint /v2/core/events abrufen.

Thin-Ereignisse sind einfache Ereignisse, auf die Sie über die API v2 API zugreifen können. Thin-Ereignisse haben ein detaillierteres Berechtigungsmodell und ihre Nutzlasten enthalten keine API-Versionsdaten. Dies erleichtert die Aktualisierung von Integrationen, die Ereignisse empfangen und mit einem gut typisierten Stripe SDK erstellt wurden. Thin-Ereignisobjekte enthalten die Eigenschaft data, die weitere Informationen über das Ereignis enthalten kann.

Die Meters API ist die erste API, die Thin-Ereignisse verwendet. Derzeit können Sie nur die folgenden Ereignisse v2 im Zusammenhang mit der nutzungsbasierten Abrechnung abrufen:

  • v1.billing.meter.error_report_triggered
  • v1.billing.meter.no_meter_found

Hier finden Sie ein Beispiel für das Ereignis v1.billing.meter.error_report_triggered. Das Feld related_object enthält die id des Objekts, jedoch nicht den Objektdatensatz.

{ "id": "evt_test_65R9Ijk8dKEYZcXeRWn16R9A7j1FSQ3w3TGDPLLGSM4CW0", "object": "v2.core.event", "type": "v1.billing.meter.error_report_triggered", "livemode": false, "created": "2024-09-17T06:20:52.246Z", "related_object": { "id": "mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW", "type": "billing.meter", "url": "/v1/billing/meters/mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW" } }

Weitere Informationen zu Ereignissen.

Auswirkungen

Thin-Ereignisse haben mehrere Vorteile. Sie erleichtern die Pflege zukünftiger Webhook-Integrationen, da die Nutzlasten nicht in Versionen vorliegen. Sie können Thin-Ereignisse an Ereignisziele senden. Thin-Ereignisse werden vollständig in die SDKs für API v2 eingegeben. Wenn Ihre Anwendung ein entsprechendes API-Objekt benötigt, das sich auf ein Ereignis bezieht (zum Beispiel das Zählerobjekt), müssen Sie die Stripe-API für den neuesten Status des Objekts aufrufen. Dies trägt dazu bei, Anwendungsfehler zu vermeiden, die durch veraltete Objektdaten verursacht werden (zum Beispiel Racebedingungen). Die SDKs für API v2 enthalten Hilfsmethoden, mit denen Sie Datensätze abrufen können, die einem Ereignis zugeordnet sind.

Änderungen

ÄndernRessource
Hinzugefügt
V2.Event
Endpoints ÄndernRessource
retrievelistHinzugefügt
V2.Event

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2024-09-30.acacia
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc