As a bookings pricing service provider (formerly SPI), you can integrate your pricing service with Wix to allow a merchant to apply more sophisticated varied pricing options for their bookings on their Wix sites. This allows site owners to offer different prices for the same service.
The integration is done via an app you create in the Wix App Market (created in the Wix Developer Center) and Wix Bookings Pricing Integration service plugins:
The Wix Developer Center is an environment used to set up new service providers and focus on app integrations.
Using the service plugins, you can design your app to provide custom pricing calculations for your merchant's bookings. The custom pricing logic can be based on, for example:
Complete the following steps to adapt Wix system's integration to make your pricing methods available to merchants and their customers.
There are various ways to set up pricing for bookings. The service plugins are the way to go for flexibility and granularity of how bookings prices are calculated.
Using the Wix Bookings Pricing API, you can retrieve the standard prices and/or set up basic varied pricing using the Wix Bookings app on the site.
For more robust varied pricing, the site owner can offer different prices for the same service using service options and variants APIs.
To set up your own custom logic for robust varied pricing, you can use Wix Bookings Pricing Integration service plugin without having to set up service variants. With the Wix Bookings Pricing Integration service plugin, your app can calculate the price of a booking based on your own custom logic.
For a comprehensive glossary of Wix Bookings terms, see Terminology.
It's important to note the following points before starting to code your integration:
When Wix calls your implementation of the Calculate Price service plugin endpoint, the app must return either a calculated price (number) or a price description (text). Returning the calculated price enables the Wix site owner to perform additional calculations based on your pricing.
The Calculate Price service plugin endpoint can only be called after a booking has been created and a booking object already exists. You cannot use this service plugin in advance, for example, to display a price list for various options.
The Bookings Pricing Preview Price API endpoint always returns the standard Wix Bookings price and doesn't call your app. Prices shown before a booking is created, such as on the service page or the booking form, come from the standard pricing logic. Your app's price applies from checkout onward.
Only 1 pricing provider can be active on a site. When more than 1 is installed, the Bookings Pricing Calculate Price API endpoint fails with MULTIPLE_PRICING_PROVIDERS_FOUND.
Last updated: 20 August 2024