Skip to content
Last updated

Cancellation

These operations cover the cancellation of hotel bookings, either initiated by the traveler or by the hotel/vendor.

Webhook used: PNR_V3

StepOperation Event triggerContext

1

BOOKING_CANCELED_ BY_TRAVELER

When the hotel booking is canceled by the traveler.

The hotel reservation has been cancelled by the traveler.

The refund amount depends on the hotel's cancellation policy:

  • Refundable (canceled before the cancellation deadline): The full prepaid amount is refunded.
  • 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).
  • Non-refundable: No refund is received.
  • Pay-at-hotel bookings: There is no Spotnana-side refund to process, however a cancellation fee may still apply per hotel policy.

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 BOOKING_CANCELED_BY_TRAVELER event is triggered and the full $750 is refunded.

2BOOKING_CANCELED_ BY_VENDORWhen the hotel booking is canceled by the hotel or the supplier.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.

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 BOOKING_CANCELED_BY_VENDOR event is triggered. The full prepaid amount is refunded.

Hotel cancellation flow diagram

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.