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 | Check Avail 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_policyobject in Search Property Detailproperty_refundsobject 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_policyobject in Check Avail 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: Check Avail 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