Zonos Checkout integration

Introduction

The only required step to use Zonos™ Checkout is create a cart and post the items to the checkout. The second endpoint for retrieving orders is recommended, however not required. If you have limited capabilities to modify your platform, few international orders or limited development resources, you may opt to create a cart only and then retrieve orders manually. Changing or updating orders via the API is also not required even if you create carts and retrieve orders via the Hosted Checkout APIs.

Zonos Checkout API’s

Our service-oriented architecture the following REST API’s for integrating our Hosted Checkout.

  1. Create a checkout
  2. Retrieve an order
  3. Update an order

Passing a cart to Zonos

Integration with Zonos’ technology allows you to direct customers to a customized international checkout for an optimal buying experience. There are two main ways of accomplishing this. The Zonos JS (JavaScript) integration is a quick, javascript-based solution that makes it easy to pass a customer’s cart contents (and the customer) to our checkout. The API integration provides additional security and allows for added data to be passed.

Zonos JS integration

Zonos JS is the simplest and quickest method of integration. Our development team will assess your shopping cart structure and create a customized javascript that will:

When the custom JS script is made ready for you, it will need to be installed in the head or body of the HTML on your shopping cart page.

API integration

We want to make it both simple and secure to integrate with the Zonos Checkout. An API integration uses HTTPS to connect to the Zonos server with basic request parameters to pass data to pass over individual product details with integrity.

Retrieving orders from Zonos

Collecting orders from Zonos after they have been placed can be done by RESTful API or by International Order Notification. Calling the API quickly and automatically fetches each order from Zonos. It is the automated method for retrieving orders. In cases where developers aren’t available or for cases with very low international order volumes, the International Order Notification service is available. In short, International Order Notification is a service that sends an email out informing you of each international order along with its contents and customer information. The orders will then need to be manually enter into your system by one of your employees.

International Order Notification service

The International Order Notification service sends an email to the email address(es) of your choice upon receipt of an approved international order. The email contains all pertinent information about the order, including product details, customer shipping information and customer billing information. To opt in for this service, simply reach out to us.

Other resources

Contact Zonos if any of the above services does not match your needs. We are happy to assess the integration outcome you desire and if Zonos can supply a service that meets your requirements.

Zonos Hello - Welcome your international buyers

You can learn more about Zonos Hello here.

International shipping documentation

When you have completed the integration with Zonos, we recommend updating your international shipping policy to reflect the additional benefits now available to your customers.

Merchant usage policies

The use of any/all Zonos services, tools and/or technologies implies agreement to the Zonos Usage Policies, as outlined here.