Zonos logo
DOCS

Test your integration

/

Test your Checkout integration 

Follow these steps to test your Zonos Checkout integration.

Test shipping quotes 

  1. With Zonos enabled, go onto your website and impersonate an international shopper by changing the Zonos Hello flag to an international country that you plan to ship to. If the Hello flag is not present, add the following to the end of your URL to force it to appear: ?zCountry=CA
    1. If you do not sell internationally to Canada, replace “CA” in the string above with another country code for a country you do ship internationally to.
  2. Add item(s) to your cart. We recommend using a higher value to ensure that duties and taxes will be due for the order.
  3. Proceed to the checkout. You should be redirected to the Zonos Checkout page branded with your logo.
  4. Enter a valid international address. If you need to look up a valid address, use a random address generator. If you are using a carrier connection for shipping rates, you will need to use a real address or you won’t get quotes back.

If set up correctly, you will see shipping quotes along with duties and taxes in your shipping methods!

Place a test order on your site 

  1. Follow the steps above to generate an international checkout. Add the following:
    1. Use your own email address when entering the shipping information.
    2. If you have promo codes enabled in your Checkout settings, enter a promo code during this checkout to ensure it works properly.
  2. Complete the order by entering credit card information and clicking Place My Order.
    1. If you would like to use a test credit card, contact support@zonos.com or, if you are working with a Project Manager, reach out to them for a test credit card number.
    2. If you are using an iframe, you may need to take a few additional steps to place an order with test card information.

If Zonos was configured correctly, you should see the following:

  • You should immediately be taken to an order success page.
  • The order should appear in Dashboard → Orders within a few minutes.
  • The order should also appear in your ecommerce platform’s order page.
  • You should receive an order confirmation in your email inbox.

Test order flow through your systems 

Follow your test order through your systems for fulfillment, label printing, and finances to ensure there are no conflicts.

If you print your labels from Dashboard

  1. Confirm labels will generate successfully by printing a label. If you have multiple carriers enabled, print a label for each carrier. You can void your label after printing it, then use the same order to test more carrier’s labels.
    1. If you receive an error when printing a label in the Dashboard, learn how to resolve label errors.
  2. Confirm that you receive an email notifying you that the order has shipped.
  3. Once tested, void the label, then cancel and refund your test order.
  4. Confirm that you receive an email notifying you that the order has been cancelled.

If you print your labels outside of Dashboard

  1. There are several checkpoints that you will want to ensure are working correctly. Talk with your Professional Services Project Manager to complete the checkpoints below to ensure all information is flowing as it should.
    1. Shipping label generated uses the same shipping service level that was paid for.
    2. Labels are printed DDP/ DDU when appropriate.
    3. Zonos' Tax IDs appear on the commercial invoices when appropriate.
    4. The product information on the commercial invoice matches what Zonos used.
    5. Tracking information syncs back to Dashboard.
  2. Once tested, void the label, then cancel and refund your test order.
  3. Confirm that you receive an email notifying you that the order has been cancelled.

Test your website 

  1. Complete a checkout as a domestic customer (if needed, change the Hello flag back to your domestic country). Ensure that you get to your native ecommerce checkout instead of the Zonos Checkout.
  2. Check that information that only applies to your domestic customers is hidden from your international customers on product and cart pages.