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 get 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 weight can be stored in either Wix or Catalog (if entered in both, the weight from Catalog will be used). Wix does not store product information like HS codes, country of origin, and dimensions natively. If this information varies by product or if dimensional weight is a concern, store 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 brand, 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 the 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.
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: