Shopify Duty and Tax Calculator API Integration Guide
Chen Cui Co-Founder of GingerControl What changed: Rewritten: duty at checkout comes from Shopify's own duties feature, Managed Markets or a checkout app such as Zonos or Avalara; GingerControl's part is the HTS code and the U.S. duty check in GingerLite, not a checkout integration. The year is off the title.
Most Shopify stores do not need to build one. Shopify can collect duties and import taxes at checkout itself, Managed Markets can take the whole cross-border sale off your hands, and checkout apps such as Zonos or Avalara cover what those leave out. A custom integration only pays off for stores with engineers and a duty source for every destination. Whichever you pick, it calculates from the HS code and country of origin stored on each product, so the work that decides whether the number is right is the classification, not the calculator.
In this post
- What does Shopify calculate natively?
- When does a checkout app or a custom integration make sense?
- Why do HS codes decide the duty Shopify shows?
- How do you classify a Shopify catalog for U.S. imports?
- How do you check the duty after a U.S. rule change?
- Frequently Asked Questions
- If your Shopify store sells into the U.S.
- References
The cross-border shipping API integration guide separates classification and duty data from the carrier's booking and label functions.
If fulfillment uses USPS for outbound international orders, verify USPS item-code requirements before transferring product data to the label workflow.
What does Shopify calculate natively?
Shopify's own duties and import taxes feature shows duty and import tax at checkout for international orders, using the HS code and country or region of origin saved on each product [1]. Three things to know before you switch it on:
- Every product needs a code and an origin. Shopify reads them from the product's customs information; without an HS code it falls back to the product's description and category, and the quote is likely to be inaccurate [1].
- Ship duty-paid orders on DDP labels. Once duty is collected at checkout, buy DDP labels from a carrier that supports them; on a standard label the customer is charged duty again at delivery and pays twice [6].
- It has a fee and limits. Shopify charges a transaction fee on every order that has duties calculated at checkout, temporarily 0.5% since February 2, 2025 (normally 0.85% with Shopify Payments and 1.5% with other providers), and lists destinations and settings it does not support [1].
Managed Markets is the other native route: Shopify's partner Global-e acts as merchant of record for the international sale, collecting duties and import taxes, for a fee of 3.25% on Shopify Plus or 3.5% on other plans, for stores in the continental U.S. and some in Canada and the UK [7]. It is the least work, at the cost of handing over the cross-border sale.
When does a checkout app or a custom integration make sense?
When the native feature does not cover a destination you sell to, when you want a guarantee on the quote, or when your duty and tax setup already runs through another engine. Apps built for cross-border checkout are the honest pick here:
- Zonos sells a guaranteed landed cost at checkout; its pricing page states 2 USD plus 10% of the duties, taxes and other import fees, per order, typically paid by the shopper at checkout (read October 12, 2026).
- Avalara sells AvaTax Cross-Border, which estimates duties and import taxes alongside the sales tax many stores already run through AvaTax.
Building your own means owning a duty source for every destination, every threshold and every rate change. GingerControl does not calculate duty at checkout and has no Shopify app.
For a custom product-code feed, plan trade-compliance API integration around inputs and approval while keeping checkout quotes with the store's supported engine.
| Option | Best for | What you still own |
|---|---|---|
| Shopify duties and import taxes | Stores whose destinations and plan qualify | HS code and origin on every product |
| Managed Markets | Stores that want Global-e, as merchant of record, to run the cross-border sale | Product data; you give up control of that sale |
| Checkout app (Zonos, Avalara) | Guaranteed quotes, more destinations, existing AvaTax users | HS code and origin on every product |
| Custom integration | Stores with engineers and their own duty data | Everything, including every rate change |
Why do HS codes decide the duty Shopify shows?
Because U.S. duty is a stack of layers, and every layer depends on the 10-digit code and the origin. A cotton knit T-shirt from China, HTS 6109.10.00, carries 16.5% base duty, 7.5% under Section 301 List 4A and 12.5% under the forced-labor Section 301 that started on July 24, 2026: 36.5% in all [3] [4]. The same shirt coded as a synthetic-fiber shirt, or saved with the wrong origin, gets a different quote with the same confidence.
Since de minimis was suspended for every country on August 29, 2025, and suspended indefinitely by CBP rules published June 24, 2026, postal shipments included, every U.S.-bound parcel goes through entry and pays whatever duty its code carries, whatever its value [2]. The thresholds of other countries are in our de minimis by country guide. Under U.S. law the importer of record has to use reasonable care in classifying goods [5], so the code is a compliance question, not only a pricing one.
How do you classify a Shopify catalog for U.S. imports?
- List the products that ship abroad, for example from a product CSV export, and sort them by sales and by how many materials or functions each has.
- Collect what decides the code: fiber or material and its share, knit or woven, function, use, and every piece in a set.
- Classify each one with its reasoning on record. GingerControl's Classification Researcher returns a 10-digit HTS code with the GRI reasoning behind it, and asks when your description leaves out a fact that decides the code. One classification takes 3 to 5 minutes with its full report, and it reads descriptions in English or Chinese.
- Save the code and country of origin in each product's customs information, or in bulk with the bulk editor or the HS code CSV under Settings, Taxes and duties [8].
- Have your customs broker review codes before they go on entries. GingerControl's classifications are for general reference, educational and planning purposes.
How do you check the duty after a U.S. rule change?
U.S. duty moves by proclamation, not on a schedule. On July 24, 2026 the forced-labor Section 301 replaced the expired Section 122 surcharge, at 10% or 12.5% depending on the economy [4]. When something like that happens, check your top sellers from each origin against what checkout now shows.
GingerControl's Tariff Calculator takes an HTS code, a value and an entry date and shows the base rate, each Section 232 and Section 301 line, other Chapter 99 lines, MPF and HMF, across 200+ origin countries; GingerControl updates the rates whenever the official rates change. Compliance Radar checks new U.S. trade notices against your own HTS codes and emails you what to redo by the effective date. The same setup for BigCommerce is in our BigCommerce guide.
Frequently Asked Questions
What is the best duty and tax calculator for a Shopify store?
For most stores, Shopify's own duties and import taxes feature or Managed Markets, because they need no engineering. A checkout app such as Zonos, which sells a guaranteed landed cost, or Avalara AvaTax Cross-Border fits stores that need more destinations, a guarantee or an existing AvaTax setup. All of them calculate from the HS code and origin you save on each product.
Does Shopify need an HS code on every product to collect duties?
Yes for accurate quotes: Shopify calculates duties and import taxes from the HS code and country or region of origin saved in each product's customs information. Without an HS code it falls back to the product's description and category, which is likely to be inaccurate, and the carrier needs the same code on the customs declaration.
Do I still need DDP labels if duties are collected at checkout?
Yes. Once duty has been collected at checkout, buy DDP labels from a carrier that supports them; on a standard label the customer is charged duty again at delivery and pays twice.
Can GingerControl calculate duties at Shopify checkout?
No. GingerControl has no Shopify app and does not calculate checkout duty. Store owners use GingerLite to set each product's 10-digit HTS code with its reasoning (Classification Researcher), check U.S. duty for an entry date (Tariff Calculator) and get emails when a new U.S. rule affects their codes (Compliance Radar). The Classification + Tariff Calculation API is for enterprise systems and starts with a call.
A Shopify seller making a first formal entry can follow the first-time Shopify importer customs entry workflow for importer setup, broker engagement and shipment documents.
How should a Shopify store handle products with unclear descriptions?
Fill in the facts that decide the code before you classify: material and share, how it is made, what it does and what is in the box. GingerControl's Classification Researcher asks for a missing fact rather than guessing, and the case can pause while you ask your supplier and resume without starting over.
What does GingerLite cost a Shopify store?
The GingerLite app is $150 a month for 300 credits, with top-ups if you run out. Every classification and every Tariff Calculator run uses credits.
If your Shopify store sells into the U.S.
Let Shopify or a checkout app quote duty for every destination, and make sure the codes it reads are right. GingerLite covers the U.S. side: the Classification Researcher, the Tariff Calculator and Compliance Radar, for $150 a month for 300 credits. Open GingerLite.
For an enterprise system that needs codes and U.S. duty layers by API, the Classification + Tariff Calculation API starts with a call.
References
- Shopify Help Center, Duties and import taxes
Data cited: duties and import taxes calculated from each product's HS code and country or region of origin; fallback to description and category; transaction fee (0.5% temporarily since February 2, 2025; 0.85% or 1.5% normally); unsupported destinations
Source: Shopify Help Center, Charging duties and import taxes - U.S. Customs and Border Protection, interim final rule on de minimis, 91 FR 37789
Data cited: de minimis suspended for every country since August 29, 2025; suspended indefinitely for every mode, postal included, from June 24, 2026; a new postal informal-entry process from July 24, 2026 (91 FR 37801)
Source: Federal Register 2026-12670 and Federal Register 2026-12669
Published: June 24, 2026 - USTR, Section 301 List 4A rate reduced to 7.5%, 85 FR 3741
Data cited: List 4A at 7.5% from February 14, 2020
Source: Federal Register 2020-00904
Published: January 22, 2020 - USTR, Notice of actions in the Section 301 investigations, 91 FR 47318
Data cited: forced-labor Section 301 duties of 10% or 12.5% from July 24, 2026; China 12.5% (9903.05.31), stacked on the China lists
Source: Federal Register 2026-15181
Published: July 28, 2026 - 19 U.S.C. 1484, Entry of merchandise
Data cited: the importer of record classifies goods using reasonable care
Source: 19 U.S.C. 1484, Legal Information Institute - Shopify Help Center, Additional tasks for duties and import taxes
Data cited: DDP labels required once duties are charged at checkout; customers pay twice on standard labels
Source: Shopify Help Center - Shopify Help Center, Managed Markets overview
Data cited: Global-e is the merchant of record; 3.25% on Shopify Plus, 3.5% on Basic, Grow or Advanced; eligible store locations
Source: Shopify Help Center - Shopify Help Center, HS codes
Data cited: HS code and country of origin set in the bulk editor or by CSV under Taxes and duties
Source: Shopify Help Center
Shortlisting AI for trade compliance?
Hand this to GingerOS.
Pick a 30-minute slot on the next page with Chen Cui, our CEO. Bring one notice or one SKU list (an ERP export, a spreadsheet or an email will do) and see what GingerOS does with it.
Reviewed by Michael Weick, LCB / CCS
