Cancellation Policy

❗️

The cancellation policy at search time and the actual cancellation policy for bookings may differ. Please follow this guide to prevent any claims.

Key Summary

• Two policies exist: Static Policy (for search) and Dynamic Policy (actually applied)
• Cancellations use Dynamic Policy: Dynamic Policy is applied when canceling a reservation
• Check before booking: Always query Dynamic Policy before payment and inform the customer

Two Cancellation Policies

ONDA's cancellation policy is divided into Static Policy and Dynamic Policy.

Category	Static Policy	Dynamic Policy
Purpose	Display in search results	Applied at actual cancellation
Characteristics	Property-level default (conservative)	Actual policy by room/time
API	Search Property Detail	Cancellation & Refund Policy before reservation
Field	refund_policy object	refund_policy object

Static Policy

A default policy set at the property level, displaying the most conservative cancellation policy.

• API:
  • refund_policy object in Search Property Detail
  • property_refunds object in Get Property Detail (same value)
• Purpose: Provide approximate cancellation policy in search results
• Note: May differ from the policy applied at actual cancellation

⚠️ Caution

Do not provide customers with a confirmed cancellation policy based on Static Policy alone. Cancellation fees and refund amounts may differ at actual cancellation.

Dynamic Policy

The actual cancellation policy for the room the customer wants to book. It may vary by room, date, and time.

• API: refund_policy object in Cancellation & Refund Policy before reservation
• Purpose: Check the actual policy to be applied just before booking
• Application: This policy is applied when the customer cancels

💡 Key Point

Dynamic Policy is always applied when canceling a reservation.

Implementation Guide

Partners should handle cancellation policies with the following flow:

Step 1: Display Search Results

API: Search Property Detail
Display: Static Policy (for reference)

• Provide approximate cancellation policy in search results
• Recommended text: "Cancellation policy may change at time of booking"

Step 2: Check Before Booking

API: Cancellation & Refund Policy before reservation
Display: Dynamic Policy (actually applied)

• Must be called before payment to check the actual cancellation policy
• Clearly inform the customer of this policy

Step 3: Process Cancellation

Applied: Dynamic Policy

• Cancellation fees/refunds are processed according to Dynamic Policy