REST status and error codes

The API key you specified in your request is invalid. There are three possible reasons for this error:

• You may have generated a new API key in your Paazl web app account and are still using an outdated key in your API request.
• Your webshop's (back-end) implementation may be altering the key when submitting a request to Paazl's authentication server.
• The combination of your credentials and Paazl environment is incorrect. e.g. Paazl staging credentials and sending to production.

The API secret you specified in your request is invalid. There are two possible reasons for this error:

• You may have generated a new API secret in your Paazl web app account and are still using an outdated secret in your API request.
• Your webshop's (back-end) implementation may be altering the secret when submitting a request to Paazl's authentication server.

You did not include a reference for the checkout session concerned. The reference attribute is included in the body of the request.

A postal code or country code you specified is invalid.

If a postal code or country code is invalid, Paazl will return an empty shipping option list.

A postal code is invalid if it doesn't occur within a postal code range defined for the country concerned in your webshop's delivery matrix.

A country code is invalid if, in that country's delivery matrix, a rate hasn't been set for an active shipping option.

Make sure you specify a permitted value for the tags element in your request. Permitted values are listed in the error message body.

The API key you specified in your request is invalid. There are three possible reasons for this error:

• You may have generated a new API key in your Paazl web app account and are still using an outdated key in your API request.
• Your webshop's (back-end) implementation may be altering the key when submitting a request to Paazl's authentication server.
• The combination of your credentials and Paazl environment is incorrect. e.g. Paazl staging credentials and sending to production.

Make sure you assign a value to the required attribute that is specified in the error message.

Postal code or country code is invalid.

If the postal code or country code is invalid, Paazl will return an empty pickup location list.

A postal code is invalid if it doesn't occur within a postal code range defined for the country concerned in your webshop's delivery matrix.

A country code is invalid if, in that country's delivery matrix, a rate hasn't been set for an active shipping option.

The API key you specified in your request is invalid. There are three possible reasons for this error:

• You may have generated a new API key in your Paazl web app account and are still using an outdated key in your API request.
• Your webshop's (back-end) implementation may be altering the key when submitting a request to Paazl's authentication server.
• The combination of your credentials and Paazl environment is incorrect. e.g. Paazl staging credentials and sending to production.

Make sure you assign a value to the required attribute that is specified in the error message.

Make sure you have provided a checkout session reference as a parameter in the URL that requests checkout details. For example:

https://api-acc.paazl.com/v1/checkout?reference=200000150

The shipping option you've tried to save with a checkout details session either doesn't exist or isn't available for your webshop. The most likely reasons for this error are:

• Your implementation is using a shipping option name that doesn't exist, perhaps because you are not taking the name directly from the list of available shipping options Paazl returned with the POST shippingOptions method
• You may have the shipping option concerned configured in Paazl's staging environment, but not (yet) in its production environment

You will find a list of the shipping options configured for your webshop under Carriers > Shipping options in your Paazl web app account. Contact Paazl Customer Support if you don't see a particular shipping option configured for your webshop.

You've tried to save a shipping option without having called the POST shippingOptions or POST pickupLocations first. These two calls ensure that the shipping options your customers can select conform to the shipping rules you configured in your Delivery Matrix.

If you want to change the shipping options Paazl returns to your webshop, change the configuration of your webshop's delivery matrix.

Make sure you assign a value to the required attribute that is specified in the error message.

The number you need to enter is the "customer number" (a.k.a. "Postnummer") that DHL PackStation issues to customers as identification when they pick up their orders from a DHL pickup location.

The API key you specified in your request is invalid. There are three possible reasons for this error:

• You may have generated a new API key in your Paazl web app account and are still using an outdated key in your API request.
• Your webshop's (back-end) implementation may be altering the key when submitting a request to Paazl's authentication server.
• The combination of your credentials and Paazl environment is incorrect. e.g. Paazl staging credentials and sending to production.

The API secret you specified in your request is invalid. There are two possible reasons for this error:

• You may have generated a new API secret in your Paazl web app account and are still using an outdated secret in your API request.
• Your webshop's (back-end) implementation may be altering the secret when submitting a request to Paazl's authentication server.

Your webshop does not have a checkout session with the reference value that is used in the query string. Make sure you query with an existing checkout session reference.

The order reference in your request already exists in your webshop. Make sure you give each order in your webshop a unique reference code.

The shipping option you tried to save with an order either doesn't exist or isn't available for your webshop. The most likely reasons for this error are:

• Your implementation is using a shipping option name that doesn't exist, perhaps because you are not taking the name directly from the list of available shipping options Paazl returned with the POST shippingOptions method
• You may have the shipping option concerned configured in Paazl's staging environment, but not (yet) in its production environment

You will find a list of the shipping options configured for your webshop under Carriers > Shipping options in your Paazl web app account. Contact Paazl Customer Support if you don't see a particular shipping option configured for your webshop.

You have not given a value to one or more required POST order attributes. Consult the REST API reference to see which non-address attributes are required for a POST order request.

Once an order has been scanned, you can no longer delete it. Check your web app account under Shipments > All shipments for a list of all your orders and their statuses.

An order with the reference you specified does not exist in the Paazl database. Check your web app account under Shipments > All shipments for a list of all the orders that you have saved to the Paazl database.