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