Why confirmation alone is not settlement evidence
A hotel reservation can be confirmed before you know who collected the payment or whether the settlement record matches the booking. Track those outcomes separately.
The November partnership announcement describes combining hotel access and booking through Duffel with Katanox payments and reconciliation. The public documentation describes separate test environments; it does not establish a shared endpoint or which sellers have access to the combined flow.
What to verify in the separate test environments
- Duffel test hotels are available in Test Mode, including documented balance-success and unavailable-rate examples.
- A 202 response to a Duffel Stays booking request means the outcome is still being confirmed. Duffel advises against retrying that create request because it could result in a duplicate booking.
- Duffel documents that a stays.booking.created event for a created booking can link the quote_id and booking_id. That connects a quote to a booking; it does not verify settlement.
- If no event arrives, keep the booking pending while you check the result through the documented webhook or booking-list workflow. A missing event alone does not establish failure.
- Katanox documents its own sandbox with fictional properties and no real hotels or money, so a separate sandbox result does not prove combined access or settlement.
Three cases to try with fictional records
Use clearly synthetic labels when you test the workflow. The examples below are only acceptance cases, not real payload names and not proof that one internal booking reference will automatically join platforms.
- Quote Q1 becomes booking B1. Your fictional settlement row S1 maps to B1, and its amount and currency match the expected values. Mark the example reconciled.
- Quote Q1 becomes booking B1, but there is no settlement row that maps to B1. Record the booking as confirmed and the settlement as unreconciled.
- Quote Q1 is still pending and you have no booking confirmation. Leave it pending; there is no confirmed booking to match.
What to ask in a partner pilot
If a provider is demonstrating a pilot, ask for the real identifier or reference mapping, plus currency and amount, in one authorized test trace. If you only have separate sandboxes, keep settlement marked as unverified. That is the safest way to avoid turning a booking confirmation into a false settlement conclusion.
These examples describe expected outcomes for a pilot. We did not run them against a combined Duffel and Katanox environment.
Duffel and Katanox partnership announcement
Duffel test hotels documentation
Duffel response handling guidance
