Cancellation Policies & Refund Rules

Use the policy returned by the API

Display cancellation rules exactly from the real-time product response. All policy times are in the hotel’s local time. At a boundary time, the supplier response is authoritative.

Cancellation restriction types

Value	Meaning
`1`	Non-cancellable and non-modifiable.
`2`	Cancellation after the specified deadline incurs a penalty.
`3`	Free cancellation before the stated cutoff; non-cancellable afterwards.
`4`	Free cancellation at any time.

Penalty calculation

When cancelRestrictionType=2, read each entry in cancelPenalties. A response can contain multiple penalty windows; show the one applicable to the cancellation time.

`penaltiesType`	Calculation
`1`	Number of room nights.
`2`	Fixed monetary amount; use the returned currency.
`3`	Percentage of the full order amount.
`4`	Percentage of the first night’s room rate.

Implementation rules

Fetch a fresh product/availability result before the user confirms a booking; never reuse an old cancellation rule as the final result.
Store the policy returned for the selected rate plan, including each start/end time, currency, and penalty value.
When the customer requests cancellation, call Cancel order and use its response as the final cancellation result.
Do not calculate a refund locally as the final authority. A confirmed order can be subject to supplier cancellation checks.
After payment, use the order-status webhook as the primary result channel and use order-detail lookup only as low-frequency compensation.

Customer-facing wording

Show the deadline, time zone/local hotel time, penalty basis, amount or percentage, and currency where provided. Avoid presenting a penalty estimate as a guaranteed refund amount.