About the Booking Fees API

The Booking Fees API enables you to calculate and manage fees (currently only cancellation fees) for bookings, ensuring transparent and consistent pricing for customers.

With the Booking Fees API, your app can:

  • Preview how much customers would have to pay if they canceled their booking now.
  • Apply cancellation fees, including no show fees, to eCommerce orders.
  • Collect booking fees from the customer.

Learn more about booking policies that determine when and with which consequences customers can cancel their bookings. You can use the eCommerce Orders API to manage customer payment processes within the Wix ecosystem.

Before you begin

It's important to note the following points before starting to code:

  • Cancellation fees are the only booking fees that are supported.
  • The Booking Fees API calculates booking fees based on the booking's policy snapshot rather than the service's current booking policy.
  • Wix Bookings automatically applies the cancellation fee to the eCommerce order if the customer cancels the booking themselves. Cancellation fees aren't automatically applied to an eCommerce order if the business owner cancels the booking in their dashboard on behalf of the customer. You can use Apply Booking Fee to Order to manually apply booking fees to an eCommerce order.
  • After a cancellation fee is applied to an eCommerce order, the cancellation fee's price.value is updated to 0.00 and trigger is set to UNKNOWN_TRIGGER. You can retrieve details about applied booking fees from the additionalFee object in the related eCommerce order.
  • Applying a booking fee to an eCommerce order doesn't automatically charge the customer. Use Collect Applied Booking Fees to charge customers.
  • Currently, there is no validation that prevents idempotent requests in Collect Applied Booking Fees. This means that your code must make sure to not charge customers multiple times for the same booking fee. You could use List Transactions For Single Order to check which charges were made previously for an eCommerce order.

Use cases

Terminology

  • Booking fee: Fee for a specific booking that's calculated according to the associated booking policy snapshot. Currently, only cancellation fees, including no-show fees, are supported.
  • Additional fee: All related booking fees are applied as a single additional fee to an eCommerce order. When applying booking fees to an order, you can offer a discount to the customer.
Did this help?