Introduction

The Tax Regions API allows you to create and manage tax regions to apply different tax treatment based on location. Use the Tax Regions API together with the Tax Groups API and the Tax Calculation API to customize the application of tax for your business.

Before you begin

It's important to note the following before starting to code:

  • A tax region requires an appId for an available tax calculator. Use listTaxCalculators() to retrieve a list of available tax calculators for a site.

To use the Tax Regions API, import { taxRegions } from the wix-billing.v2 module:

Copy

Terminology

  • Tax calculator: An app that is used under the hood to calculate tax for a Wix site. The app calculates tax based on the tax group of the product and the tax region of the sale. A site assigns each tax region to the Wix manual tax calculator or an external calculator app to properly calculate tax.
  • Wix manual tax calculator: The default tax calculator installed with a Wix site. The tax rates to apply for this calculator can be manually adjusted in the Tax Settings in the Wix dashboard.
Did this help?