Checkout for Magento

Within 24 hours of signing up, a dedicated onboarding representative will contact you to kick off a tailored integration process.

Important: The steps listed below are for your reference and you will be guided through them by your onboarding representative.

In order to use Checkout with Magento, you need to purchase the extension from the Magento Marketplace, then install it in your terminal with Composer. This approach is more technical than our other plugins due to the way that Magento handles extensions. To install the app:

1. Download the Checkout extension from the Magento Marketplace.
2. Download the Hello extension from the Magento Marketplace.
3. Open a new terminal and navigate to the root directory of your Magento installation and follow the instructions below.

Run the following command to add Checkout to your site's dependencies. Hello will be automatically included.

composer require zonos/checkout

Next, run the following command to enable the Checkout module.

php bin/magento module:enable Zonos_Checkout

Now, run the following command to install the extension and perform any required database migrations.

php bin/magento setup:upgrade

Finally, run the following command to compile a new version of your site including the Checkout plugin.

php bin/magento setup:di:compile

Note: Checkout has a dependency of Hello, so the commands above will install both.

1. Go to your Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout.
2. Copy your Zonos API key from Dashboard and input it as your Service token.
3. Copy your Zonos account number from Dashboard and input it as your Store ID number.
4. In Domestic shipping countries, click to highlight all of your domestic countries.
5. Under Cart item attribute mapping, choose the information that you would like to map. By default, Zonos will pull item weight, price, description, and country of manufacture (if available). This section contains open fields that your item info can be passed to bring over HS codes, length, width, height or any custom item level attributes that may be used by Zonos for special rules needed when calculating quotes.

When you configure your Checkout app in Magento, you will also need to make a few changes to your Magento General settings.

1. Go to your Magento admin -> Stores -> Configuration -> General.
2. In the Allow countries section, highlight all countries that you want to ship to, internationally and domestically. If a country is not highlighted here, but is enabled in Zonos, the order will be allowed to complete and will appear in Dashboard, but it will fail to import to Magento.
3. Zonos also recommends you select every country except for the United States in the Zip/postal code is optional for section. This reduces errors in completing orders since some countries do not use or require postal codes. Additionally, because Checkout comes with Zonos' fraud protection, you will not incur additional risk for removing this requirement.

Hello is added with the installation of the Checkout app. Follow the configuration instructions below for Hello.

1. Go to your Magento admin -> Stores -> Configuration -> Zonos -> Zonos Hello.
2. Copy your Hello site key from Dashboard and input it as your Site Key.
3. If you want Hello to convert currency, paste your CSS selectors in the Currency conversion selectors field. Multiple selectors are separated with a comma, e.g., .price,.__current-price,.__subtotal,.__original-price.
   1. If your store's base currency is not USD, tell Hello your store's base currency in Dashboard -> Hello.
4. If you need to Hide domestic elements for your international customers, input CSS selectors for elements you want to hide, e.g., .nav-6,.action-add.

Optional—The following settings are advanced settings. Defaults are in place, so no action is needed. If you would like to make adjustments, follow these guidelines:

1. Go to your Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout.
2. Adjust according to your preference:
   1. 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.
   2. Customer login—Set to No by default. If you want to require an account for checkout, switch to Yes. You will also need to go to Customer configuration -> Login options and update Redirect Customer to Account Dashboard after Logging In to No.

Product information can impact the amount of duties and taxes due and the shipping cost. The more product information you provide to Zonos, the more precise the quote returned will be. Zonos can generate a quote even when this information is unavailable, but recommends providing the following key product details to improve accuracy:

• Weight: Weight impacts your shipping cost, which can affect duties or taxes. Weights in your Magento product listings are automatically used by Zonos when present.
• Dimensions: Dimensions may impact your shipping cost, which can affect duties or taxes. Zonos can utilize product dimensions (length, width, and height) set on each product in Magento, but you must map it in the Zonos app for proper integration.
• HS codes: HS codes impact duty rates and can sometimes affect taxes. Zonos can use the HS codes set in your product listings in Magento, but you must map the HS code field in the Zonos app.
• Country of origin: A product's country of origin impacts duty rates and may affect taxes. The country of origin set in your Magento product listings is automatically used by Zonos when present.

Product details passed to Zonos by Magento

Note: Alternatively, you can enter the info into Catalog, overriding the information stored and passed from Magento.

Learn more about product info by platform.