Important: When developing websites or building apps with Blocks, use Velo service plugins.
As a tax calculation provider, you can integrate with Wix to allow merchants to request and use your services on their Wix sites. The tax calculated is then included on the site's cart and checkout pages. Use the Tax Calculation Provider service plugin together with the Tax Groups API and the Tax Regions API to customize your tax calculations.
With the Tax Calculation Provider service plugin integrated into your app, Wix calls your app with Calculate Tax whenever tax needs to be recalculated on a site. For example, when line items are updated in a cart or checkout.
The integration is done via an app created in your Wix Studio workspace and by implementing the Tax Calculation Provider service plugin.
To enable Wix to communicate with your app:
Go to Extensions in your app's dashboard.
Click + Create Extension in the top right.
Find Tax Calculation Provider and click + Create.
Use the JSON editor to create the extension's configuration file. Configure the parameters by referencing the table below or the Documentation section to the right of the editor. For each parameter, add the parameter name and value in the JSON editor.
| Name | Type | Description |
|---|---|---|
deploymentUri | string | Required. Base URI where the endpoints are called. Wix appends the endpoint path to the base URI. For example, to call the Calculate Tax endpoint at |
calculatorDisplayName | string | Display name of the tax calculator. |
unsupportedCountries | array | List of countries, in ISO-3166 alpha-1 format, that the calculator does not support. |
componentName | string | A unique name for this component. This is an internal name that will only appear in the app dashboard. |
Click Test Your App.
country and subdivision with a specific tax treatment. Tax is calculated based on the tax region and the tax group associated with a line item. See the Tax Regions API.