Error Handling

Error Handling

The API uses standard HTTP status codes.

HTTP status	Description
400	Invalid input or malformed request
401	Invalid or missing authentication
404	Resource not found
409	Resource conflict
429	Too many requests
503	Service unavailable

Basic error example

{
  "success": false,
  "timestamp": "2026-01-23T23:33:55.685Z",
  "path": "/api/v1/payments",
  "method": "POST",
  "error": "Unauthorized",
  "message": "Unauthorized"
}