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: The requested product list contains EUR-priced SKUs (e.g., from GetProducts). The client’s balances are USD and CAD, and the request does not include payWithCurrency. By default the system assumes payment in the product currency (EUR), which the client does not have; the request fails with UNSUPPORTED_CURRENCY.
  • 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.

8. PAIR_NOT_SUPPORTED (Status Code: 400)​

  • Description: This error is returned when the requested currency pair does not exist in our exchange rate table, even if the individual currencies are supported.
  • Resolution: Verify that both base and quote are valid, supported currencies and that an exchange rate for the requested pair is available. Use the Get Exchange Rates API to discover supported pairs or request a different pair.

9. SAME_CURRENCY_PAIR (Status Code: 400)​

  • Description: This error occurs when the requested base and quote currencies are identical. A currency pair must consist of two different currencies.
  • Resolution: Select different currencies for base and quote. For example, request USD→EUR instead of USD→USD.

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