Skip to main content
Version: 2.x

Error Codes

When WCPOS encounters an issue, it displays an error code that helps identify the problem. From v1.10.0, codes follow the format domain + three digits — for example SYNC131 or AUTH311. The domain names the area of the POS; the number identifies the specific condition. Every code has its own page with what it means, what to do, and what it means for your data.

In the POS, error codes appear in Store health → Logs: expand a row and use the Help link to jump straight to the code's page here.

Error Domains (v1.10.0+)​

DomainAreaExamples
AUTHLogin, sessions, and tokensAUTH101, AUTH311
CHECKOUTCompleting orders at the tillCHECKOUT101, CHECKOUT201
CLIENTThe POS app itself and local storageCLIENT101, CLIENT201
DISPLAYThe customer-facing displayDISPLAY101
HOSTHosting and firewall rules that block the POSHOST101, HOST121
LICENSEPro licence activation and validationLICENSE101
PAYMENTPayment gateways and terminalsPAYMENT101, PAYMENT301
PRINTReceipt printingPRINT101, PRINT301
PRODUCTProduct data and catalogue operationsPRODUCT101, PRODUCT401
REGISTERCash drawer, register sessions, and countsREGISTER101, REGISTER211
SYNCSynchronisation between the POS and your storeSYNC101, SYNC121, SYNC311

Use the sidebar to browse every code in a domain, or search for the code directly.

Codes ending in 999 are the domain's catch-all for conditions that don't yet have a specific code.

Codes from before v1.10.0​

Codes such as API04001 come from versions before v1.10.0; this version never produces them. You may still see one in a log entry kept from before you upgraded, or in an old support thread. Switch the version menu to 1.x to look them up.

Need More Help?​

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

  1. Check the Troubleshooting section for more detailed guides
  2. Join our Discord community for support
  3. Report issues on GitHub