# Error Codes

When WCPOS encounters an issue, it displays an error code that helps identify the problem. Each error code follows the format `[DOMAIN][CATEGORY][SPECIFIC_CODE]` to help you quickly understand the type and nature of the error.

## Error Code Format[​](#error-code-format "Direct link to Error Code Format")

| Component         | Description           | Example                   |
| ----------------- | --------------------- | ------------------------- |
| **Domain**        | The system area       | `API`, `DB`, `PY`, `SY`   |
| **Category**      | The error category    | `01`, `02`, `03`, etc.    |
| **Specific Code** | The unique identifier | `001`, `002`, `003`, etc. |

**Example:** `API04001` = API (domain) + 04 (response errors) + 001 (invalid response format)

***

## Error Domains[​](#error-domains "Direct link to Error Domains")

### [API Errors](/error-codes/api.md)[​](#api-errors "Direct link to api-errors")

API errors occur when communicating with your WooCommerce server.

| Category         | Code Range | Description                                  |
| ---------------- | ---------- | -------------------------------------------- |
| Connection       | API01xxx   | Network and connectivity issues              |
| Authentication   | API02xxx   | Login, tokens, and permission issues         |
| Request          | API03xxx   | Problems with outgoing requests              |
| Response         | API04xxx   | Problems with server responses               |
| Plugin/WordPress | API05xxx   | Issues with WordPress or WooCommerce plugins |
| Configuration    | API06xxx   | Setup and configuration problems             |

### [Database Errors](/error-codes/db.md)[​](#database-errors "Direct link to database-errors")

Database errors occur when storing or retrieving data locally.

| Category   | Code Range | Description                                |
| ---------- | ---------- | ------------------------------------------ |
| Connection | DB01xxx    | Database connection and transaction issues |
| Data       | DB02xxx    | Record and constraint issues               |
| Query      | DB03xxx    | Query syntax and data type issues          |

### [Payment Errors](/error-codes/py.md)[​](#payment-errors "Direct link to payment-errors")

Payment errors occur during checkout and payment processing.

| Category | Code Range | Description                          |
| -------- | ---------- | ------------------------------------ |
| Card     | PY01xxx    | Issues with the payment card         |
| Gateway  | PY02xxx    | Payment gateway communication issues |

### [System Errors](/error-codes/sy.md)[​](#system-errors "Direct link to system-errors")

System errors are related to device resources and system configuration.

| Category | Code Range | Description                            |
| -------- | ---------- | -------------------------------------- |
| Resource | SY01xxx    | Memory, disk, and permission issues    |
| Service  | SY02xxx    | Configuration and service availability |

***

## Quick Reference[​](#quick-reference "Direct link to Quick Reference")

Looking for a specific error code? Use the sidebar to navigate to the domain, or search for the code directly.

| Domain                     | Total Codes | Common Issues                                       |
| -------------------------- | ----------- | --------------------------------------------------- |
| [API](/error-codes/api.md) | 39 codes    | Server communication, authentication, plugin issues |
| [DB](/error-codes/db.md)   | 9 codes     | Local data storage and retrieval                    |
| [PY](/error-codes/py.md)   | 6 codes     | Payment processing                                  |
| [SY](/error-codes/sy.md)   | 5 codes     | Device resources and configuration                  |

***

## Need More Help?[​](#need-more-help "Direct link to Need More Help?")

If you're still experiencing issues after following the troubleshooting steps:

1. Check the [Troubleshooting](/support/troubleshooting/response-error.md) section for more detailed guides
2. Join our [Discord community](https://wcpos.com/discord) for support
3. Report issues on [GitHub](https://github.com/wcpos)