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.
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.
- 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.