Tax Settings

Tax settings allow you to choose how a store handles tax calculation and price display. For example, you can set how a store handles taxes if an enabled tax service is unavailable. You can also choose whether prices include taxes when displayed on orders and invoices. For more info, see Tax Settings (opens in a new tab).

Estimate taxes and display prices based on tax zone

The Tax Settings API supports cross-border transactions. You can localize storefront prices for shoppers from different regions. For example, you can display tax-inclusive or exclusive prices depending on the tax zone. This benefits single-storefront stores that sell to shoppers from different regions. This functionality applies to Stencil and GraphQL-powered storefronts.

To support cross-border transactions, the store identifies a tax zone for the shopper. The store then applies the tax zone and its settings to estimate taxes and display prices. For logged-in customers, the store uses the customer address to identify the tax zone. For guest shoppers, the store can use the shopper's geolocation to identify the zone if you enable this setting. Otherwise, the store uses the provided guest shopper tax zone ID.

This guide shows you how to use the Tax Settings API. For more info, see the Tax Settings API Reference.

Get tax settings

To get tax settings, send a request to the Get tax settings endpoint.

GET https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/settings
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json

Update tax settings

To update tax settings, send a request to the Update tax settings endpoint. The request updates only the fields that you specify.

PUT https://api.bigcommerce.com/stores/{{STORE_HASH}}/v3/tax/settings
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
{
  "tax_entered_with_prices": false,
  "price_display_settings": {
    "invoice_price_display_strategy": "INCLUSIVE"
  }
}

Resources

• Tax Settings API Reference
• Get Tax Settings
• Update Tax Settings