openactive / customer-accounts-api

Repository for discussions broadly related to Customer Accounts
MIT License
0 stars 0 forks source link

Late cancellation policy #4

Open nickevansuk opened 2 years ago

nickevansuk commented 2 years ago

From discussions with Everyone Active, it is possible for a customer to request the cancellation of a Customer Account booking outside of the cancellation window. Before such a cancellation is requested, the customer should be notified of any late cancellation policy that may apply. For example: a late cancellation charge is added to the account if the space is not relet.

To ensure clarity is provided to Customers before they proceed with the cancellation, the policy could be summarised in a free text property customerAccountBookingLateCancellationPolicy. The Broker would then display this text to the Customer before they proceed to request a cancellation outside of the cancellation window, and the Customer may then use this information to determine whether they wish to proceed with the cancellation.

If a customerAccountBookingLateCancellationPolicy is not provided, the Broker would assume that cancellation outside of the cancellation window is not permitted.

Example open data extract

"organizer": {
  "@type": "Organization"
  ...
  "customerAccountBookingLateCancellationPolicy": "Late cancellations may incur a penalty if the space is not relet"
}

If a Customer is not permitted to make a late cancellation, they must receive an error from the Cancellation request with the reason clearly articulated.

nickevansuk commented 2 years ago

From discussion with Everyone Active, it's become apparent that this is a policy (i.e. terms), and should therefore be described in the same way as other policies/terms:

"organizer": {
  "@type": "Organization"
  ...
  "termsOfService": [
    {
      "@type": "LateCancellationPolicy",
      "name": "Late Cancellation Policy",
      "url": "https://example.com/late-cancellation-policy",
      "abstract": "Late cancellations may incur a penalty if the space is not relet"
     }
  ]
}