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+)​

DomainArea
AUTHLogin, sessions, and tokens
CHECKOUTCompleting orders at the till
CLIENTThe POS app itself and local storage
DISPLAYThe customer-facing display
HOSTHosting and firewall rules that block the POS
LICENSEPro licence activation and validation
PAYMENTPayment gateways and terminals
PRINTReceipt printing
PRODUCTProduct data and catalogue operations
REGISTERCash drawer, register sessions, and counts
SYNCSynchronisation 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​

CodeWhat it means
AUTH101Your session ended and you need to sign in again.
AUTH111The store did not accept the sign-in credentials.
AUTH121The signed-in store account does not match the cashier on this till.
AUTH131The saved store session was incomplete, so WCPOS returned to the store list.
AUTH201Your account does not have permission to perform this action.
AUTH301Another authentication plugin is preventing WCPOS from connecting.
AUTH311WCPOS can't reach its connection point on your store.
AUTH321WooCommerce is not active on this site, so WCPOS cannot connect.
AUTH331This store's WCPOS plugin is too old for this version of the app.
AUTH341This store reports the same identity as a store already saved on this device.
AUTH401A secure connection to this store could not be trusted.
AUTH411The store address is missing or not a valid URL.
AUTH421The store's server is blocking the login token on every channel this app can use.
AUTH431The store's REST API did not answer on any address form this app can use.
AUTH441The login token is larger than this server accepts.
AUTH999Signing in or staying signed in hit an unexpected problem.

CHECKOUT: Completing orders at the till​

CodeWhat it means
CHECKOUT101Checkout did not finish, and the cart is still safe to retry.
CHECKOUT111This change could not be applied to the cart, which is unchanged.
CHECKOUT201WCPOS could not confirm whether checkout completed.
CHECKOUT211The store returned no checkout result, so the order status is unknown.
CHECKOUT301Checkout cannot continue because a product SKU is duplicated or invalid.
CHECKOUT401Your store's total for this order differs from what the till showed. The order is saved with the store's total.
CHECKOUT411A line on this order has price details the POS could not read, so its amount was taken from the stored totals instead.
CHECKOUT421This order refers to a tax rate your store no longer has, so its tax may be wrong.
CHECKOUT999Checkout hit an unexpected problem.

CLIENT: The POS app itself and local storage​

CodeWhat it means
CLIENT101WCPOS could not finish starting.
CLIENT111Syncing is taking longer than expected to start.
CLIENT121This browser lets only one tab send changes at a time.
CLIENT131WCPOS queued too many requests at once and dropped some.
CLIENT141Search showed some results that don't match your products, so WCPOS hid them.
CLIENT142The search index did not answer in time, so WCPOS searched the catalogue directly instead.
CLIENT143Search was missing a product it should have found.
CLIENT144A search index rebuild failed, so results may be incomplete while the app retries initialization.
CLIENT151Part of the screen failed to load and was replaced by an error message.
CLIENT161This browser tab does not currently run the register, so it did not send a new payment request.
CLIENT171This device's clock and your store's clock are more than a minute apart.
CLIENT181WCPOS couldn't switch to that store.
CLIENT201This device ran out of memory, and the last action may not have finished.
CLIENT211WCPOS stopped because of a device-level crash.
CLIENT999WCPOS encountered an unexpected error.

DISPLAY: The customer-facing display​

CodeWhat it means
DISPLAY101The 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​

CodeWhat it means
HOST101The server is blocking the browser's permission check (CORS preflight), so the web app cannot reach it.
HOST111The server's cross-origin (CORS) configuration is broken, so the browser refuses its responses.
HOST121A bot-protection page is answering instead of the store's API.
HOST131A proxy in front of the store rejects the server's responses for having too many headers.
HOST141The host's security filter is blocking product searches.
HOST151Your host's cache can replay one person's store data to another.
HOST161The host is rate-limiting this store's tills.

LICENSE: Pro licence activation and validation​

CodeWhat it means
LICENSE101Your WCPOS Pro license is not active for this store or device.
LICENSE201WCPOS Pro is disabled because its version does not match WCPOS.
LICENSE301The updater is not authorized to download WCPOS Pro updates.
LICENSE999License checking hit an unexpected problem.

PAYMENT: Payment gateways and terminals​

CodeWhat it means
PAYMENT101Payment succeeded, but WCPOS could not refresh its status afterward.
PAYMENT111The store recorded this payment, but the till could not save its own copy.
PAYMENT113The store sent or cancelled the invoice, but this till could not save its copy of the order.
PAYMENT121The card was charged, but the order did not finish.
PAYMENT201WCPOS could not confirm whether the terminal charged the payment.
PAYMENT211The terminal did not take this payment.
PAYMENT212The gateway did not accept this payment.
PAYMENT213The store refused to record this payment. Nothing was taken.
PAYMENT221A payment could not be voided, so that money is still held.
PAYMENT301The selected payment gateway is unavailable for this store.
PAYMENT311WCPOS couldn't confirm whether this refund went through.
PAYMENT401The payment terminal did not finish pairing with WCPOS.
PAYMENT501The order had already been paid online, so the payment taken at the till is an additional one.
PAYMENT511More was taken at the till than the order still owed.
PAYMENT999Payment handling hit an unexpected problem.

PRINT: Receipt printing​

CodeWhat it means
PRINT101Automatic printing did not start for this receipt.
PRINT201WCPOS could not confirm that the print job completed.
PRINT301The selected printer cannot be reached.
PRINT311This receipt could not be emailed or downloaded.
PRINT999Printing hit an unexpected problem. No sale is affected.

PRODUCT: Product data and catalogue operations​

CodeWhat it means
PRODUCT101This product change hasn't reached your store yet.
PRODUCT111This variation could not be added to the product.
PRODUCT201This product image is unavailable, but the product can still be sold.
PRODUCT301No products matched the current search and filters.
PRODUCT321More than one product matches this barcode.
PRODUCT401The displayed stock may be older than the store stock.
PRODUCT411Barcode scanning settings could not be loaded, so scans may not match products.
PRODUCT421This product's variation price data could not be read, so displayed prices may be wrong or missing.
PRODUCT999Loading or updating products hit an unexpected problem.

REGISTER: Cash drawer, register sessions, and counts​

CodeWhat it means
REGISTER101Your store refused a paid in, paid out or no sale that the till has already recorded.
REGISTER111Your store would not reverse a cash movement, so the original one still counts.
REGISTER201Your store refused to open this register session, so nothing is being counted against it.
REGISTER211Your store refused this register's count, so the session is still open there.
REGISTER212The drawer carry did not complete on this device. The store was not switched.
REGISTER221Another device already had this register open, so this till joined that session instead of starting its own.
REGISTER231This account can't open, count or close the register.
REGISTER301Your store would not accept the manager approval for this count, so the register is still open.

SYNC: Synchronisation between the POS and your store​

CodeWhat it means
SYNC101WCPOS couldn't write a change to this device's storage.
SYNC111Some data stored on this device is damaged, so it can't sync.
SYNC121Your store can't be reached right now.
SYNC131Your store had an error and didn't finish this request.
SYNC141Your store asked WCPOS to slow down for a moment.
SYNC151Your store's reply had stray text in it, which WCPOS tried to clean up.
SYNC161This device's storage stopped responding, so saving is paused.
SYNC171WCPOS couldn't set up or remove storage on this device.
SYNC181Saving or loading on this device is very slow, and its outcome is not yet known.
SYNC191This change is still on its way to your store.
SYNC201Your store refused this change, so it hasn't reached the store.
SYNC202Your store refused this change, so this device went back to the store's version.
SYNC203Your store no longer has this order, so this device settled its own copy.
SYNC211Your store refused a value it was sent.
SYNC221A change on this device met a newer edit in your store. Nothing is lost.
SYNC222This device saved its version over a newer edit made in your store.
SYNC231Your store received this change, but this device couldn't record that it was sent.
SYNC301Your store's list of changes moved unexpectedly, so WCPOS is re-checking it by itself. Nothing is lost.
SYNC311Data on this device was saved by a different WCPOS version and can't be opened yet.
SYNC321Some data didn't sync this time.
SYNC331This device's copy of a record doesn't match your store's. Nothing you entered is affected.
SYNC341This store now requires a newer version of the POS app.
SYNC401A background sync task stopped unexpectedly before finishing.
SYNC411This device asked the store for data far more often than normal.
SYNC999Syncing 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:

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