{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Booking and confirmation","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"booking-and-confirmation","__idx":0},"children":["Booking and confirmation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This operation covers the initial hotel booking flow, from when the traveler selects a hotel to when the supplier confirms the reservation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook used:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/webhookeventapi/webhooks/paths/pnr_v3/post"},"children":["PNR_V3"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event trigger"},"children":["Event trigger"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context"},"children":["Context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the hotel confirms the reservation."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The hotel has accepted the reservation and created a booking for the traveler."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}," event payload will contain the PNR (i.e., the vendor confirmation number) created for this booking."," ","There is no ticketing step for hotel booking."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For a pre-paid booking, the payment method is charged immediately when the booking is created."," ","For pay-at-hotel bookings, the traveler still needs to provide a payment method during checkout. When the booking is created, the service fee is"," ","charged to the card. For the hotel booking they can pay online later or pay at the hotel at the time of check-in."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler books a 3-night stay at the Hilton Midtown NYC, from March 15 to March 18, at $250/night prepaid."," ","The hotel confirms the reservation with a confirmation number."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}," event is sent, and the $750 total + service fee is charged to the payment method."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notes:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/webhookeventapi/webhooks/paths/service_charge/post"},"children":["SERVICE_CHARGE"]}," event and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," event will be generated after the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}," step for both pre-paid and pay-at-hotel bookings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For pay-at-hotel bookings, an invoice will be generated for the TMC service fee."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hotel-booking-flow-diagram","__idx":1},"children":["Hotel booking flow diagram"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart LR\n subgraph booking[\"Booking phase\"]\n A[\"Traveler searches
for hotels\"] --> B[\"Traveler selects
hotel and room\"]\n B --> C{\"Hotel confirms
reservation?\"}\n C -->|Yes| D[\"BOOKING_CREATED
―――――――――――
Hotel confirms the booking.
Confirmation number assigned.
Prepaid: card is charged.
Pay-at-hotel: no charge yet.\"]\n C -->|\"No (rare)\"| E[\"No webhook
(booking remains pending)\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#f0f0f0,stroke:#999\n style D fill:#4CAF50,color:#fff\n style E fill:#9E9E9E,color:#fff\n","diagramHtml":"

Booking phase

Yes

No (rare)

Traveler searches
for hotels

Traveler selects
hotel and room

Hotel confirms
reservation?

BOOKING_CREATED
―――――――――――
Hotel confirms the booking.
Confirmation number assigned.
Prepaid: card is charged.
Pay-at-hotel: no charge yet.

No webhook
(booking remains pending)

"},"children":["flowchart LR\n subgraph booking[\"Booking phase\"]\n A[\"Traveler searches
for hotels\"] --> B[\"Traveler selects
hotel and room\"]\n B --> C{\"Hotel confirms
reservation?\"}\n C -->|Yes| D[\"BOOKING_CREATED
―――――――――――
Hotel confirms the booking.
Confirmation number assigned.
Prepaid: card is charged.
Pay-at-hotel: no charge yet.\"]\n C -->|\"No (rare)\"| E[\"No webhook
(booking remains pending)\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#f0f0f0,stroke:#999\n style D fill:#4CAF50,color:#fff\n style E fill:#9E9E9E,color:#fff\n"]}]},"headings":[{"value":"Booking and confirmation","id":"booking-and-confirmation","depth":1},{"value":"Hotel booking flow diagram","id":"hotel-booking-flow-diagram","depth":2}],"frontmatter":{"seo":{"title":"Booking and confirmation"}},"lastModified":"2026-03-11T17:17:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/webhooks/booking-lifecycle/hotel-booking-lifecycle/hotel-booking-confirmation-lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}