{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cancellation","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":"cancellation","__idx":0},"children":["Cancellation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These operations cover the cancellation of hotel bookings, either initiated by the traveler or by the hotel/vendor."]},{"$$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":{"data-label":"Step"},"children":["Step"]},{"$$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":"p","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CANCELED_ BY_TRAVELER"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the hotel booking is canceled by the traveler."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The hotel reservation has been cancelled by the traveler."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The refund amount depends on the hotel's cancellation policy:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refundable"]}," (canceled before the cancellation deadline): The full prepaid amount is refunded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partially refundable"]}," (canceled after the deadline):"," ","The penalty is deducted from full price and then refunded (e.g., one night's stay deducted as penalty)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Non-refundable:"]}," No refund is received."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pay-at-hotel bookings"]},": There is no Spotnana-side refund to process, however a cancellation fee may still apply per hotel policy."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler booked a refundable $750 hotel stay with free cancellation until 48 hours before check-in."," ","They cancel 5 days before check-in. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CANCELED_BY_TRAVELER"]}," event is triggered and the full $750 is refunded."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CANCELED_ BY_VENDOR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the hotel booking is canceled by the hotel or the supplier."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The hotel or booking supplier has canceled the reservation."," ","This scenario is less common and could occur due to hotel overbooking, property closure, renovation,"," ","natural disaster, or operational issues."," ","The refund processing follows the same rules as traveler-initiated cancellations."," ","For a vendor cancellation, the traveler is typically entitled to a full refund since the cancellation was not their doing,"," ","though the actual refund may depend on the hotel policies."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler has a confirmed reservation at a beachfront hotel."," ","A hurricane warning forces the hotel to close, and the hotel cancels all reservations for the affected dates."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CANCELED_BY_VENDOR"]}," event is triggered. The full prepaid amount is refunded."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hotel-cancellation-flow-diagram","__idx":1},"children":["Hotel cancellation flow diagram"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart LR\n subgraph cancellation[\"Cancellation\"]\n A([\"Confirmed hotel
booking\"]) --> B{\"Who initiates
the cancellation?\"}\n\n B -->|\"Traveler
cancels\"| C{\"Cancellation
policy?\"}\n\n C -->|\"Free
cancellation\"| D[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Full prepaid price refunded if canceled before deadline\"]\n\n C -->|\"Penalty
applies\"| E[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Penalty (e.g., one night's stay) deducted and remainder refunded, if canceled after deadline.\"]\n\n C -->|\"Non-
refundable\"| F[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Non-refundable rate.
No refund processed ($0).\"]\n\n B -->|\"Hotel/supplier
cancels\"| G[\"BOOKING_CANCELED_
BY_VENDOR
―――――――――――
Hotel proactively canceled.
e.g., Due to overbooking, closure, etc.
Typically full refund.\"]\n D --> H[\"INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.\"]\n E --> H\n G --> H\n end\n\n style A fill:#f0f0f0,stroke:#999\n style D fill:#F44336,color:#fff\n style E fill:#F44336,color:#fff\n style F fill:#F44336,color:#fff\n style G fill:#F44336,color:#fff\n style H fill:#FF9800,color:#fff\n","diagramHtml":"

Cancellation

Traveler
cancels

Free
cancellation

Penalty
applies

Non-
refundable

Hotel/supplier
cancels

Confirmed hotel
booking

Who initiates
the cancellation?

Cancellation
policy?

BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Full prepaid price refunded if canceled before deadline

BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Penalty (e.g., one night's stay) deducted and remainder refunded, if canceled after deadline.

BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Non-refundable rate.
No refund processed ($0).

BOOKING_CANCELED_
BY_VENDOR
―――――――――――
Hotel proactively canceled.
e.g., Due to overbooking, closure, etc.
Typically full refund.

INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.

"},"children":["flowchart LR\n subgraph cancellation[\"Cancellation\"]\n A([\"Confirmed hotel
booking\"]) --> B{\"Who initiates
the cancellation?\"}\n\n B -->|\"Traveler
cancels\"| C{\"Cancellation
policy?\"}\n\n C -->|\"Free
cancellation\"| D[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Full prepaid price refunded if canceled before deadline\"]\n\n C -->|\"Penalty
applies\"| E[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Penalty (e.g., one night's stay) deducted and remainder refunded, if canceled after deadline.\"]\n\n C -->|\"Non-
refundable\"| F[\"BOOKING_CANCELED_
BY_TRAVELER
―――――――――――
Non-refundable rate.
No refund processed ($0).\"]\n\n B -->|\"Hotel/supplier
cancels\"| G[\"BOOKING_CANCELED_
BY_VENDOR
―――――――――――
Hotel proactively canceled.
e.g., Due to overbooking, closure, etc.
Typically full refund.\"]\n D --> H[\"INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.\"]\n E --> H\n G --> H\n end\n\n style A fill:#f0f0f0,stroke:#999\n style D fill:#F44336,color:#fff\n style E fill:#F44336,color:#fff\n style F fill:#F44336,color:#fff\n style G fill:#F44336,color:#fff\n style H fill:#FF9800,color:#fff\n"]}]},"headings":[{"value":"Cancellation","id":"cancellation","depth":1},{"value":"Hotel cancellation flow diagram","id":"hotel-cancellation-flow-diagram","depth":2}],"frontmatter":{"seo":{"title":"Cancellation"}},"lastModified":"2026-03-11T17:17:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/webhooks/booking-lifecycle/hotel-booking-lifecycle/hotel-cancellation-lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}