Zonos Checkout for WooCommerce

After the beta phase, the extension will be available to download from the WooCommerce Marketplace.

Once you have installed the extension, follow the steps below to connect it to Zonos.

1. Log into WordPress Admin and click Zonos in the left hand navigation.

2. Click on General Settings.

3. Enter your credentials to link your Dashboard settings to your WooCommerce site.

   1. Locate your store's API key from Dashboard. There are a couple different API keys available. Select the API key that has your store's name, the Type is Private, and Token starts with credential_live. Input this API key as your Private API Key in General settings tab.

   2. Copy your Zonos account number from Dashboard and input this into the Store ID field.

4. Enable the app in test mode.

   1. By default, Test mode is toggled on. When test mode is enabled, shoppers will not be directed to Zonos Checkout.

5. Click Save general settings.

Customize Zonos to seamlessly integrate with your WooCommerce store, ensuring accurate duty, tax, and shipping calculations. Use the Mapping settings tab to align product details and attributes with your ecommerce setup. While default values are provided, you can configure these settings to suit your store’s unique requirements.

Product details, custom details, weight and dimensions

These fields are mapped to default common values. Values marked with an asterisk (*) are required. If you use a third-party app that overrides any (*) fields, ensure these (*) fields are mapped correctly to the values the third-party app uses.

Product attributes

If your products have unique attributes like color or size applied to variations, you'll need to map these attributes in the Zonos extension. This ensures that when an order is fulfilled, your WooCommerce store and inventory are updated with the correct product that was shipped. To map attributes:

1. List each attribute slug for your product variations, separated by a comma (,). Once you have entered your attributes, click Save mapping settings

   1. For example, if your variations include color and size, you would enter color,size.

2. Not sure where to find your product attributes? Follow these steps:

   1. In your WordPress Admin, click Products.
   2. From the left-hand navigation, click Attributes to view or manage your product attributes.

Note: If you have questions or need assistance mapping product variations, please contact support@zonos.com.

Now that you have set up your account and your app, you are ready to test your integration.

To place a test order at checkout:

1. Add ?zonosTestMode=1 to your store's URL to be directed to Zonos Checkout....
2. Change Zonos Hello to the country you would like to test. This is needed or else you will not be redirected to Zonos Checkout. You can also do this by changing zCountry= in the URL to what ever country you would like to test. For example, if you wanted to test Canada you would input CA in zCountry=CA.
3. After completing testing, enable Zonos by toggling Test mode to off.

Some things to remember:

• De minimis—If the cart subtotal of your order is under the ship-to country's de minimis, there may not be any duties or taxes due. This is reflected in our calculations.
• Refunds and cancellations—We are collecting the payment, so if you need to do any refunds or cancellations, please process these in Dashboard.
• Labels—Print labels for all international orders in Dashboard, unless you have been certified to print labels outside of Dashboard. This is required so Zonos can pay the duties and taxes on your behalf.

If a Zonos order has not imported into WooCommerce, you can use the Order import tab to manually import orders into WooCommerce:

1. Log into Dashboard.
2. Navigate to Orders.
3. Click into the order that needs to be imported and copy the Zonos order number.
4. In WordPress Admin, navigate to the Order import tab in the Zonos Extension, and enter the Zonos order number into the Zonos order number field.
5. Click Import order. If the order was successfully imported, the order will show in WooCommerce and you will see "Order imported successfully" banner at the top of the page. If the order failed to import, you will see a banner with the error message details.

If an order status in WooCommerce does not match the status in Zonos, you can manually sync the order.

1. Log into Dashboard.
2. Navigate to Orders.
3. Click into the order that needs to be imported and copy the Zonos order number.
4. In WordPress Admin, navigate to the Order sync tab in the Zonos Extension, and enter the Zonos order number into the Zonos order number field.
5. Click Sync order. The order status in WooCommerce should now match the order status in Dashboard.