Integrate
Follow these steps to integrate Checkout with your Wix store.
Contact a Sales Representative
Please reach out to us for information on how to get started. Once we have an agreement, you can begin the installation process.
Create a Zonos account
- Register for a Dashboard account.
- After registering, complete your account setup.
Install the Checkout block
Your Project Manager will handle the installation for you during the onboarding process. The block cannot be installed on your own. To allow Zonos to install on your behalf, please set up admin access for Zonos to makes changes to your Wix site.
Add product information
Product weights can be stored in either Wix or Catalog (if entered in both places, Zonos will use the weight from Catalog for calculations). Wix does not store product information like HS codes, country of origin, and dimensions natively, so this will need to be saved in Catalog. If this information varies by product or dimensional weight is a concern, save it in Catalog.
Styling
Optional—Zonos will install two international cart pages (one cart page for mobile and one for desktop) and a confirmation page on your site.
- International cart pages: The background of the international cart page will default to white. To update the background color to match your branding, go to Edit site → Pages and menu → Store pages → Cart page. Scroll down until you see the two international checkout cart pages and adjust as desired.
Please do not delete any elements on these pages without consulting with your Zonos Project Manager.
- International confirmation page: To edit the default order confirmation page that will be shown to international shoppers, go to Edit site → Pages and menu → Site Menu → Checkout complete and update as desired.
Test your integration
Now that you have set up your account and your block, you are ready to test the integration. Start by enabling test mode:
- In the Wix backend, click Edit site.
- Click on the blank space to the left of your cart button to locate a hidden Hello flag.
- Toggle Use Zonos to enabled.
- Under Code packages, expand eitanwaxman → zonos → zonos-config.json.
- Set
environment
tolog
.
When in test mode, Zonos will only redirect if &zonos=true
is entered at the end of the URL. You can add this to each page while you test to view how the Zonos block will behave once live.
Now that you are in test mode, you are ready test your integration.
For advanced testing, create a Wix test site to test as a shopper by clicking the dropdown arrow next to Publish then Create test site. Paste the test site URL into a new incognito window.
Turn Zonos live
Upon successful testing, you are ready to go live:
- In the Wix backend, click Edit site.
- Click on the blank space to the left of your cart button to locate the hidden Hello flag.
- Toggle Use Zonos to enabled.
- Under Code packages, expand eitanwaxman → zonos → zonos-config.json.
- Set
environment
tolive
. - Click Publish.
Checkout example
Below is an example of the checkout page your international customers will see. Your page will have your branded logo and colors.

Frequently asked questions
How can I verify the correct store ID and API key are being used in the Wix block?
These credentials are entered by Zonos when installing the app. To confirm these credentials are correct:
- In the Wix dashboard, go to Developer tools → Secrets manager.
- Confirm the Store ID in Wix matches your Zonos account number in Dashboard → Settings → Integrations.
- Confirm the API key in Wix matches your Rest API key in Dashboard → Settings → Integrations.
What product details are recommended and passed to Zonos from Wix?
While Zonos can generate quotes with very little product information, providing additional details enhances the accuracy of our calculations. However, due to constraints in retrieving data from the Wix platform, Zonos may not receive certain information due to platform availability.
Zonos recommends providing the key product details listed below to improve accuracy, identifying which details Wix can pass versus what needs to be mapped or added to Zonos Catalog.
- Weights - Received from Wix.
- Dimensions - Not received, needs to be added with Catalog.
- HS codes - Not received, needs to be added with Catalog.
- Country of origin - Not received, needs to be added with Catalog.
Checkout for Wix
Integrate Checkout with your Wix store.
Before integrating Zonos Checkout with your site, please make sure you are familiar with how it works: