Verarbeitung eingehender Webhooks mit Ereignisbenachrichtigungs-HandlernÖffentliche Vorschau

Schreiben Sie eine Funktion, die immer dann ausgeführt wird, wenn kein spezieller Rückruf für einen bestimmten Ereignistyp registriert wurde. Sie empfängt die Ereignisbenachrichtigung sowie einen StripeClient und zusätzliche Informationen zum Ereignis.

Diese Funktion kann protokollieren, dass Sie ein unerwartetes Ereignis erhalten haben, oder eine Fehlermeldung ausgeben, um Sie auf den unerwarteten Zustand hinzuweisen. Sie können in dieser Funktion auch Geschäftslogik hinzufügen, wenn Sie Ereignisse verarbeiten, für die Ihr SDK keine Typen hat.

def fallback_callback(notif: EventNotification, client: StripeClient, details: UnhandledNotificationDetails):
    print(f'Got an unhandled event of type {notif.type}!')

Ziehen Sie im Rahmen Ihrer Migration in Betracht, Ihren gesamten Webhook-Endpoint-Code in diese Funktion zu verschieben. Anschließend können Sie einzelne Ereignistypen zu ihren eigenen Funktionen migrieren.

Initialisieren Sie in Ihrem Webhook Endpoint einen EventNotificationHandler und übergeben Sie ihm Ihren Fallback-Rückruf. Es gibt eine Komfortmethode im StripeClient, um diesen Schritt zu vereinfachen.

client = StripeClient(api_key)
handler = client.notification_handler(webhook_secret, fallback_callback)

Schreiben Sie als Nächstes eine Funktion, die für die Verarbeitung eines bestimmten Ereignistyps verantwortlich ist. Sie verwendet die Ereignistypen, die im September 2025 mit der Version der Clover API veröffentlicht wurden.

Ihr Rückruf erhält die Ereignisbenachrichtigung, die der richtigen Klasse zugeordnet wird. Außerdem erhalten Sie einen StripeClient, der an den Kontext der Benachrichtigung gebunden ist. Damit ist es einfach, zusätzliche API-Aufrufe durchzuführen, ohne mit Konto-IDs zu jonglieren.

# can be anywhere in your codebase
@handler.on_v1_billing_meter_error_report_triggered
def handle_meter_error(
    notif: V1BillingMeterErrorReportTriggeredEventNotification,
    client: StripeClient,
):
    event = notif.fetch_event()
    print(f"Err! No meter found: {event.data.developer_message_summary}")

Sie können null oder mehr Rückrufe registrieren. Wenn Sie keine registrieren, werden alle Ereignisse zu Ihrem Fallback-Rückruf weitergeleitet.

Senden Sie eingehende POST-Texte an den Handler. Dadurch wird der größte Teil des ursprünglichen Codes in Ihrem Webhook-Endpoint ersetzt.

@app.route("/webhook", methods=["POST"])
def webhook():
    webhook_body = request.data
    sig_header = request.headers.get("Stripe-Signature")

    try:
        handler.handle(webhook_body, sig_header)
        return jsonify(success=True), 200
    except Exception as e:
        return jsonify(error=str(e)), 500