# Production Troubleshooting

Production runbooks for travel APIs, bookings, webhooks, stale state, refunds and provider outages.

## Pages

- [Booking Timeout / Outcome Unknown Troubleshooting](https://metasearch.com.tr/en/learn/booking-timeout-outcome-unknown-troubleshooting.md): Diagnose ambiguous travel-booking timeouts without duplicate retries using evidence, authoritative lookup and reconciliation.
- [Cancellation Succeeded but Local State Stale](https://metasearch.com.tr/en/learn/cancellation-local-state-stale-troubleshooting.md): Diagnose cases where provider cancellation succeeded but local booking state stayed stale across webhook, persistence, ordering and reconciliation layers.
- [Duplicate Booking After Retry Troubleshooting](https://metasearch.com.tr/en/learn/duplicate-booking-after-retry-troubleshooting.md): Identify duplicate travel bookings created after timeout/retry, preserve the correct reservation and apply safe compensation.
- [Feed Ingestion Failure Troubleshooting](https://metasearch.com.tr/en/learn/feed-ingestion-failure-troubleshooting.md): Diagnose travel feed failures systematically across transport, schema, parsing, validation, persistence and downstream publishing.
- [How to Debug Hotel Price Mismatches](https://metasearch.com.tr/en/learn/hotel-price-mismatch-troubleshooting.md): Diagnose price differences between metasearch, OTA and hotel booking engines with an evidence-driven triage and root-cause workflow.
- [Image & Amenity Data-Quality Troubleshooting](https://metasearch.com.tr/en/learn/image-amenity-data-quality-troubleshooting.md): Diagnose duplicate, stale, incorrectly mapped and conflicting hotel imagery or amenity data using provenance and confidence.
- [Missing Webhook Troubleshooting](https://metasearch.com.tr/en/learn/missing-webhook-troubleshooting.md): Diagnose missing provider webhooks across delivery, signature, endpoint, queue and reconciliation layers.
- [Order Confirmed but Ticket Not Issued Troubleshooting](https://metasearch.com.tr/en/learn/order-confirmed-ticket-not-issued-troubleshooting.md): Diagnose flight cases where an order is confirmed but ticket/document issuance is incomplete by separating order, payment and fulfillment state.
- [Payment Authorized/Captured but Booking Unknown/Failed](https://metasearch.com.tr/en/learn/payment-booking-divergence-troubleshooting.md): Diagnose payment-booking divergence when payment succeeds while booking remains unknown or fails, then choose safe recovery and compensation.
- [Provider Partial Outage / Degraded Mode Troubleshooting](https://metasearch.com.tr/en/learn/provider-partial-outage-degraded-mode-troubleshooting.md): Diagnose travel-provider partial outages where latency, timeouts or specific capabilities degrade without a total service failure.
- [Refund / Reconciliation Mismatch Troubleshooting](https://metasearch.com.tr/en/learn/refund-reconciliation-mismatch-troubleshooting.md): Diagnose divergence between booking cancellation and payment refund state across amount, currency, partial refunds and provider evidence.
- [How to Diagnose Room & Rate Mapping Problems](https://metasearch.com.tr/en/learn/room-rate-mapping-troubleshooting.md): Troubleshoot hotel room and rate-plan mapping failures using canonical identity, occupancy, meal, policy and contradiction evidence.
- [Stale Availability / Offer Expired Troubleshooting](https://metasearch.com.tr/en/learn/stale-availability-offer-expired-troubleshooting.md): Diagnose stale availability and expired offers across freshness, cache, token and revalidation layers between search and booking.
- [Stale Price & Delayed Feed Troubleshooting](https://metasearch.com.tr/en/learn/stale-price-feed-troubleshooting.md): Diagnose stale hotel offers and delayed feeds using freshness timestamps, ingestion lag, cache state and invalidation evidence.
- [Taxes & Fees Mismatch Troubleshooting](https://metasearch.com.tr/en/learn/taxes-fees-mismatch-troubleshooting.md): Diagnose hotel tax and fee differences through explicit base/total semantics, currency handling, occupancy and market context.
- [Webhook Replay & Idempotency Troubleshooting](https://metasearch.com.tr/en/learn/webhook-replay-idempotency-troubleshooting.md): Handle duplicate, delayed and out-of-order webhook events safely with deduplication, replay rules and idempotent state transitions.
- [Wrong Property Mapping RCA](https://metasearch.com.tr/en/learn/wrong-property-mapping-rca.md): Diagnose supplier properties linked to the wrong canonical hotel using lineage, match features and contradiction evidence.