Missing Webhook Troubleshooting

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.