Stripe-Webhook-Troubleshooting

Pilot

Diagnose von fehlgeschlagenen Webhooks. Deckt HMAC-Signatur-Validation, Idempotency-Cache, Replay-Protection und typische 4xx/5xx-Fehler ab.

Phase 2 · Pilot-Rollout

Webhook-Architektur (Kurzfassung)

Stripe sendet Events an POST /api/v2/webhooks/stripe. sellx_central validiert die HMAC-Signatur gegen STRIPE_WEBHOOK_SECRET, prueft die Idempotency (Stripe-Event-ID 24h in IMemoryCache), dispatcht dann an einen typisierten Handler.

Haeufige Fehler

Stripe-CLI Dev-Mode

Lokal koennen Webhooks mit der Stripe-CLI getestet werden:

Bashstripe-listen.sh

stripe listen --forward-to http://localhost:5080/api/v2/webhooks/stripe