Error Codes

A list of error codes that may occur during API requests. Use the code field in error responses to identify and handle error types appropriately.

Error Response Format

{
  "success": false,
  "code": "PROJECT_INVOICE_NOT_FOUND",
  "message": "Invoice not found"
}

Authentication errors are returned when the request headers are missing, invalid, or expired.

{
  "success": false,
  "code": "",
  "message": "Invalid signature"
}

Message	Description
`X-Client-Key header is required`	Missing `X-Client-Key` header
`X-Timestamp header is required`	Missing `X-Timestamp` header
`X-Signature header is required`	Missing `X-Signature` header
`Invalid client key`	Client Key not found or inactive
`API key has expired`	API Key has expired
`Project is not active`	Associated project is inactive
`Invalid signature`	Signature verification failed
`Invalid timestamp format`	Timestamp is not a valid number
`Request timestamp is too old or too far in the future`	Timestamp exceeds ±5 minute window

Code	Message
`VALIDATION_ERROR`	Request parameter format or value is invalid
`PAYMENT_INVALID_AMOUNT`	Invalid payment amount
`TOKEN_QUOTE_NOT_CONFIGURED`	Token does not have a quote symbol configured
`TOKEN_PRICE_NOT_AVAILABLE`	Token price data is not available
`PAYMENT_ROUTER_NOT_FOUND`	Payment router not configured for the specified chain

Code	Status	Message
`PROJECT_INVOICE_NOT_FOUND`	404	Invoice not found
`PROJECT_INVOICE_ALREADY_CONFIRMED`	400	Invoice has already been confirmed
`PROJECT_INVOICE_EXPIRED`	400	Invoice has expired
`PROJECT_INVOICE_NOT_PENDING`	400	Invoice is not in pending status

Code	Message
`UNKNOWN_ERROR`	An unknown error occurred

info

If server errors persist, please contact support@oozoo.com.