Error Codes
7.1 Format
Codes follow EQ-<DOMAIN>-<HTTP><SEQ>, e.g. EQ-SUB-4040001 (SUB domain, HTTP 404, sequence 0001). Domains: EQ-SUB- (subscription/gift/swap/prepaid/process-summary/items), EQ-INS- (instance & instance-attribute), and EQ-USR- (auth, security, generic validation). Each error response carries an error code and a human-readable message; auth/validation responses may also include a details array.
7.2 HTTP-status quick reference
| HTTP | Meaning in this service |
|---|---|
| 202 | Accepted / flagged for manual review (GIFT_HIGH_VALUE_REVIEW_REQUIRED) |
| 400 | Bad request / validation / malformed body / missing id |
| 401 | Authentication failure (token) |
| 402 | Payment failed (gift/swap/prepaid) |
| 403 | Insufficient permissions / unauthorized gift access |
| 404 | Resource not found / route not found |
| 409 | Conflict (already exists / already redeemed / out of stock) |
| 410 | Gone (gift/prepaid expired) |
| 422 | Business-rule violation (status, frequency, pause limits, etc.) |
| 429 | Rate/velocity limit (gift/swap) |
| 500 | Internal server error |
| 502 | Upstream failure (RENEWAL_CART_CHECKOUT_FAILED) |
7.3 Representative codes by group
Subscription core:
| Code | HTTP | Constant | When | Resolve |
|---|---|---|---|---|
| EQ-SUB-4040001 | 404 | SUBSCRIPTION_NOT_FOUND |
Subscription id not found | Verify id + instanceId |
| EQ-SUB-4220002 | 400 | SUBSCRIPTION_VALIDATION_FAILED |
Invalid create/update payload | Fix fields per schema |
| EQ-SUB-4220008 | 422 | SUBSCRIPTION_PAUSE_NOT_ALLOWED |
Pause on cancelled/completed | Only pause ACTIVE |
| EQ-SUB-4220012 | 422 | ANNUAL_PAUSE_LIMIT_EXCEEDED |
60 pause-days used in a year | Wait / resume |
| EQ-SUB-4220026 | 422 | INSTANCE_NOT_PROCESSABLE |
Instance not SCHEDULED/FAILED | Only process eligible instances |
| EQ-SUB-4220027 | 422 | RENEWAL_NO_ITEMS |
All items skip-next-order | Un-skip an item |
| EQ-SUB-5020028 | 502 | RENEWAL_CART_CHECKOUT_FAILED |
Cart Service checkout error | Retry; check Cart Service |
| EQ-SUB-5000016 | 500 | SUBSCRIPTION_INTERNAL_SERVER_ERROR |
Unexpected server error | Retry / check logs |
Gift / swap / prepaid (representative):
| Code | HTTP | Constant |
|---|---|---|
| EQ-SUB-4040101 | 404 | GIFT_NOT_FOUND |
| EQ-SUB-4090101 | 409 | GIFT_ALREADY_REDEEMED |
| EQ-SUB-4290101 | 429 | GIFT_PURCHASE_LIMIT_EXCEEDED |
| EQ-SUB-2020101 | 202 | GIFT_HIGH_VALUE_REVIEW_REQUIRED |
| EQ-SUB-4220201 | 422 | SWAP_NOT_ELIGIBLE |
| EQ-SUB-4290201 | 429 | SWAP_FREQUENCY_LIMIT_EXCEEDED |
| EQ-SUB-4040301 | 404 | PREPAID_PLAN_NOT_FOUND |
| EQ-SUB-4220302 | 422 | PREPAID_REFUND_NOT_ELIGIBLE |
Auth / generic (reused EQ-USR-):
| Code | HTTP | Constant |
|---|---|---|
| EQ-USR-4010001 | 401 | AUTH_TOKEN_MISSING |
| EQ-USR-4030004 | 403 | AUTH_INSUFFICIENT_PERMISSIONS |
| EQ-USR-4040184 | 404 | ROUTE_NOT_FOUND |
| EQ-USR-4000051 | 400 | INVALID_REQUEST_BODY_FORMAT |
| EQ-USR-4220024 | 422 | INVALID_PAGINATION |
The complete catalogue contains 100+ codes with their triggers and HTTP-status mapping.
Revision History
2026-08-05 | JP – Created the page and added the content.