---
title: "Missing Webhook Troubleshooting"
description: "Beklenen provider webhook'u gelmediğinde delivery, signature, endpoint, queue ve reconciliation katmanlarını sistematik olarak teşhis edin."
slug: "missing-webhook-troubleshooting"
translationKey: "troubleshooting-missing-webhook"
locale: "tr"
type: "troubleshooting"
category: "troubleshooting"
tags: ["webhook","missing-event","reconciliation","provider","debugging"]
publishedAt: "2026-09-27"
updatedAt: "2026-09-27"
reviewedAt: "2026-09-27"
technicalVerifiedAt: "2026-09-27"
codeExampleStatus: "illustrative"
---

Webhook gelmediğinde ilk varsayım provider'ın event üretmediği olmamalıdır. **Delivery zincirinin hangi noktasında evidence kaybolduğunu** bulun.

## Symptom

- booking/provider state değişmiş ama local state stale,
- beklenen cancellation/refund/confirmation event'i yok,
- polling provider'da yeni state buluyor fakat webhook store'da event yok.

## Possible causes

- provider event üretmedi,
- yanlış callback URL,
- DNS/TLS/network failure,
- signature/auth rejection,
- ingress 5xx/timeout,
- queue publish/consume failure,
- event işlendi fakat state update başarısız,
- dedup yanlışlıkla legitimate event'i düşürdü.

## Diagnosis

1. Provider delivery dashboard/log varsa kontrol edin.
2. Ingress access logs'ta request var mı bakın.
3. Signature/auth failure ölçümlerini inceleyin.
4. Queue/topic üzerinde event var mı kontrol edin.
5. Dead-letter/poison queue'yu inceleyin.
6. Event store ve materialized state arasındaki farkı kontrol edin.
7. Provider status lookup ile authoritative state'i doğrulayın.

## Recovery

Authoritative lookup ile local state'i reconcile edin. Provider replay destekliyorsa event'i replay edin; desteklemiyorsa synthetic domain event yerine reconciliation evidence kaydı üretin.

## Prevention

- webhook health monitoring,
- retry-safe ingress,
- durable queue,
- dead-letter handling,
- reconciliation fallback,
- provider delivery test/smoke,
- callback config audit.

## Observability

- webhook delivery count,
- ingress 4xx/5xx,
- signature failures,
- queue lag,
- DLQ count,
- provider-state/local-state drift,
- missing-webhook detected count.
