In light of COVID-19, please review the latest announcement regarding the Reserve with Google guidelines for supporting users and merchants during this time. Additionally, since we are operating with a limited support team, it may take longer to connect with us. Thank you for your patience, and we value your partnership.

Adding Cancellation Windows

How to Add Cancellation Windows

Cancellation windows define when the cancellation button is activate. This means the cancellation function will be inoperable in user confirmation emails and will disappear from all other surfaces.

Cancellation windows can be enabled in two ways: service-level and slot-level. The processes for specifying windows at these levels are discussed below.

If both a service-level and a slot-level cancellation window are set, the slot-level window will take effect. If neither are set, the cancellation window defaults to the start of the time slot (i.e. the user can be cancelled at the last minute).

Service-level cancellation windows can be enabled by specifying min_advance_online_canceling in the service feed:

JSON

    {
  "metadata": { [...] },
  "service": [
    {
      [...],
      "rules": {
        "min_advance_online_canceling": 86400
      }
    }
  ]
}
 

Slot-level cancellation windows can be enabled by returning the last_online_cancellable_sec field in CheckAvailability responses. For example:

JSON

    /v3/CheckAvailability Response JSON:
{
slot {[...]},
count_available: 1,
last_online_cancellable_sec: 1552930200
}