Add EventNotificationHandler example

CHANGELOG.md

@@ -4,6 +4,7 @@
 This release changes the pinned API version to `2025-12-15.preview`.
 
 * [#1653](https://github.com/stripe/stripe-python/pull/1653) Add EventNotificationHandler
+  * This is a new, simplified way to handle event notifications (AKA thin event webhooks). Learn more in the docs: https://docs.stripe.com/webhooks/event-notification-handlers
 * [#1680](https://github.com/stripe/stripe-python/pull/1680) Update generated code for beta
   * Add support for new resources `reserve.Hold`, `reserve.Plan`, and `reserve.Release`
   * Add support for `list` and `retrieve` methods on resources `reserve.Hold` and `reserve.Release`

examples/event_notification_handler_endpoint.py

@@ -0,0 +1,55 @@
+"""
+event_notification_handler_endpoint.py - receive and process event notifications (AKA thin events) like "v1.billing.meter.error_report_triggered" using EventNotificationHandler.
+
+In this example, we:
+    - write a fallback callback to handle unrecognized event notifications
+    - create a StripeClient called client
+    - Initialize an EventNotificationHandler with the client, webhook secret, and fallback callback
+    - register a specific handler for the "v1.billing.meter.error_report_triggered" event notification type
+    - use handler.handle() to process the received notification webhook body
+"""
+
+import os
+from flask import Flask, request, jsonify
+
+from stripe import StripeClient, UnhandledNotificationDetails
+from stripe.v2.core import EventNotification
+from stripe.events import V1BillingMeterErrorReportTriggeredEventNotification
+
+app = Flask(__name__)
+api_key = os.environ.get("STRIPE_API_KEY", "")
+webhook_secret = os.environ.get("WEBHOOK_SECRET", "")
+
+
+def fallback_callback(
+    notif: EventNotification,
+    client: StripeClient,
+    details: UnhandledNotificationDetails,
+):
+    print(f"Got an unhandled event of type {notif.type}!")
+
+
+client = StripeClient(api_key)
+handler = client.notification_handler(webhook_secret, fallback_callback)
+
+
+# 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}")
+
+
+@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