DOCS

Test Checkout integration

Learn how to test your Checkout integration.

Testing your Zonos Checkout integration is crucial to ensure that your online store is running smoothly, that customers can complete their transactions successfully, and that you are not losing sales due to technical issues.

Test your integration 

Follow the steps below to test your Checkout integration:

1

Test checkout window

The first step in testing Checkout is ensuring that when international shoppers attempt to place an order on your site, Checkout correctly shows up instead of your domestic checkout. To test this:

  1. Visit your website in a browser.
  2. If you have a VPN, you can use it to simulate visiting from another country. Otherwise, you can add ?zCountry=DE to the end of your URL to tell Checkout to treat you as a shopper from Germany. You can replace DE with any country code that you want to test.
  3. Add one or more items to your cart. Try to add enough items that the total value of your cart exceeds the de minimis value for the country you are testing.
  4. Once you are satisfied with the items in your cart, visit your cart page and click the button to checkout with your items.
  5. If Checkout is correctly configured, instead of seeing your domestic checkout, a window will open with your international checkout.
  6. Keep the Checkout window open as you will continue to use it for the rest of your testing.

Enable debug mode 

While you are testing, you may find it useful to enable debug mode on Checkout, enabling richer logging and error messages to help you diagnose any issues you encounter. To enable debug mode, add ?zonosDebug=true to the end of your URL when testing. If you are already using the ?zCountry=XX parameter, you can add &zonosDebug=true instead.

If you are working with Zonos Support on any Checkout related issues, having debug mode on when you take screenshots of the browser console can be extremely useful in diagnosing issues.

Book a demo

Was this page helpful?


Get support·Legal docs·© 2026 Zonos