The Paycrest API uses standard HTTP status codes and provides detailed error information to help you troubleshoot issues quickly.

HTTP Status Codes

CodeStatusDescription
200OKRequest successful
201CreatedResource created successfully
400Bad RequestInvalid parameters or request format
401UnauthorizedInvalid or missing API key
403ForbiddenInsufficient permissions for this action
404Not FoundResource not found
409ConflictResource conflict (e.g., duplicate order)
422Unprocessable EntityValidation failed
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error
503Service UnavailableNo providers available to handle the request

Error Response Format

All error responses follow a consistent format:

{
  "status": "error",
  "message": "Human-readable error description",
  "data": [
    {
      "field": "field_name",
      "message": "Specific validation error"
    }
  ]
}

Common Error Scenarios

400 Bad Request

  • Invalid parameters: Missing required fields, invalid formats
  • Unsupported combinations: Token/currency pairs not supported
  • Amount validation: Amounts outside provider limits
  • Provider issues: Provider not found or misconfigured

503 Service Unavailable

  • No provider available: When no providers can handle the specific request
  • Service temporarily unavailable: During maintenance or high load
  • Geographic restrictions: Service not available in your region

Handling Service Unavailability

When you receive a 503 error:

  1. Check request parameters: Verify token, amount, and currency combinations
  2. Try different amounts: Some providers have minimum/maximum limits
  3. Retry later: Provider availability may change over time
  4. Contact support: If the issue persists, reach out to our team

Getting Help

If you’re experiencing persistent errors:

  1. Check the error response for specific details
  2. Review our documentation for endpoint requirements
  3. Join our developer community on Telegram
  4. Contact support at [email protected]
  5. Report issues on GitHub

When reporting errors, please include the complete error response, request details, and your API key (with sensitive parts redacted).

The Paycrest API uses standard HTTP status codes and provides detailed error information to help you troubleshoot issues quickly.

HTTP Status Codes

CodeStatusDescription
200OKRequest successful
201CreatedResource created successfully
400Bad RequestInvalid parameters or request format
401UnauthorizedInvalid or missing API key
403ForbiddenInsufficient permissions for this action
404Not FoundResource not found
409ConflictResource conflict (e.g., duplicate order)
422Unprocessable EntityValidation failed
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error
503Service UnavailableNo providers available to handle the request

Error Response Format

All error responses follow a consistent format:

{
  "status": "error",
  "message": "Human-readable error description",
  "data": [
    {
      "field": "field_name",
      "message": "Specific validation error"
    }
  ]
}

Common Error Scenarios

400 Bad Request

  • Invalid parameters: Missing required fields, invalid formats
  • Unsupported combinations: Token/currency pairs not supported
  • Amount validation: Amounts outside provider limits
  • Provider issues: Provider not found or misconfigured

503 Service Unavailable

  • No provider available: When no providers can handle the specific request
  • Service temporarily unavailable: During maintenance or high load
  • Geographic restrictions: Service not available in your region

Handling Service Unavailability

When you receive a 503 error:

  1. Check request parameters: Verify token, amount, and currency combinations
  2. Try different amounts: Some providers have minimum/maximum limits
  3. Retry later: Provider availability may change over time
  4. Contact support: If the issue persists, reach out to our team

Getting Help

If you’re experiencing persistent errors:

  1. Check the error response for specific details
  2. Review our documentation for endpoint requirements
  3. Join our developer community on Telegram
  4. Contact support at [email protected]
  5. Report issues on GitHub

When reporting errors, please include the complete error response, request details, and your API key (with sensitive parts redacted).