Standalone reference page for global and module-specific business error codes.
← Back to API DocsSub codes are grouped by business module for faster troubleshooting and integration.
| Code Range | Module | Purpose |
|---|---|---|
| 40001-40111, 40401-40402, 50011 | Auth | Login/register, captcha/email code, password reset/change. |
| 40101-40301, 42901-42903, 50201, 50301 | Gateway | API key auth, credits check, rate limit, provider request failures. |
| 40021-40028, 40302, 40411, 50021-50023 | Payment | Checkout creation, order state checks, subscription cancellation. |
| Code | Name | Description | Recommendation |
|---|---|---|---|
| 200 | Success | Request processed successfully. | Use `data` for business payload. |
| 400 | Bad Request | Invalid parameters or business validation failed. | Check required fields, value ranges, and request format. |
| 401 | Unauthorized | Authentication failed (login required, missing/invalid API key). | Re-login or provide a valid `X-API-Key`. |
| 402 | Insufficient Balance | Insufficient balance or call quota for this request. | Recharge or upgrade your plan and retry. |
| 403 | Forbidden | You do not have permission or account status is restricted. | Check account status and endpoint permission. |
| 404 | Not Found | Requested resource does not exist. | Verify IDs/order numbers and whether data exists. |
| 429 | Rate Limit Exceeded | Request frequency exceeded per-second/per-hour/monthly limits. | Use retry with backoff or lower request frequency. |
| 500 | Internal Server Error | Server-side processing failed. | Retry later and contact support if it persists. |
| 502 | Service Temporarily Unavailable | The service request failed to be processed. | Please try again later. |
| 503 | Service Busy | System is busy or global protection limit is triggered. | Retry after a short wait. |
| Code | Name | Description | Recommendation |
|---|---|---|---|
| 40101 | Unauthorized Session | Login session is missing or invalid. | Login again. |
| 40102 | API Key Missing | API key is not provided. | Provide `X-API-Key` header or bearer token. |
| 40103 | API Key Invalid | API key is invalid. | Use a valid API key. |
| 40201 | Insufficient Balance | Insufficient balance or call quota. | Recharge or upgrade plan and retry. |
| 40301 | Account Frozen | Account is frozen or restricted. | Contact support to restore account. |
| 42901 | RPS Limit Exceeded | Per-second rate limit exceeded. | Reduce request burst and retry with backoff. |
| 42902 | RPH Limit Exceeded | Per-hour rate limit exceeded. | Lower request frequency. |
| 42903 | Monthly Quota Exceeded | Monthly call quota reached. | Upgrade plan or wait next cycle. |
| 50201 | Service Temporarily Unavailable | The service request failed to be processed. | Please try again later. |
| 50301 | Global Throttle Triggered | Global protection limit is triggered. | Retry after a short wait. |
| Code | Name | Description | Recommendation |
|---|---|---|---|
| 40001 | Invalid Captcha | Image captcha is invalid. | Refresh captcha and try again. |
| 40002 | Captcha Required | Captcha is required for this operation. | Submit captcha value. |
| 40003 | Email Exists | Email is already registered. | Use login or reset password. |
| 40004 | Email Code Invalid | Email verification code is invalid or expired. | Request a new email code. |
| 40005 | Password Too Short | Password length is below minimum requirement. | Use at least 6 characters. |
| 40006 | Token Invalid | Reset token is invalid or expired. | Request a new reset token. |
| 40007 | Invalid Plan Type | Plan type or plan name is invalid. | Use a valid plan from `/myapi/plans`. |
| 40008 | Email Code Cooldown | Verification code requested too frequently. | Wait for cooldown and retry. |
| 40111 | Invalid Password | Email/password verification failed. | Check credentials and retry. |
| 40401 | Email Not Found | Email does not exist. | Check email address or register first. |
| 40402 | User Not Found | User record does not exist. | Verify login state and user ID. |
| 50011 | Email Send Failed | Failed to send verification email. | Retry later. |
| Code | Name | Description | Recommendation |
|---|---|---|---|
| 40021 | Order Expired | Order has expired before payment. | Create a new order. |
| 40022 | Order Not Pending | Order is not in pending state. | Check order status before checkout. |
| 40023 | Subscription Card Only | Subscription mode only supports card payment. | Use `credit_card` payment method. |
| 40024 | Unsupported Payment | Payment method is not supported. | Choose a supported payment method. |
| 40025 | Order Not Paid Subscription | Only paid subscription orders can be cancelled. | Cancel only paid subscription orders. |
| 40026 | Not Subscription Order | Current order is not a subscription order. | Check billing mode before cancel request. |
| 40027 | Stripe Only Cancel | Subscription cancel endpoint only supports Stripe subscriptions. | Use Stripe subscription orders for this endpoint. |
| 40028 | Subscription ID Missing | Subscription ID is missing for this order. | Wait for webhook sync or retry later. |
| 40302 | Forbidden Resource | You do not own this resource. | Use the resource under your own account. |
| 40411 | Order Not Found | Order record does not exist. | Verify `order_no` value. |
| 50021 | Create Checkout Failed | Failed to create payment checkout session. | Retry later or use another payment method. |
| 50022 | Cancel Unsupported | Current provider does not support cancellation. | Use supported provider or contact support. |
| 50023 | Cancel Subscription Failed | Subscription cancellation failed. | Retry later; if persistent, contact support. |