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+)
| Domain | Area |
|---|---|
AUTH | Login, sessions, and tokens |
CHECKOUT | Completing orders at the till |
CLIENT | The POS app itself and local storage |
DISPLAY | The customer-facing display |
HOST | Hosting and firewall rules that block the POS |
LICENSE | Pro licence activation and validation |
PAYMENT | Payment gateways and terminals |
PRINT | Receipt printing |
PRODUCT | Product data and catalogue operations |
REGISTER | Cash drawer, register sessions, and counts |
SYNC | Synchronisation between the POS and your store |
Find your code below, or search for it.
Codes ending in 999 are the domain's catch-all for conditions that don't yet have a specific code.
Every code
AUTH: Login, sessions, and tokens
| Code | What it means |
|---|---|
| AUTH101 | Your session ended and you need to sign in again. |
| AUTH111 | The store did not accept the sign-in credentials. |
| AUTH121 | The signed-in store account does not match the cashier on this till. |
| AUTH131 | The saved store session was incomplete, so WCPOS returned to the store list. |
| AUTH201 | Your account does not have permission to perform this action. |
| AUTH301 | Another authentication plugin is preventing WCPOS from connecting. |
| AUTH311 | WCPOS can't reach its connection point on your store. |
| AUTH321 | WooCommerce is not active on this site, so WCPOS cannot connect. |
| AUTH331 | This store's WCPOS plugin is too old for this version of the app. |
| AUTH341 | This store reports the same identity as a store already saved on this device. |
| AUTH401 | A secure connection to this store could not be trusted. |
| AUTH411 | The store address is missing or not a valid URL. |
| AUTH421 | The store's server is blocking the login token on every channel this app can use. |
| AUTH431 | The store's REST API did not answer on any address form this app can use. |
| AUTH441 | The login token is larger than this server accepts. |
| AUTH999 | Signing in or staying signed in hit an unexpected problem. |
CHECKOUT: Completing orders at the till
| Code | What it means |
|---|---|
| CHECKOUT101 | Checkout did not finish, and the cart is still safe to retry. |
| CHECKOUT111 | This change could not be applied to the cart, which is unchanged. |
| CHECKOUT201 | WCPOS could not confirm whether checkout completed. |
| CHECKOUT211 | The store returned no checkout result, so the order status is unknown. |
| CHECKOUT301 | Checkout cannot continue because a product SKU is duplicated or invalid. |
| CHECKOUT401 | Your store's total for this order differs from what the till showed. The order is saved with the store's total. |
| CHECKOUT411 | A line on this order has price details the POS could not read, so its amount was taken from the stored totals instead. |
| CHECKOUT421 | This order refers to a tax rate your store no longer has, so its tax may be wrong. |
| CHECKOUT999 | Checkout hit an unexpected problem. |
CLIENT: The POS app itself and local storage
| Code | What it means |
|---|---|
| CLIENT101 | WCPOS could not finish starting. |
| CLIENT111 | Syncing is taking longer than expected to start. |
| CLIENT121 | This browser lets only one tab send changes at a time. |
| CLIENT131 | WCPOS queued too many requests at once and dropped some. |
| CLIENT141 | Search showed some results that don't match your products, so WCPOS hid them. |
| CLIENT142 | The search index did not answer in time, so WCPOS searched the catalogue directly instead. |
| CLIENT143 | Search was missing a product it should have found. |
| CLIENT144 | A search index rebuild failed, so results may be incomplete while the app retries initialization. |
| CLIENT151 | Part of the screen failed to load and was replaced by an error message. |
| CLIENT161 | This browser tab does not currently run the register, so it did not send a new payment request. |
| CLIENT171 | This device's clock and your store's clock are more than a minute apart. |
| CLIENT181 | WCPOS couldn't switch to that store. |
| CLIENT201 | This device ran out of memory, and the last action may not have finished. |
| CLIENT211 | WCPOS stopped because of a device-level crash. |
| CLIENT999 | WCPOS encountered an unexpected error. |
DISPLAY: The customer-facing display
| Code | What it means |
|---|---|
| DISPLAY101 | The customer display could not build the cart snapshot and shows the idle screen until the next change. |
HOST: Hosting and firewall rules that block the POS
| Code | What it means |
|---|---|
| HOST101 | The server is blocking the browser's permission check (CORS preflight), so the web app cannot reach it. |
| HOST111 | The server's cross-origin (CORS) configuration is broken, so the browser refuses its responses. |
| HOST121 | A bot-protection page is answering instead of the store's API. |
| HOST131 | A proxy in front of the store rejects the server's responses for having too many headers. |
| HOST141 | The host's security filter is blocking product searches. |
| HOST151 | Your host's cache can replay one person's store data to another. |
| HOST161 | The host is rate-limiting this store's tills. |
LICENSE: Pro licence activation and validation
| Code | What it means |
|---|---|
| LICENSE101 | Your WCPOS Pro license is not active for this store or device. |
| LICENSE201 | WCPOS Pro is disabled because its version does not match WCPOS. |
| LICENSE301 | The updater is not authorized to download WCPOS Pro updates. |
| LICENSE999 | License checking hit an unexpected problem. |
PAYMENT: Payment gateways and terminals
| Code | What it means |
|---|---|
| PAYMENT101 | Payment succeeded, but WCPOS could not refresh its status afterward. |
| PAYMENT111 | The store recorded this payment, but the till could not save its own copy. |
| PAYMENT113 | The store sent or cancelled the invoice, but this till could not save its copy of the order. |
| PAYMENT121 | The card was charged, but the order did not finish. |
| PAYMENT201 | WCPOS could not confirm whether the terminal charged the payment. |
| PAYMENT211 | The terminal did not take this payment. |
| PAYMENT212 | The gateway did not accept this payment. |
| PAYMENT213 | The store refused to record this payment. Nothing was taken. |
| PAYMENT221 | A payment could not be voided, so that money is still held. |
| PAYMENT301 | The selected payment gateway is unavailable for this store. |
| PAYMENT311 | WCPOS couldn't confirm whether this refund went through. |
| PAYMENT401 | The payment terminal did not finish pairing with WCPOS. |
| PAYMENT501 | The order had already been paid online, so the payment taken at the till is an additional one. |
| PAYMENT511 | More was taken at the till than the order still owed. |
| PAYMENT999 | Payment handling hit an unexpected problem. |
PRINT: Receipt printing
| Code | What it means |
|---|---|
| PRINT101 | Automatic printing did not start for this receipt. |
| PRINT201 | WCPOS could not confirm that the print job completed. |
| PRINT301 | The selected printer cannot be reached. |
| PRINT311 | This receipt could not be emailed or downloaded. |
| PRINT999 | Printing hit an unexpected problem. No sale is affected. |
PRODUCT: Product data and catalogue operations
| Code | What it means |
|---|---|
| PRODUCT101 | This product change hasn't reached your store yet. |
| PRODUCT111 | This variation could not be added to the product. |
| PRODUCT201 | This product image is unavailable, but the product can still be sold. |
| PRODUCT301 | No products matched the current search and filters. |
| PRODUCT321 | More than one product matches this barcode. |
| PRODUCT401 | The displayed stock may be older than the store stock. |
| PRODUCT411 | Barcode scanning settings could not be loaded, so scans may not match products. |
| PRODUCT421 | This product's variation price data could not be read, so displayed prices may be wrong or missing. |
| PRODUCT999 | Loading or updating products hit an unexpected problem. |
REGISTER: Cash drawer, register sessions, and counts
| Code | What it means |
|---|---|
| REGISTER101 | Your store refused a paid in, paid out or no sale that the till has already recorded. |
| REGISTER111 | Your store would not reverse a cash movement, so the original one still counts. |
| REGISTER201 | Your store refused to open this register session, so nothing is being counted against it. |
| REGISTER211 | Your store refused this register's count, so the session is still open there. |
| REGISTER212 | The drawer carry did not complete on this device. The store was not switched. |
| REGISTER221 | Another device already had this register open, so this till joined that session instead of starting its own. |
| REGISTER231 | This account can't open, count or close the register. |
| REGISTER301 | Your store would not accept the manager approval for this count, so the register is still open. |
SYNC: Synchronisation between the POS and your store
| Code | What it means |
|---|---|
| SYNC101 | WCPOS couldn't write a change to this device's storage. |
| SYNC111 | Some data stored on this device is damaged, so it can't sync. |
| SYNC121 | Your store can't be reached right now. |
| SYNC131 | Your store had an error and didn't finish this request. |
| SYNC141 | Your store asked WCPOS to slow down for a moment. |
| SYNC151 | Your store's reply had stray text in it, which WCPOS tried to clean up. |
| SYNC161 | This device's storage stopped responding, so saving is paused. |
| SYNC171 | WCPOS couldn't set up or remove storage on this device. |
| SYNC181 | Saving or loading on this device is very slow, and its outcome is not yet known. |
| SYNC191 | This change is still on its way to your store. |
| SYNC201 | Your store refused this change, so it hasn't reached the store. |
| SYNC202 | Your store refused this change, so this device went back to the store's version. |
| SYNC203 | Your store no longer has this order, so this device settled its own copy. |
| SYNC211 | Your store refused a value it was sent. |
| SYNC221 | A change on this device met a newer edit in your store. Nothing is lost. |
| SYNC222 | This device saved its version over a newer edit made in your store. |
| SYNC231 | Your store received this change, but this device couldn't record that it was sent. |
| SYNC301 | Your store's list of changes moved unexpectedly, so WCPOS is re-checking it by itself. Nothing is lost. |
| SYNC311 | Data on this device was saved by a different WCPOS version and can't be opened yet. |
| SYNC321 | Some data didn't sync this time. |
| SYNC331 | This device's copy of a record doesn't match your store's. Nothing you entered is affected. |
| SYNC341 | This store now requires a newer version of the POS app. |
| SYNC401 | A background sync task stopped unexpectedly before finishing. |
| SYNC411 | This device asked the store for data far more often than normal. |
| SYNC999 | Syncing hit an unexpected problem. |
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:
- Check the Troubleshooting section for more detailed guides
- Join our Discord community for support
- Report issues on GitHub