Restricted items

Understand how Zonos™ helps you manage your catalog’s restricted items for cross-border orders.

Decoding cross-border restrictions

Restricted or prohibited items typically fall into these categories:

Note that there is a difference between restricted and prohibited items:

Zonos Checkout experience

Zonos automatically manages item restrictions for your shoppers with the Zonos Checkout or API. Restrictions are only determined at the time of the shipping quote, because many items contain carrier restrictions.

Customization or additional item restrictions can be managed within the Zonos platform. When goods are deemed restricted, the Zonos Checkout will automatically remove the item(s) from the shopping cart, striking out the product description. Additional messaging is provided with a toast alert and below the item in the cart, informing the shopper of the restriction.

Restricted Item Sample


Before the shopper can complete their order, they are presented with a checkbox requirement to acknowledge that specific items have been removed from their cart.

Restricted Item Acknowledge


Upon order completion, the Zonos Order API will return all the items completed in the order; the restricted items will not be listed as an item for import. The Zonos plugins will correctly handle the order creation less the restricted item; however, if you have custom integration, we recommend retrieving items from the Zonos Order API to create the order and not create the order items from the customer’s checkout session. If (with your custom installation) you do not use the item detail from the Zonos API, then contact us to turn off restrictions on your Zonos Checkout.

Zonos may determine an item restriction from a harmonized (HS) code, country of origin, item category, item description, or all of the above.

For example, a t-shirt with an HS code of 6109.10 may not be restricted or prohibited into Barbados; however, if the t-shirt is camouflage, it is deemed illegal and will be confiscated by customs upon entry.

Zonos API

The Zonos API supports item restrictions for your checkout. The Shipping Quote API returns the JSON response for each item with the message to display for your shoppers and reason for the restriction.


"restrictedItems": [
    {
        "cartItemId": 1,
        "message": "We are unable to sell Leatherman products to your country.",
        "reasonCode": "BRAND_COUNTRY"
    }
  ],

Country import restrictions

Zonos supports selling to 220 countries, and each destination may have unforeseen restrictions on items in your catalog. Some countries are completely restricted for export from the US due to embargo or sanctions. This includes the embargoed/prohibited list of countries such as Cuba, Iran, North Korea, Syria, and Sudan. These countries are not supported or available in the Zonos Checkout or API.

Destination countries may also restrict or prohibit individual items as shown in the example of the camouflage t-shirt going to Barbados.

The US government also restricts selling to certain parties that appear on the Consolidated Screening Lists or Denied Party List. Restricted party screening is mandatory for companies of all sizes. Each violation is treated equally, regardless if the business is small, medium, or enterprise. Fines from $250,000 to $1 million as well as prison time could be applied. See how Zonos Checkout manages restricted party screening.

Brand restrictions

Some brands restrict the sale of their products to different countries due to international distributor agreements with exclusive distribution rights, or the brand may impose price protections by country/region. For instance, Leatherman has international distributors and has assigned exclusive distribution rights in certain foreign countries. These rights often include exclusive licensing of trademarks.

US export regulations

The US Export Control System oversees exports to protect the national security interests of the United States, promote foreign policy objectives, and comply with international commitments. With a program such as ITAR, penalties for violating the US Department of State’s Director of Defense Trade Controls may include fines and requirements to institute enhanced compliance measures within your company. Zonos Checkout can help manage these restrictions as well as self-imposed restrictions. Please contact us for more details on ITAR or custom restrictions necessary for your company.

Shipping carrier restrictions

UPS, FedEx, DHL, USPS, and other carriers each have different prohibited and restricted items for shipping internationally. For example, UPS restricts the shipping of snakeskin or mother of pearl. FedEx, on the other hand, restricts shipping watches valued over $1,000 USD. Carriers will classify other items as dangerous goods and may restrict these types of items (e.g. batteries). Additionally, country-specific import restrictions may vary by carrier. Size and weight restrictions are also managed by Zonos.

Getting set up

No setup is needed on your part to get the central benefits from Zonos restriction management. To get the full benefits of the service, we recommend a catalog that is harmonized. Zonos will do its best to dynamically harmonize your items at checkout based on the information in the cart. Also, if you have any custom rules, brand restrictions, or ITAR regulations, contact us for additional help with your setup.

Zonos recommends:

When integrating Zonos Order API, be sure to create the order from the items returned in the API and not from a session or a token. Creating the order from the API will allow for a safer and more scalable cross-border strategy for your eCommerce business.