As an additional fees calculation provider, you can integrate with Wix to allow merchants to request and use your services on their Wix sites. The additional fees you calculate are then included on the site's cart and checkout pages.
The integration is done via an app in the Wix App Market and by implementing the Additional Fees service plugin. After the app is installed on a site, Wix triggers a call to your service whenever the site needs to calculate additional fees for a transaction.
Using the service plugin, you can design your app to calculate various additional fees for the merchant's customers, including:
Follow these steps to begin implementing your service plugin.
You can implement this service plugin with the following frameworks:
To configure and customize your plugin, you need to provide important information in the service plugin configuration file. You can configure your plugin in the Wix Dev Center. For details, see Additional Fees Extension Configuration.
Use additionalFees.provideHandlers() to define the following handler functions that implement your custom business logic. Make sure you define all required functions.
| Function | Required |
|---|---|
calculateAdditionalFees() | Yes |
Below is an example for implementing the Additional Fees service plugin in your code.
This is the basic code structure for implementing the Additional Fees service plugin with the Wix CLI:
This is the basic code structure for implementing a self-hosted Additional Fees service plugin:
To configure and customize your service plugin, you need to provide important details in the plugin.json configuration file.
If you created your service plugin extension with the CLI, required fields are automatically populated for you.
Base URI where the endpoints are called.
Wix eCommerce appends the endpoint path to the base URI.
For example, to call the Calculate Additional Fees endpoint at https://my-additional-fees.com/v1/calculateAdditionalFees,
the base URI you provide here is https://my-additional-fees.com/.