This “Retrieve an Order” API endpoint is used to retrieve data for a completed order inside the Zonos System. The response will contain a JSON object, representing all the available information for the order including billing and shipping addresses, shipping method, order totals, and status.
Retrieves a list of order numbers.
Retrieves detailed information for an order.
There are two common ways to use these endpoints.
orderDetailendpoint and import a completed order. In addition, regularly call the
orderNumbersendpoint to reconcile any orders in the Zonos System not imported into your system.
orderNumbersendpoint to determine when a new order is ready to be imported in your system. When an outstanding order is found, call the
orderDetailendpoint for the data on those orders.
Every time a buyer completes an order in the Zonos Checkout, they are immediately redirected to an order success page URL. The completed order ID will be appended to the redirect URL as a query string. The URL of the order success page should be provided to Zonos. The URL can also be passed as a parameter in the
createTempCart endpoint when creating the temporary cart in the Zonos System.
When a customer is redirected to this page, your system will need to parse the value for
orderId from the URL. You will then use the
orderId to call the
orderDetail endpoint to retrieve the order data.
In addition to calling for order details when the success page is triggered, we recommend you set up a scheduled call for all orders and their details as a catch-all. This way, you can retrieve any completed orders in the Zonos System that have not yet been imported into your system.
This process should be a scheduled job/script, such as a Cron job, ran once an hour/shift/day/etc. (schedule as often as your business processes deem necessary). The script should call for all orders and their details that have occurred since the last call for orders. The
orderNumbers endpoint allows you to retrieve orders
sinceDate as demonstrated on the API test GUI located here. All the orders retrieved through this scheduled call should then be reconciled against the orders inserted into your system each time the success page was triggered. Any orders not already in your system should be inserted into your system and treated as legitimate orders.
When calling the
orderDetail endpoint, we recommend that your system first checks the
orderStatus property of the order data.
Orders that do not require fraud review will initialize with
IGLOBAL_ORDER_IN_PROCESS. An order in this status is ready to be processed and shipped.
Orders that do require fraud review will initialize in
IGLOBAL_FRAUD_REVIEW. An order in this status is currently being screened and reviewed for suspected fraud. We recommend you place this order on a review or hold status in your system and continue to call the
orderDetail endpoint until the order progresses past Zonos’ fraud review process.
Once the Zonos fraud screening process is completed, the order will move to one of the following states:
Order passes fraud screening
IGLOBAL_ORDER_IN_PROCESSand can continue toward shipment.
Order fails fraud screening
IGLOBAL_ORDER_CANCELLEDand should be cancelled in your system.
Please contact Zonos for your account credentials.
See Zonospolicies and agreements.
Retrieve an order