BigCommerce Tariff API Integration Guide for International Stores
Chen Cui Co-Founder of GingerControl What changed: Rewritten: duty at checkout comes from a checkout app such as Zonos or Avalara through BigCommerce's Tax Provider API; GingerControl's part is the HTS code and the U.S. duty check in GingerLite. The invented API endpoint, export classification and volume claims are gone.
BigCommerce stores add duty at checkout through an app built for cross-border sales: Avalara's Cross-Border connects through BigCommerce's tax settings, and Zonos sends international shoppers to its own checkout. BigCommerce's Tax Provider API lets an outside tax engine quote each cart, but building your own provider means owning a duty source for every destination. What no checkout app can fix is a wrong HS code: the duty it quotes is only as good as the code and country of origin stored on each product. So set the codes carefully, and for U.S. imports check the duty for the entry date before you trust the number your checkout shows.
In this post
- What does BigCommerce give you natively?
- Which app should calculate duty at checkout?
- Why does the HS code decide whether the checkout number is right?
- How do you get the HS codes right for a BigCommerce catalog?
- How do you check the U.S. duty a checkout app shows?
- What should a BigCommerce store set up first?
- Frequently Asked Questions
- If your BigCommerce 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.
What does BigCommerce give you natively?
Two pieces of the platform matter for duty [1] [2]:
- The Tax Provider API. BigCommerce calls the tax engine you configure for four operations: estimate (a quote before payment), commit (once the order is confirmed and paid), adjust (returns, partial refunds and other changes after the order) and void (cancellations, full refunds, or an order moved back to unpaid). Its request carries line prices and tax classes, not HS codes or origins, so duty comes from apps built for it.
- Customs information on each product. BigCommerce stores each product's country of origin and its HS codes, one per destination country. Shipping apps and labels read them; check that your duty app reads them too.
BigCommerce supplies the plumbing. The app you connect decides what the shopper sees, and the codes you store decide whether its number is right.
Which app should calculate duty at checkout?
Duty at checkout is a full job of its own: rates for every destination you sell to, import VAT and similar taxes, low-value thresholds that differ by country, and labels that tell the carrier the duty is already paid. Apps built for cross-border checkout do this, and they are the honest pick:
- Zonos sells a guaranteed landed cost; on BigCommerce its app sends international shoppers to Zonos Checkout to finish the order. 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 sales tax; on BigCommerce it connects through the store's tax settings as Cross-Border by Avalara.
GingerControl does not calculate duty at checkout and has no BigCommerce connector. Here is who does what:
| Job | Who does it |
|---|---|
| Duty and import tax at checkout, for every destination | A checkout app such as Avalara (through tax settings) or Zonos (its own checkout) |
| The HS code and country of origin on each product | Your team, with your customs broker or a classification tool |
| Checking the U.S. duty for a code, origin and entry date | Your customs broker, or GingerControl's Tariff Calculator |
| Filing the U.S. entry | The carrier's broker or your own licensed customs broker |
Why does the HS code decide whether the checkout number is right?
Because every layer of U.S. duty hangs off the 10-digit code and the origin. Take steel bolts with nuts from China, HTS 7318.15.20: the base rate is Free, but Section 301 adds 25% (List 3) and Section 232 adds 50% on the full value, because fasteners are Annex I-A steel articles since April 6, 2026 [4]. That is 75% before fees. The forced-labor Section 301 that started on July 24, 2026 does not apply, because Section 232 articles are exempt from it [5].
Store a vaguer code for the same bolt, or the wrong origin, and the checkout app quotes a different number with full confidence. The app is doing its job; the input was wrong. Under U.S. law the importer of record has to use reasonable care in classifying goods [6], so the code is a compliance question, not only a pricing one, whoever quotes the duty.
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 [3], every U.S.-bound parcel goes through entry and pays whatever duty its code carries, whatever its value.
How do you get the HS codes right for a BigCommerce catalog?
Start where the money is:
- List the products that ship abroad most, and the ones made of more than one material or doing more than one thing. Those are where a guessed code costs most.
- Write down what the code depends on: material and its share, function, how it is used, and every component in a set or kit. A product title is rarely enough.
- Classify each one with its reasoning on record. For U.S. imports, GingerControl's Classification Researcher returns a 10-digit HTS code with the GRI reasoning behind it, and when your spec sheet leaves out a fact that decides the code, it asks. One classification takes 3 to 5 minutes with its full report, and it reads product descriptions in English or Chinese.
- Store the code and country of origin in BigCommerce's customs information for that product, so the checkout app and your labels use it.
- Have your customs broker review codes before they go on an entry. GingerControl's classifications are for general reference, educational and planning purposes.
How do you check the U.S. duty a checkout app shows?
Spot-check it against the rules for the entry date. 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, and it compares the same code across 200+ origin countries. It prices the layers in effect on the date you enter, and GingerControl updates the rates whenever the official rates change.
Two checks are worth a habit:
- After a rule change. On July 24, 2026 the forced-labor Section 301 replaced the expired Section 122 surcharge, at 10% or 12.5% depending on the economy [5]. Re-check your top sellers from each origin against your checkout quotes.
- When you switch suppliers. A new origin can change three layers at once.
Compliance Radar does the watching for you: it checks new U.S. trade notices against your own HTS codes and emails you what to redo by the effective date. The same steps for Shopify are in our Shopify duty and tax guide, and the checkout side in more depth is in adding tariff calculation to checkout.
For storefront margin monitoring, Compliance Radar for ecommerce sellers connects a policy change to the affected catalog items.
What should a BigCommerce store set up first?
| Step | Why |
|---|---|
| Pick one checkout app for duty and taxes | One source of truth at checkout, for every destination |
| Fill HS code and origin for every product that ships abroad | The app and the carrier read them |
| Ship duty-paid orders on DDP labels | Otherwise the carrier can bill the customer again at the door |
| Re-check top sellers after each U.S. rule change | Rates move by proclamation, not on a schedule |
| Keep each code's reasoning with the product | It is what you show a broker or CBP if a code is questioned |
Frequently Asked Questions
What is the best way to calculate duty at checkout on a BigCommerce store?
Use a cross-border checkout app: Avalara's Cross-Border connects through BigCommerce's tax settings, and Zonos, which sells a guaranteed landed cost, sends international shoppers to its own checkout. Writing your own tax provider only makes sense for a store with engineers and a duty source for every destination it sells to. GingerControl does not calculate checkout duty; it helps you set the HTS codes those apps read and check the U.S. duty for a given entry date.
Does a BigCommerce store need an HS code on every product?
Every product you ship across a border needs one. The duty app uses it to quote duty, the carrier puts it on the customs declaration, and since the U.S. de minimis suspension every U.S.-bound parcel pays whatever duty its code carries. BigCommerce stores each product's country of origin and HS codes, one per destination country, in its customs information.
Can GingerControl plug into BigCommerce checkout?
No. GingerControl has no BigCommerce connector and does not calculate checkout duty. Store owners use GingerLite: the Classification Researcher for each product's 10-digit code with its reasoning, the Tariff Calculator to check U.S. duty by entry date, and Compliance Radar for rule changes against their codes. The Classification + Tariff Calculation API is for enterprise systems and starts with a call.
How do Section 232 metal duties affect BigCommerce stores selling steel or aluminum products?
Since April 6, 2026, Section 232 metal duties apply to the full customs value: 50% for Annex I-A articles such as most goods of Chapters 72, 73 and 76, and 25% for Annex I-B derivatives. Listed articles outside Chapters 72, 73, 74 and 76 pay only when the metal is at least 15% of their weight. Check each such product's code and composition before you trust a checkout quote.
What changed for U.S.-bound parcels when de minimis ended?
Duty-free de minimis treatment was suspended for every country on August 29, 2025, and CBP rules published on June 24, 2026 suspended it indefinitely for every mode, postal included. Every U.S.-bound parcel now goes through entry and pays whatever duty its HS code carries, so a store selling into the U.S. needs a code and a duty quote on every order.
What does GingerLite cost a BigCommerce 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. Compliance Radar and the Parts Library are in the same app.
If your BigCommerce store sells into the U.S.
Let a checkout app quote duty for every destination, and make sure the codes it reads are right. GingerLite, the GingerControl app for small businesses and customs brokers, covers the U.S. side: the Classification Researcher for each product's code and its reasoning, the Tariff Calculator for the duty on an entry date, and Compliance Radar for rule changes. It is $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
- BigCommerce Developer documentation, Tax Provider API
Data cited: estimate, adjust, commit and void operations and when each runs; request fields
Source: BigCommerce Tax Provider API - BigCommerce Developer documentation, Customs Information API
Data cited: country of origin and HS codes per destination country stored for each product
Source: BigCommerce Customs Information - 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 - Proclamation 11021, Section 232 metals, 91 FR 18201
Data cited: duty on the full customs value from April 6, 2026; Annex I-A 50%, Annex I-B 25%; 15% weight rule outside Chapters 72, 73, 74 and 76
Source: Federal Register 2026-06960
Published: April 9, 2026 - 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; Section 232 articles exempt (9903.05.90)
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
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
