Skip to main content

Error Codes

When interacting with our API, you may encounter one of the following errors. Below is a list of potential error codes to help you troubleshoot effectively, their corresponding HTTP status codes, and a description of each error scenario. Understanding these errors will help you troubleshoot issues more effectively.

Error Codes and Descriptions​

1. UNAUTHORIZED (Status Code: 400)​

  • Description: This error occurs when invalid credentials are provided to the API server.
  • Resolution: Ensure that your API credentials are correct and have the necessary permissions.

2. RESOURCE_NOT_FOUND (Status Code: 400)​

  • Description: This error is returned when a request is made for a product or transaction order that does not exist.
  • Resolution: Verify the requested resource's identifier and ensure it exists in the system.

3. PRODUCT_INACTIVE (Status Code: 400)​

  • Description: This error is returned when a request is made for a product that exists in our system but is temporarily inactive on the API platform.
  • Resolution: Check the SKU you are trying to purchase and verify that it appears in the list of products returned by the GetProducts API response.

4. BAD_REQUEST (Status Code: 400)​

  • Description: This error occurs when the input parameters of a request do not meet the required conditions.
  • Resolution: Review the request parameters to ensure they align with the API's expected input format and data types.

5. INSUFFICIENT_BALANCE (Status Code: 400)​

  • Description: This error is encountered when there is an attempt to create an order, but the client's balance is insufficient.
  • Resolution: Ensure sufficient funds are available before attempting to place an order.

6. UNSUPPORTED_CURRENCY (Status Code: 400)​

  • Description: This error occurs when a create order request is made with a product priced in a currency not supported by the user's account balance.
  • Example: If the user has a USD and CAD account balance but attempts to create an order with a EUR product.
  • Resolution: Use a product with a currency supported by your existing account balance.

7. INTERNAL_SERVER_ERROR (Status Code: 500)​

  • Description: This error is returned when an unexpected error occurs on the API server.
  • Resolution: These are server-side issues. Please wait and try your request again later. If the problem persists, contact our support team.

Each error code is designed to provide clear, actionable information to help you understand and resolve issues encountered while using our API.