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).
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.
To get tax settings, send a request to the Get tax settings endpoint.
When a merchant enters tax-inclusive prices, the
should_subtract_store_tax field allows you to choose how a store calculates the tax-inclusive price displayed to shoppers. This setting affects the tax-inclusive price displayed to a shopper if the shopper and merchant are in different tax zones. For more information, see the Tax Settings API Reference.
To update tax settings, send a request to the Update tax settings endpoint. The request updates only the fields that you specify.