Tax exemptions
Shopify's Tax Platform is available by invitation only to select tax software companies integrating with Shopify.
Shopify's Tax Platform is available by invitation only to select tax software companies integrating with Shopify.
Merchants can set tax exemptions on customers and company locations in Shopify Admin. This information is available to tax apps as part of the Tax Calculation API when taxes are calculated during checkout as well as in the payload of the Tax Summary webhook.
You can configure tax exemptions in two places in Shopify Admin:
- Customer: For direct-to-consumer (D2C) orders
- Company location: For business-to-business (B2B) orders
The API will only return one type of tax exemption. If a customer has both customer and company location tax exemptions, the company location tax exemptions take precedence.
The field for exemptions is available in the API version 2025-07 or later.
- To access this field in the tax calculation API, the tax app must be on an API version of
2025-07or later which is to be specified in the tax calculation app extension TOML file. - To access this field in the tax summary webhook, the tax app must specify a webhook API version of
2025-07or later in the app TOML file.
The field for exemptions is available in the API version 2025-07 or later.
- To access this field in the tax calculation API, the tax app must be on an API version of
2025-07or later which is to be specified in the tax calculation app extension TOML file. - To access this field in the tax summary webhook, the tax app must specify a webhook API version of
2025-07or later in the app TOML file.
Anchor to Supported tax exemption codesSupported tax exemption codes
Anchor to AustraliaAustralia
au.reseller: Australia reseller
Anchor to CanadaCanada
ca.status.card: Canada status cardca.diplomat: Canada diplomatca.bc.reseller: British Columbia resellerca.mb.reseller: Manitoba resellerca.sk.reseller: Saskatchewan resellerca.bc.commercial.fishery: British Columbia fisheryca.mb.commercial.fishery: Manitoba fisheryca.ns.commercial.fishery: Nova Scotia fisheryca.pe.commercial.fishery: Prince Edward Island fisheryca.sk.commercial.fishery: Saskatchewan fisheryca.bc.production.and.machinery: British Columbia production and machineryca.sk.production.and.machinery: Saskatchewan production and machineryca.bc.sub.contractor: British Columbia sub contractorca.sk.sub.contractor: Saskatchewan sub contractorca.bc.contractor: British Columbia contractorca.sk.contractor: Saskatchewan contractorca.on.purchase: Ontario purchaseca.mb.farmer: Manitoba farmerca.ns.farmer: Nova Scotia farmerca.sk.farmer: Saskatchewan farmer
Anchor to European UnionEuropean Union
eu.reverse.charge: Reverse charge (EU/UK)
Anchor to United StatesUnited States
us.al.reseller: Alabama resellerus.ak.reseller: Alaska resellerus.az.reseller: Arizona resellerus.ar.reseller: Arkansas resellerus.ca.reseller: California resellerus.co.reseller: Colorado resellerus.ct.reseller: Connecticut resellerus.de.reseller: Delaware resellerus.dc.reseller: Washington DC resellerus.fl.reseller: Florida resellerus.ga.reseller: Georgia resellerus.hi.reseller: Hawaii resellerus.id.reseller: Idaho resellerus.il.reseller: Illinois resellerus.in.reseller: Indiana resellerus.ia.reseller: Iowa resellerus.ks.reseller: Kansas resellerus.ky.reseller: Kentucky resellerus.la.reseller: Louisiana resellerus.me.reseller: Maine resellerus.md.reseller: Maryland resellerus.ma.reseller: Massachusetts resellerus.mi.reseller: Michigan resellerus.mn.reseller: Minnesota resellerus.ms.reseller: Mississippi resellerus.mo.reseller: Missouri resellerus.mt.reseller: Montana resellerus.ne.reseller: Nebraska resellerus.nv.reseller: Nevada resellerus.nh.reseller: New Hampshire resellerus.nj.reseller: New Jersey resellerus.nm.reseller: New Mexico resellerus.ny.reseller: New York resellerus.nc.reseller: North Carolina resellerus.nd.reseller: North Dakota resellerus.oh.reseller: Ohio resellerus.ok.reseller: Oklahoma resellerus.or.reseller: Oregon resellerus.pa.reseller: Pennsylvania resellerus.ri.reseller: Rhode Island resellerus.sc.reseller: South Carolina resellerus.sd.reseller: South Dakota resellerus.tn.reseller: Tennessee resellerus.tx.reseller: Texas resellerus.ut.reseller: Utah resellerus.vt.reseller: Vermont resellerus.va.reseller: Virginia resellerus.wa.reseller: Washington resellerus.wv.reseller: West Virginia resellerus.wi.reseller: Wisconsin resellerus.wy.reseller: Wyoming reseller
Anchor to Tax calculation API schemaTax calculation API schema
In the tax calculation request, the exemptions are represented as an array of objects with a property called external_id whose value is one or more tax exemption codes.
If there are no exemptions for the customer or company location associated with the checkout, the API returns an empty array.
Anchor to Customer tax exemptionsCustomer tax exemptions
When tax exemptions are configured for the customer associated with the tax calculation request, they appear in the customer field of the buyer_identity section as an array:
Anchor to Company location tax exemptionsCompany location tax exemptions
When tax exemptions are configured for the company location associated with the tax calculation request, they appear in the purchasing_company field of the buyer_identity section:
Anchor to Tax summary webhook payload schemaTax summary webhook payload schema
The tax exemptions associated with the order are in the agreements section of the tax summary. This is because the exemptions could change over the lifecycle of the order. Each operation done on an order results in the creation of an agreement. Examples include placing an order, editing the order to add items, and performing a refund on the order.
Only agreements that trigger a request for tax calculation will have the exemptions in the tax summary. Agreements that are exclusively for refunds do not trigger a request for tax calculation, so they will not have tax exemptions in the tax summary.