Response Format
All API responses follow a consistent format:HTTP Status Codes
Common Errors
Authentication Errors (401)
- Missing
Authorizationheader - Invalid API key format
- Revoked or expired API key
Resource Not Found (404)
- Invalid resource ID
- Resource belongs to a different store
- Resource has been deleted
- Product is not published (for public endpoints)
Validation Errors (422)
- Missing required fields
- Invalid field format
- Business rule violations
Rate Limit Exceeded (429)
Handling Errors
JavaScript Example
PHP Example
Error Codes Reference
Checkout Errors
License Errors
Best Practices
Always Check Status Codes
Always Check Status Codes
Don’t assume success - always check the HTTP status code before processing the response.
Log Errors
Log Errors
Log error responses for debugging and monitoring purposes.
Show User-Friendly Messages
Show User-Friendly Messages
Translate API errors into user-friendly messages for your customers.
Implement Retry Logic
Implement Retry Logic
For 5xx errors and rate limits, implement automatic retry with exponential backoff.