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
| 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
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
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
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
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
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 | 38 codes | Server communication, authentication, plugin issues |
| DB | 9 codes | Local data storage and retrieval |
| PY | 6 codes | Payment processing |
| SY | 5 codes | Device resources and configuration |
Need More Help?
If you're still experiencing issues after following the troubleshooting steps:
- Check the Troubleshooting section for more detailed guides
- Join our Discord community for support
- Report issues on GitHub