Real-Time DDP at Checkout: How a Tariff API Fits Into Cross-Border Landed Cost
Chen Cui Co-Founder of GingerControl What changed: Rewritten: DDP quotes at checkout come from checkout providers such as Zonos or Avalara; GingerControl's part is the U.S. side (HTS codes and the duty by entry date in GingerLite). The sub-second and 500 ms promises, unsourced conversion figures and the marketplace volume math are gone.
A real-time DDP checkout quotes the full landed cost, product, shipping, duty and import taxes, for the customer's destination before they pay, then ships the order with duty prepaid. The quote comes from a provider that covers every destination you sell to, such as Zonos or Avalara, or your platform's own duties feature. Speed comes from caching: the same product, origin and destination give the same answer until a rule changes, so most quotes are served from a cache and the provider is called only when something is new or a rate moved.
In this post
- Why did DDP become the default for U.S.-bound parcels?
- Who should quote landed cost at checkout?
- What does the checkout architecture look like?
- What happens when the cache misses?
- How do U.S. duty layers interact in a quote?
- What can a U.S. tariff API do at checkout, and what can't it?
- What did Section 122 change, and what replaced it?
- Frequently Asked Questions
- Putting DDP into your checkout
- References
If the order ships internationally from the U.S. through USPS, check USPS mailing-declaration item codes alongside the checkout provider’s classification data.
Why did DDP become the default for U.S.-bound parcels?
Because the U.S. stopped letting low-value parcels in duty free. De minimis was suspended for every country on August 29, 2025, and CBP rules published June 24, 2026 suspended it indefinitely for every mode, postal included [1]. Every U.S.-bound parcel now goes through entry and pays whatever duty its code carries. Either the merchant collects it at checkout and prepays it (DDP), or the customer meets it at the door (DAP), and some customers refuse the parcel when that happens.
For postal parcel intake, bulk HTS and tariff API for postal parcel operators connects sender descriptions to classification before dispatch.
Who should quote landed cost at checkout?
A provider built for every destination you ship to. A DDP quote needs each destination's tariff schedule, import VAT or GST, low-value thresholds, a currency, and often a guarantee that covers you if the quote is short. Checkout providers do exactly this:
- Zonos sells a guaranteed landed cost; 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 next to sales tax.
- Platform features, such as Shopify's duties and import taxes or Managed Markets, cover stores whose plan and destinations qualify.
GingerControl does not quote checkout landed cost. Its part is the U.S. side of the data the quote starts from, covered below.
What does the checkout architecture look like?
Cache first, provider on a miss:
Customer reaches checkout
|
v
Quote cache (key: product + origin + destination + rule version)
|
|-- hit: show duty and taxes from cache
|
'-- miss: call the checkout provider
|-- write the quote to cache
'-- show it, or fall back (below) if it is slow
The cache key is the set of inputs that decide the answer: your product ID mapped to its HS code, the country of origin, the destination, and a version you bump when a rule changes. For U.S. imports, Section 232 metal duties can also depend on where the steel or aluminum was melted and poured, so products that carry them need that in the key.
Invalidate on rule changes, not on a timer. When a new rule takes effect for a destination, clear the entries it touches. For the U.S., GingerControl's Compliance Radar checks new U.S. trade notices against your HTS codes and emails you what to redo by the effective date, which tells you which entries to clear.
Use personalized tariff alerts by HTS code to connect a new notice with the specific approved codes that need review.
What happens when the cache misses?
Three patterns work, and most stores move through them in order:
- Estimate now, refine later. Show an estimated duty on the first visit, call the provider in the background, and show the exact amount on the next step.
- DAP for products not yet quoted. Show DAP pricing with a clear note ("duties collected at delivery") and warm the cache for the next customer.
- Pre-warm. When a product or a destination is added, quote it before it goes on sale, so customers never hit a miss.
How do U.S. duty layers interact in a quote?
They stack, and the order matters. Two examples on entries on or after July 24, 2026:
- Cotton T-shirt from Germany (HTS 6109.10.00). Base rate 16.5%. The forced-labor Section 301 tops EU goods up to a combined 10%, which is already below 16.5%, so it adds nothing [2].
- Cotton T-shirt from China (same code). 16.5% base, 7.5% under Section 301 List 4A and 12.5% under the forced-labor Section 301: 36.5% in all [2].
The same product, the same destination, more than twice the duty, because of one field: the country of origin. That is why the origin and the code on each product matter as much as the provider you pick.
What can a U.S. tariff API do at checkout, and what can't it?
GingerControl's Classification + Tariff Calculation API takes a product description and its country of origin and returns a 10-digit HTS code with the U.S. duty layers in force when it is called: General, Special, Section 301, Section 232 metals and other Chapter 99 lines, as JSON [3]. It is for enterprise systems and starts with a call.
What it does not do, by design:
| Checkout need | U.S. tariff API | Checkout provider |
|---|---|---|
| Destinations other than the U.S. | No | Yes |
| Import VAT, GST or sales tax | No | Yes |
| Low-value thresholds by country | No | Yes |
| A guarantee on the quote | No | Zonos sells one |
| Pricing a past or future entry date | No: layers in force on the day of the call | Varies |
So it is not a checkout engine. For a store, the U.S. side is easier in GingerLite, the GingerControl app: the Classification Researcher for each product's 10-digit code with its GRI reasoning (3 to 5 minutes per product, report included), and the Tariff Calculator for every U.S. layer, MPF and HMF on the entry date you enter.
What did Section 122 change, and what replaced it?
The Supreme Court held on February 20, 2026 that IEEPA does not authorize tariffs [5], and a 10% Section 122 surcharge applied to goods entered from February 24 to July 23, 2026; a 15% rate was announced but never proclaimed [4]. Since July 24, 2026 the forced-labor Section 301 applies instead: 10% or 12.5% depending on the economy, or a top-up to a combined rate for the EU, Taiwan, Japan, South Korea and Switzerland [2]. If your cache still holds quotes from before July 24, 2026, many of them are wrong; re-quote them.
For a Japanese sourcing option, U.S. import tariffs and customs costs for Japan separates agreement treatment from customs fees and product-specific surcharges.
Frequently Asked Questions
How fast does a DDP quote need to be at checkout?
Fast enough that the customer sees duty before the payment step without the page stalling. Stores get there by caching quotes per product, origin and destination and calling the provider only on a miss, rather than by a fast provider alone.
Which providers quote DDP landed cost at checkout?
Checkout providers such as Zonos, which sells a guaranteed landed cost, and Avalara AvaTax Cross-Border, plus platform features such as Shopify's duties and import taxes. GingerControl does not quote checkout landed cost; its GingerLite app helps you set each product's U.S. HTS code and check U.S. duty for an entry date.
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.
Can GingerControl's API handle EU and UK origin codes?
Yes. The country_of_origin field takes ISO 3166-1 alpha-2 codes plus EU and UK, and GB is processed as UK; the optional steel and aluminum pour-country inputs follow the same rules. The API returns U.S. duty layers only, so it covers goods from those origins entering the United States, not goods shipped to them.
What should a store do when the cache misses during checkout?
Show an estimate and refine it in the background, show DAP pricing with a clear note for products not yet quoted, or quote each product before it goes on sale so misses never reach a customer. Most stores start with the first and end with the third.
Does a DDP quote include VAT and sales tax?
A checkout provider's quote usually does, for each destination. A U.S. tariff API such as GingerControl's returns U.S. import duty layers only, with no VAT, GST or sales tax.
What does the U.S. side cost with GingerLite?
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.
Putting DDP into your checkout
Pick a checkout provider that covers every destination, cache its quotes, and invalidate them when rules change. For the U.S. side, GingerLite gives you each product's HTS code with its reasoning, the duty on an entry date, and alerts when a new U.S. rule touches your codes. Open GingerLite. The step-by-step version for stores is in adding tariff calculation to checkout.
References
- 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, Notice of actions in the Section 301 investigations, 91 FR 47318
Data cited: forced-labor Section 301 from July 24, 2026, 10% or 12.5% by economy, EU topped up to a combined 10%; China 12.5% (9903.05.31) on top of the China lists
Source: Federal Register 2026-15181
Published: July 28, 2026 - GingerControl, Classification + Tariff Calculation API reference
Data cited: single and batch endpoints; country code rules including EU, UK and GB; steel and aluminum pour-country inputs; duty layers in force when called
Source: GingerControl API reference - Proclamation 11012, Section 122 surcharge, 91 FR 9339
Data cited: 10% on goods entered from February 24, 2026 through July 23, 2026
Source: Federal Register 2026-03824
Published: February 25, 2026 - Supreme Court of the United States, Learning Resources, Inc. v. Trump, No. 24-1287
Data cited: IEEPA does not authorize the President to impose tariffs
Source: Opinion of February 20, 2026
Published: February 20, 2026
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
