About the Booking Fees API

The Booking Fees API allows you to calculate and manage fees for your bookings, ensuring transparent and consistent pricing for customers.

With the Booking Fees API, you 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 and not 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 applyBookingFeeToOrder() 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 collectAppliedBookingFees() to charge customers.
  • Currently, there is no validation that prevents idempotent requests in collectAppliedBookingFees(). This means that your code must make sure to not charge customers multiple times for the same booking fee. You could use listTransactionsForSingleOrder() 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. You can give customers a discount when applying booking fees to an order.

For a comprehensive glossary of Wix Bookings terms, see Terminology.

Did this help?