Integration

Errors

Understand the error responses returned by the crptoX API.

Error format

API errors use a consistent JSON structure.

Response JSON

{
  "error": {
    "code": "error_code",
    "message": "Error message."
  }
}

Returned when the API credentials are missing, invalid or expired.

401

unauthorized

Invalid or expired API credentials.

HTTP 401 JSON

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API credentials."
  }
}

Returned when the merchant exceeds the current API rate limit.

429

rate_limit_exceeded

Rate limit exceeded.

HTTP 429 JSON

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded."
  }
}

Returned when the request contains invalid or missing parameters.

HTTP 422 JSON

{
  "message": "The amount field is required.",
  "errors": {
    "amount": [
      "The amount field is required."
    ]
  }
}