Skip to main content

On - Hold Reservation

A reservation can be created with an On Hold status which removes room inventory until the reservation is confirmed, canceled or the system automatically cancels after a period of time. On Hold reservations override the guarantee and cancel policies assigned to the selected product so the reservation can be confirmed without a payment method. Guest information is required for On Hold reservations.

A hotel will configure a default On Hold Release time in SynXis CR. The release time can be overridden in the API using onHoldReleaseTime.

For example: A reservation is created with a status of On-Hold and onHoldReleaseTime=6. That means the guest will have 6 hours to complete or cancel the reservation before the system will automatically cancel the reservation and return the room inventory.

Setup Requirements:

  • Chain must have On Hold Reservations Auto Release enabled in Control Center
  • API user must have Access Point Can Manage On Hold Reservations

 

ParameterDescriptionTypeRequired
StatusState of the reservation. 
Value: OnHold
StringYes
onHoldReleaseTimeSpecifies the on-hold release time in hours.IntegerNo

 

Partial Reservation Request

{
    "Guests": {...},        
    "Packages": {...},
    "RoomStay": {...},      
    "onHoldReleaseTime": 6,
    "status": "OnHold"
}