Fehlgeschlagene Webhook-Ereignisgenerierung verarbeitenÖffentliche Vorschau

Erfahren Sie, wie Sie mit Webhooks umgehen, die nicht generiert werden können.

In sehr seltenen Fällen kann die Erzeugung des Event-Objekts durch Stripe fehlschlagen. In diesen Fällen ist das Ereignis nicht wiederherstellbar. Stripe kann es weder an Ihre Ereignisziele liefern noch im Dashboard oder in der List Events API veröffentlichen. Stattdessen erstellt Stripe ein v2.core.health.event_generation_failure.resolved-Ereignis, um Ihnen mitzuteilen, dass die Event-Erzeugung fehlgeschlagen ist. Dieser Leitfaden erklärt, wie die Warnung funktioniert und was Sie tun können, um das Problem zu beheben.

Zustellung fehlgeschlagener Ereignisse

Stripe liefert v2.core.health.event_generation_failure.resolved-Ereignisse sowohl an Workbench als auch an alle Webhook-Endpoints, die Sie für ihren Empfang konfigurieren.

Workbench

Die v2.core.health.event_generation_failure.resolved-Ereignisse werden an zwei Stellen in Workbench angezeigt:

Die Registerkarte Ereignisse
Die Registerkarte Zustand

Webhook-Endpoints

Sie können den Webhook-Einrichtungsleitfaden befolgen, um einen Webhook-Endpoint zu registrieren, der v2.core.health.event_generation_failure.resolved-Thin-Ereignisse überwacht. Nachdem Sie den richtigen Webhook-Endpoint registriert haben, sendet Stripe [v2.core.health.event_generation_failure.resolved-Ereignisse an ihn.

So verwenden Sie das Integritätsereignis

Wenn Stripe ein Webhook-Ereignis nicht generieren kann, können Sie das erzeugte Thin Event verarbeiten, um das Objekt v2.core.health.event_generation_failure.resolved abzurufen, wie im folgenden Beispiel gezeigt.

{
  "alert_id": "halert_61RFBMa6o6H87usts16RFBM10hSQlYfddqcFoEMR6CPY",
  "grouping_key": "_grouping_s8PgTvizbkORV9z5PhaJSvc4dUcAMmfRpEHKm4EeJ1glsQ5XMf",
  "impact": {
    "event_type": "payment_intent.requires_action",
    "related_object_id": "pi_1QA8PKDTvO5jCVb3TVDZP75a",
    "related_object": {
      "id": "pi_1QA8PKDTvO5jCVb3TVDZP75a",
      "type": "payment_intent",
      "url": "https://dashboard.stripe.com/payment_intents/pi_1QA8PKDTvO5jCVb3TVDZP75a"
    },
  },
  "resolved_at": "2025-10-30T16:05:44.000Z",
  "summary": "We have failed to create a notification for your Stripe account.",
}

Das Beispielereignis liefert folgende Informationen über den Fehler:

Fehlgeschlagenes Ereignis: Stripe konnte kein payment_intent.requires_action-Ereignis erzeugen.
Relevantes Objekt: Das PaymentIntent, für das Stripe das Ereignis nicht generiert hat, ist pi_1QA8PKDTvO5jCVb3TVDZP75a.
Zeitstempel: Ereigniserzeugung fehlgeschlagen um 2025-10-30T16:05:44.000Z.
Kontotyp: impact inkludiert nicht die Eigenschaft context, deshalb ist das Ereignis payment_intent.requires_action nicht auf einem verbundenen Konto aufgetreten.

Wenn Ihre Integration darauf basiert, Webhooks für das payment_intent.requires_action-Ereignis zu empfangen, führt dieser Fehler dazu, dass sie nicht synchron mit dem Stripe-Zustand ist. Zur Neuausrichtung der Integration, nachdem Sie eine v2.core.health.event_generation_failure.resolved-Webhook empfangen haben, fragen Sie die relevante API ab (in diesem Fall die Payment Intents API), um das zugehörige Objekt abzurufen: