Zonos logo



Zonos Checkout for Magento

Learn about the Zonos Checkout plugin for Magento. 

This powerful cross-border solution enhances your international customers’ shopping experience while removing the pains ecommerce retailers face when selling cross-border.


  • Welcome international customers based on IP address with Zonos Hello upon site arrival.
  • Use your shipping carrier and shipping rate.
  • Allow customers to shop and settle in their local currency with Zonos Payments.
  • Get a complete landed cost at checkout (duties, taxes, & carrier fees).
  • Enable customers to complete checkout in their local language.

How it works

International customers add products to their cart (just like before) but will be redirected to Zonos Checkout to complete their order. The Zonos Checkout (designed to have your store’s look and feel), brings added functionality and flexibility not available with the Magento Checkout. Add your carrier rates and custom shipping rules with ease. Your customers can complete the checkout process in their local language with localized address fields. Take advantage of abandoned cart emails that also use language translation and add custom messages, delivery times, and more.

When the purchase is complete, you can choose to have that order imported into Magento or manage your orders from the Zonos Dashboard, where you can easily manage orders, print international shipping labels and custom documents, manage promo codes*, send email confirmations, and more.

Zonos can also take the worry out of international shipping compliance and fraud. Whether that may be handling item and country restrictions, notifying you of any possible matches against the consolidated screening list, or giving you the option of 100% fraud protection, Zonos keeps the control in your hands while mitigating the risk that can come with international sales.

Getting started

  1. Contact a Zonos Sales rep - Please reach out to us for information on how to get started. Once we get an agreement, you can begin the installation process.
  2. Installation - Install Checkout for Magento if you haven’t already.
  3. Landed Cost setup - Adjust how your landed cost is calculated.
  4. Shipment rating setup - Connect carriers, modify service levels, and customize calculated rates.


For Magento 2.0 and 2.1, you will need PHP 5.6 or greater.

For Magento 2.2 and 2.3, you will need PHP 7.0, whichever is compatible with your version of Magento.

You can find our Zonos Checkout app for Magento 2 on the Magento marketplace.

There are three options to install the Zonos Checkout module.

Option 1 - Web setup wizard (preferred method)

To install the app, follow the instructions from the Magento User Guide.

Option 2 - Install via Composer

Important - Installation with this method must be performed by an experienced Magento developer. Also, you MUST purchase the app on the Magento marketplace before proceeding with the steps below.

This option will install Zonos Hello as a dependency.

To install the app, (from your terminal) go to your <root magento dir>, then follow the steps below:

  • composer require zonos/checkout
  • php bin/magento module:enable Zonos_Checkout
  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile

To uninstall the app:

  • php bin/magento module:uninstall Zonos_Checkout
  • php bin/magento setup:di:compile

Option 3 - Download the extension

Important - You will not be able to run: php bin/magento module:uninstall Zonos_Checkout, because it was not installed through Composer. You will need Zonos Hello installed for the Zonos Checkout extension to work. If you have not downloaded Zonos Hello, follow the instructions below:

To install the Zonos Hello module:

  1. Go to the Magento marketplace.

  2. Search for “Zonos Hello”.

  3. Download the Zonos Hello app for Magento 2 extension.

  4. Extract the extension into the <root magento dir>/app/code/Zonos folder (create any folder that does not exist).

  5. From the command line, change the directory to your root Magento 2 directory.

  6. Run the following commands:

    • php bin/magento module:enable Zonos_Hello
    • php bin/magento setup:upgrade
    • php bin/magento setup:di:compile

To uninstall the Zonos Hello module:

  • php bin/magento module:disable Zonos_Hello
  • php bin/magento setup:di:compile

Once you have downloaded the Zonos Hello extension, you can now download the Zonos Checkout extension by following the steps below:

To install the Zonos Checkout module:

  1. Go to the Magento marketplace.

  2. Search for “Zonos Checkout”.

  3. Download the Zonos Checkout app for Magento 2 extension.

  4. Extract the extension into the root magento dir>/app/code/Zonos folder (create any folder that does not exist).

  5. Run the following commands:

    • php bin/magento module:enable Zonos_Checkout
    • php bin/magento setup:upgrade
    • php bin/magento setup:di:compile

To uninstall the Zonos Checkout module:

  • php bin/magento module:disable Zonos_Checkout
  • php bin/magento setup:di:compile

Checkout configuration

Please make sure you have created your Zonos account prior to setting your Magento 2 configuration.

Enable - This enables the Zonos Checkout app for your store.

Zonos API URL - The URL is automatically displayed.

Store ID Number - Find your Store ID at https://dashboard.zonos.com/settings/integrate.

Domestic Shipping Countries - Select the countries that you want to offer domestic shipping only. Zonos will not service these countries, and customers will use your checkout system.

Create Invoice on Import - Set to “Yes” by default. Zonos will create an invoice upon the order import. If you choose to disable this feature, you will need to create your own invoice, and Zonos will set a fraud review hold to a zonos_hold status. Once the fraud is lifted, we will revert to the previous status.

Customer Login - Set to “No” by default. If you want to require an account for checkout, select “Yes” from the drop-down menu. You will also need to select “No” for the “Redirect Customer to Account Dashboard after Logging In” option located in the Customer Configuration > Login Options section.

Cart Item Attribute Mapping - By default, Zonos will pull item weight, price, description, length, width, height, and country of manufacture (if available). This section contains open fields that your item info can be passed to bring over HS codes (if available) or any item level attributes that may be used by Zonos for special rules needed when calculating quotes.

Zonos Status Mapping - The Zonos order status is mapped to a corresponding Magento status. Although not recommended, those status mappings may be changed to the fields in the drop-down, if this is required for your order processing.

Hello configuration

Zonos Hello is added with the installation of the Zonos Checkout app. Be sure to follow the configuration instructions below for Zonos Hello.

  1. Obtain your Site Key at https://dashboard.zonos.com/settings/integrate.

  2. Go to your Magento Admin > Stores > Configuration > Zonos > Zonos Hello. 3 Configure the following options as instructed below:

    • Enable - This allows the Zonos Hello widget to display duty and tax quotes while customers visit your product pages.
    • Site Key - Enter your Zonos-provided site key obtained from Step 1.
    • Currency Conversion Selectors - If you want Zonos Hello to convert currency, paste your CSS selectors here. Multiple selectors are separated with a comma, e.g. .price,.__current-price,.__subtotal,.__original-price.
    • Hide Domestic Elements (OPTIONAL) - If you need or want to hide domestic elements for your international customers, input CSS selectors for elements you want to hide e.g. .nav-6,.action-add.

Essential information

When setting up your carriers and shipping levels in Zonos, make sure you are only allowing duty and tax to be calculated for the ones that allow duties and taxes to be prepaid and shipped DDP (Delivery Duty Paid). Otherwise, customers will prepay for those at checkout, but they could be charged again when the package is delivered.

For example, most UPS, DHL, and FedEx service levels support DDP options, but USPS does not. Please get in touch with your carrier representative to confirm if a DDP option is supported.

When an order is placed and duties and taxes have been prepaid, you need to ensure you send the package DDP. Some shipping software allows you to automate this by enabling specific rules.

For example, if the country is outside the US (and there is a tax amount), then send DDP.

Promo codes created in Zonos will transfer over to your Magento store. Promo code names MUST BE UNIQUE. If not, your promo codes will not be imported and you will notice discrepancies when orders get imported.

*For example, you cannot have a promo code named “CYBER” in Magento and then create a promo code that is also named “CYBER” in Zonos.