# WCPOS Documentation > WCPOS is a point of sale (POS) for WooCommerce. It runs in a web browser or as a Windows, macOS or Linux desktop app, with iOS and Android apps in beta. It sells from the same catalogue, stock and prices as your online store and records every sale as a WooCommerce order. The free plugin takes cash and external card payments and prints receipts; WCPOS Pro adds integrated card readers, refunds, stock editing, order history, reports and multiple stores. - [WCPOS Documentation](/index.md) ## getting-started ### connect How to connect WCPOS to your WooCommerce store, including login options and troubleshooting connection issues. - [Connecting to Your Store](/getting-started/connect.md): How to connect WCPOS to your WooCommerce store, including login options and troubleshooting connection issues. ### free-vs-pro A side-by-side comparison of WCPOS Free and WCPOS Pro — every feature, payment gateway, and capability so you can decide which one you need. - [Free vs Pro](/getting-started/free-vs-pro.md): A side-by-side comparison of WCPOS Free and WCPOS Pro — every feature, payment gateway, and capability so you can decide which one you need. ### installation Minimum requirements for WCPOS including WordPress, WooCommerce, and PHP versions, supported browsers, and minimum desktop and mobile operating system versions. - [Installation Requirements](/getting-started/installation.md): Minimum requirements for WCPOS including WordPress, WooCommerce, and PHP versions, supported browsers, and minimum desktop and mobile operating system versions. ### is-wcpos-right-for-you Who WCPOS suits, who it doesn't, what it needs, what it costs, and how it compares with other point-of-sale options for WooCommerce, answered plainly. - [Is WCPOS right for you?](/getting-started/is-wcpos-right-for-you.md): Who WCPOS suits, who it doesn't, what it needs, what it costs, and how it compares with other point-of-sale options for WooCommerce, answered plainly. ### offline What works offline in WCPOS, how the local database syncs with WooCommerce, and what happens when connectivity is lost. - [Offline Functionality](/getting-started/offline.md): What works offline in WCPOS, how the local database syncs with WooCommerce, and what happens when connectivity is lost. ### previous-versions How to downgrade WCPOS by installing a previous version of the plugin from WordPress.org. - [Re-Installing a Previous Version of the WCPOS Plugin](/getting-started/previous-versions.md): How to downgrade WCPOS by installing a previous version of the plugin from WordPress.org. ### pro-license If you have purchased the Pro version please follow the steps below to install the plugin. - [Installing WCPOS Pro](/getting-started/pro-license.md): If you have purchased the Pro version please follow the steps below to install the plugin. ### roadmap Where WCPOS is headed — the public roadmap, how to request or vote on features, and the major themes in development. - [Roadmap](/getting-started/roadmap.md): Where WCPOS is headed — the public roadmap, how to request or vote on features, and the major themes in development. ### testing-the-beta Where to get the WCPOS 2.0 beta for the plugin and the desktop app, what to do before you install it, how to roll back, and where to report what you find. The phone apps follow after the beta. - [Testing the WCPOS 2.0 beta](/getting-started/testing-the-beta.md): Where to get the WCPOS 2.0 beta for the plugin and the desktop app, what to do before you install it, how to roll back, and where to report what you find. The phone apps follow after the beta. ## pos Overview of the WCPOS point of sale screen layout — header, product panel, cart, navigation drawer, and which screens are Free vs Pro. - [POS Screen Overview](/pos.md): Overview of the WCPOS point of sale screen layout — header, product panel, cart, navigation drawer, and which screens are Free vs Pro. ### cart Manage the shopping cart in WCPOS including line items, quantities, discounts, fees, and customer selection. - [Cart Panel](/pos/cart.md): Manage the shopping cart in WCPOS including line items, quantities, discounts, fees, and customer selection. - [Cart Discounts](/pos/cart/discounts.md): Apply discounts at the WCPOS register — quick percentage discounts, line-item price changes, and order-level discount fees. - [Cart Line Items](/pos/cart/line-items.md): Edit cart line items in WCPOS including quantities, prices, discounts, and product details with inline editing. - [Open Orders](/pos/cart/open-orders.md): Work with multiple orders simultaneously in WCPOS including parking orders, switching between transactions, and recovering from interruptions. - [Order Actions](/pos/cart/order-actions.md): Access order management features in WCPOS including order notes, meta data, fees, shipping, and discounts. ### checkout Complete sales in WCPOS checkout including payment methods, payment processing, and order completion. - [Checkout](/pos/checkout.md): Complete sales in WCPOS checkout including payment methods, payment processing, and order completion. ### product-panel Browse, search, and add products to cart in the WCPOS product panel. Includes grid/list views and category filtering. - [Product Panel](/pos/product-panel.md): Browse, search, and add products to cart in the WCPOS product panel. Includes grid/list views and category filtering. - [Barcode Scanning](/pos/product-panel/barcode-scanning.md): Set up barcode scanning in WCPOS using USB scanners, camera scanning, or custom barcode fields. - [Meta Data Keys](/pos/product-panel/meta-data-keys.md): Copy custom product meta data onto cart and order line items in WCPOS using the Meta Data Keys setting. - [Search & Filtering](/pos/product-panel/search-filtering.md): Search and filter products in WCPOS by name, SKU, category, tags, and other attributes. - [Variable Products](/pos/product-panel/variations.md): Work with WooCommerce variable products in WCPOS including quick selection, inline expansion, and barcode scanning for variations. ### reconciliation Quick end-of-day close for WCPOS cashiers — count the drawer, run the report, compare cash and card, and sign off. - [End-of-Day Reconciliation](/pos/reconciliation.md): Quick end-of-day close for WCPOS cashiers — count the drawer, run the report, compare cash and card, and sign off. ### refunds Quick guide to issuing a refund during a sale in WCPOS — start the refund, choose where the money goes, and confirm. - [Refunds at the Till](/pos/refunds.md): Quick guide to issuing a refund during a sale in WCPOS — start the refund, choose where the money goes, and confirm. ## products Manage WooCommerce products in WCPOS, including inventory updates, price changes, and stock management. - [Products Management](/products.md): Manage WooCommerce products in WCPOS, including inventory updates, price changes, and stock management. ### pos-only-products Control product visibility between your online store and POS, including POS-only and online-only products. - [POS Only Products](/products/pos-only-products.md): Control product visibility between your online store and POS, including POS-only and online-only products. ### sync How WCPOS downloads and synchronises products from WooCommerce, including sync presets, coverage, and keeping the catalogue fresh. - [Product Synchronisation](/products/sync.md): How WCPOS downloads and synchronises products from WooCommerce, including sync presets, coverage, and keeping the catalogue fresh. ## orders View and manage WooCommerce orders in WCPOS, including order history, refunds, and reprinting receipts. - [Orders](/orders.md): View and manage WooCommerce orders in WCPOS, including order history, refunds, and reprinting receipts. ### refunds Issue full or partial refunds for WooCommerce orders directly from WCPOS, with support for refunds back to the original payment method or out of the till as cash. - [Refunds](/orders/refunds.md): Issue full or partial refunds for WooCommerce orders directly from WCPOS, with support for refunds back to the original payment method or out of the till as cash. ## customers Manage WooCommerce customers in WCPOS, including customer lookup, editing details, and viewing order history. - [Customers](/customers.md): Manage WooCommerce customers in WCPOS, including customer lookup, editing details, and viewing order history. ## coupons Manage and apply WooCommerce coupons in WCPOS, including creating coupons, validation rules, and applying them at the register. - [Coupons](/coupons.md): Manage and apply WooCommerce coupons in WCPOS, including creating coupons, validation rules, and applying them at the register. ### applying-coupons The cashier workflow for applying WooCommerce coupons at the WCPOS register — search, coupon pills, sequential discounts, and resolving validation errors. - [Applying Coupons at the Till](/coupons/applying-coupons.md): The cashier workflow for applying WooCommerce coupons at the WCPOS register — search, coupon pills, sequential discounts, and resolving validation errors. ## stores Set up and manage multiple store locations in WCPOS, including per-store pricing, ATUM inventory integration, tax rates, and reports. - [Multi-Store](/stores.md): Set up and manage multiple store locations in WCPOS, including per-store pricing, ATUM inventory integration, tax rates, and reports. ### setup Step-by-step guide to creating and configuring a store location in WCPOS Pro — store details, authorized users, tax, pricing, and login behavior. - [Setting Up Stores](/stores/setup.md): Step-by-step guide to creating and configuring a store location in WCPOS Pro — store details, authorized users, tax, pricing, and login behavior. ## reports View sales reports and analytics in WCPOS, including daily summaries, payment breakdowns, and cashier reports. - [Reports](/reports.md): View sales reports and analytics in WCPOS, including daily summaries, payment breakdowns, and cashier reports. ### reconciliation Cashier-facing end-of-day procedure in WCPOS — count the drawer, run the report, reconcile cash and card, handle variances, and sign off. - [End-of-Day Reconciliation](/reports/reconciliation.md): Cashier-facing end-of-day procedure in WCPOS — count the drawer, run the report, reconcile cash and card, handle variances, and sign off. ## payment Configure payment methods in WCPOS including cash, card, and custom payment gateways like Stripe Terminal and SumUp. - [Payment Methods](/payment.md): Configure payment methods in WCPOS including cash, card, and custom payment gateways like Stripe Terminal and SumUp. ### gateways Payment gateways for WCPOS - [Payment Gateways](/payment/gateways.md): Payment gateways for WCPOS - [Email Invoice Gateway](/payment/gateways/email-invoice.md): Send payment invoices to customers via email in WCPOS - [Mercado Pago Terminal Gateway](/payment/gateways/mercadopago-terminal.md): Take in-person payments on Mercado Pago Point Smart terminals in WCPOS - [Mollie Terminal Gateway](/payment/gateways/mollie-terminal.md): Take in-person payments on Mollie Terminal devices in WCPOS - [PayArc Terminal Gateway](/payment/gateways/payarc-terminal.md): Take in-person payments on PayArc PAX terminals in WCPOS - [PayPal Reader (Zettle) Gateway](/payment/gateways/paypal-reader.md): Accept in-person card payments through a PayPal Reader (Zettle) card terminal in WCPOS - [Square Terminal Gateway](/payment/gateways/square-terminal.md): Collect in-person payments on Square Terminal devices in WCPOS - [Stripe Terminal Gateway](/payment/gateways/stripe-terminal.md): Accept payments using Stripe Terminal hardware readers in WCPOS - [SumUp Terminal Gateway](/payment/gateways/sumup-terminal.md): Process payments through SumUp card readers in WCPOS - [Vipps MobilePay Gateway](/payment/gateways/vipps-mobilepay.md): Accept phone-based payments via QR code or push notification in WCPOS - [Web Checkout Gateway](/payment/gateways/web-checkout.md): Complete payments via the web store checkout in WCPOS - [Windcave Terminal Gateway](/payment/gateways/windcave-terminal.md): Take in-person card payments on Windcave terminals (HIT) in WCPOS ## receipts Customise WCPOS receipts using the template gallery, logicless HTML templates, and thermal printer XML templates. - [Receipts](/receipts.md): Customise WCPOS receipts using the template gallery, logicless HTML templates, and thermal printer XML templates. ### at-checkout Print and email receipts in WCPOS, including printer setup and receipt customisation options. - [Receipts](/receipts/at-checkout.md): Print and email receipts in WCPOS, including printer setup and receipt customisation options. ### cloud-printing Print WCPOS receipts to printers that aren't attached to the till — Star Online, Star CloudPRNT, Epson Server Direct Print, and PrintNode. - [Cloud Printing](/receipts/cloud-printing.md): Print WCPOS receipts to printers that aren't attached to the till — Star Online, Star CloudPRNT, Epson Server Direct Print, and PrintNode. ### customise The easiest way to change how your WCPOS receipt looks — pick a different template, ask AI to tweak it, or edit it by hand. - [Customise Your Receipt](/receipts/customise.md): The easiest way to change how your WCPOS receipt looks — pick a different template, ask AI to tweak it, or edit it by hand. ### html-templates Create and customise logicless HTML receipt templates using Mustache-style placeholders. - [HTML Templates](/receipts/html-templates.md): Create and customise logicless HTML receipt templates using Mustache-style placeholders. ### receipt-data Complete reference for the canonical data contract available in WCPOS receipt templates. - [Receipt Data Reference](/receipts/receipt-data.md): Complete reference for the canonical data contract available in WCPOS receipt templates. ### storefront Let online customers download receipts and invoices from My Account, rendered with your custom WCPOS template. - [Receipts on Your Online Store](/receipts/storefront.md): Let online customers download receipts and invoices from My Account, rendered with your custom WCPOS template. ### thermal-templates Create XML-based receipt templates for ESC/POS thermal printers with Epson and Star support. - [Thermal Printer Templates](/receipts/thermal-templates.md): Create XML-based receipt templates for ESC/POS thermal printers with Epson and Star support. ## hardware Connect physical devices to WCPOS — receipt printers, barcode scanners, card readers, and cash drawers. - [Hardware](/hardware.md): Connect physical devices to WCPOS — receipt printers, barcode scanners, card readers, and cash drawers. ### printers Add a receipt printer in WCPOS — one scan covers USB, Bluetooth and Wi-Fi, then a test page confirms it works. - [Receipt Printers](/hardware/printers.md): Add a receipt printer in WCPOS — one scan covers USB, Bluetooth and Wi-Fi, then a test page confirms it works. - [Printer permissions on Android](/hardware/printers/android-permissions.md): Nearby devices, local network access and plain connections — the three Android permissions that make a printer appear or vanish. - [Pairing a Bluetooth receipt printer](/hardware/printers/bluetooth-pairing.md): Why a Bluetooth printer isn't in the chooser — one host at a time, Classic versus Low Energy, and the status sheet. - [Printing from the browser: permissions and certificates](/hardware/printers/browser-permissions.md): Chrome's local network permission, mixed content and self-signed certificates — the three things that stop a browser reaching a printer. - [Connecting a cash drawer to the printer](/hardware/printers/cash-drawer.md): The drawer plugs into the receipt printer, not the till. How to wire it, switch it on, and what to check when it doesn't pop. - [Let the app find printers on your iPad or iPhone](/hardware/printers/ios-local-network.md): On iOS, a denied Local Network permission looks exactly like a printer that's switched off. Where to turn it back on. - [The logo is missing from receipts printed in the browser](/hardware/printers/logo-missing-browser.md): Receipts print fine except for the store logo, and only in a browser tab — a CORS header on your WordPress uploads is what's missing. - [Give the printer a fixed address on the same network](/hardware/printers/network-address.md): Why a Wi-Fi printer isn't found, or stops working after weeks — subnets, guest Wi-Fi, client isolation, and DHCP. - [Receipts in Chinese, Thai, Arabic or Cyrillic](/hardware/printers/non-latin-receipts.md): Question marks or boxes instead of text mean the printer has no characters for your language. Print the receipt as an image instead. - [Epson printed once and then stopped — power-cycle first](/hardware/printers/printed-once-then-stopped.md): An Epson holding a job it will never print refuses every other job too. A power cycle clears it in ten seconds. - [Getting the receipt width right (58 mm, 80 mm, 42 or 48 characters)](/hardware/printers/receipt-width.md): What the test page's ruler tells you about paper width, and which of the four character-width answers to pick. - [Epson Secure Printing: what it blocks and how to turn it off](/hardware/printers/secure-printing.md): New Epson printers ship with Secure Printing on and silently discard receipts. Where the setting is, which ports it blocks, and how to turn it off. - [Epson prints nothing and its web page still works (Server Direct Print)](/hardware/printers/server-direct-print.md): When another service on the Epson owns the print engine, every receipt fails while the printer looks perfectly healthy. - [Printer Setup Wizard](/hardware/printers/setup-wizard.md): Answer a few questions and we'll walk you through connecting your receipt printer step by step — and help you fix it if the test print doesn't work. - [Supported receipt printers](/hardware/printers/supported-printers.md): Which receipt printers are tested, which are expected to work, and which are not supported yet — plus how to report yours. - [USB printer permissions on Linux](/hardware/printers/usb-linux.md): An access error when printing over USB on Linux means the device belongs to root — add a udev rule to hand it to your user. - [USB receipt printers on Windows: install a Generic/Text driver](/hardware/printers/usb-windows.md): Why a USB printer on Windows either prints nothing or spits out a page of symbols, and how a Generic/Text queue fixes it. ### scanners Connect a barcode scanner to WCPOS — camera, keyboard-mode, USB, and Bluetooth scanners across web, desktop, and mobile. - [Barcode Scanners](/hardware/scanners.md): Connect a barcode scanner to WCPOS — camera, keyboard-mode, USB, and Bluetooth scanners across web, desktop, and mobile. - [Scanner Setup Wizard](/hardware/scanners/setup-wizard.md): Answer a few questions and we'll walk you through setting up your barcode scanner — and help you fix it if a scan doesn't come through. ## settings Overview of WCPOS settings, including WordPress admin settings, store settings, and application preferences. - [Settings Overview](/settings.md): Overview of WCPOS settings, including WordPress admin settings, store settings, and application preferences. ### store Configure WCPOS store settings including general options, tax, barcode scanning, theme, and keyboard shortcuts. - [Store Settings](/settings/store.md): Configure WCPOS store settings including general options, tax, barcode scanning, theme, and keyboard shortcuts. - [Barcode Settings](/settings/store/barcode.md): Configure barcode scanning settings in WCPOS including scan delay, search actions, and camera scanning options. - [General Settings](/settings/store/general.md): Configure WCPOS store settings including currency display, number formatting, and default order status. - [Keyboard Shortcuts](/settings/store/hotkeys.md): Configure keyboard shortcuts in WCPOS for faster checkout and navigation using customisable hotkeys. - [Tax Settings](/settings/store/tax.md): Configure tax calculation and display settings in WCPOS including tax-inclusive pricing and itemised tax display. - [Theme Settings](/settings/store/theme.md): Customise WCPOS appearance with light, dark, and system themes plus accent colour options. ### wp-admin Configure WCPOS backend settings in WordPress admin including general options, checkout, and user access permissions. - [Settings in the WordPress Admin](/settings/wp-admin.md): Configure WCPOS backend settings in WordPress admin including general options, checkout, and user access permissions. - [Accessing the POS](/settings/wp-admin/access.md): Configure user roles and capabilities for WCPOS access including Administrator, Shop Manager, and Cashier permissions. - [Checkout Settings](/settings/wp-admin/checkout.md): Configure WCPOS checkout settings in WordPress admin including payment gateways and order processing. - [Customer Tax IDs](/settings/wp-admin/customer-tax-ids.md): How WCPOS stores customer tax IDs, detects which plugin's field to write to, and copies tax IDs onto orders at checkout. - [Email Notifications](/settings/wp-admin/email-notifications.md): Control which WooCommerce email notifications fire for POS orders — per-email admin, customer, and cashier toggles in WCPOS settings. - [General Settings](/settings/wp-admin/general.md): Configure WCPOS general settings in WordPress admin including POS-only products, decimal quantities, and barcode fields. - [Sessions](/settings/wp-admin/sessions.md): View active POS login sessions per user and device, and remotely sign devices out of WCPOS. - [Store Tax IDs](/settings/wp-admin/store-tax-ids.md): Configure the business tax identifiers WCPOS prints on POS receipts and invoices, including VAT, ABN, GSTIN, EIN, and company-registry numbers. ## integrations Third-party WooCommerce plugins that WCPOS works with out of the box, and what to expect from each. - [Integrations](/integrations.md): Third-party WooCommerce plugins that WCPOS works with out of the box, and what to expect from each. ### woocommerce-tax Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how POS orders get their rates, setup steps, and what to expect at the till. - [WooCommerce Tax](/integrations/woocommerce-tax.md): Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how POS orders get their rates, setup steps, and what to expect at the till. ## extensions Browse, install, and manage POS extensions from the extension directory. Learn how to create and submit your own extensions. - [Extensions](/extensions.md): Browse, install, and manage POS extensions from the extension directory. Learn how to create and submit your own extensions. ### atum Link WCPOS Pro stores to ATUM Multi-Inventory locations for per-location stock, pricing, and SKUs at the POS. - [WCPOS ATUM Integration](/extensions/atum.md): Link WCPOS Pro stores to ATUM Multi-Inventory locations for per-location stock, pricing, and SKUs at the POS. ### polylang Filter WCPOS products by Polylang language and avoid duplicate translated products in the POS. - [WCPOS Polylang](/extensions/polylang.md): Filter WCPOS products by Polylang language and avoid duplicate translated products in the POS. ### storeapps-smart-coupons StoreApps Smart Coupons store credit compatibility for WCPOS receipts, order notes, and POS balance deductions. - [WCPOS StoreApps Smart Coupons](/extensions/storeapps-smart-coupons.md): StoreApps Smart Coupons store credit compatibility for WCPOS receipts, order notes, and POS balance deductions. ### wp-multilang Filter WCPOS products by WP Multilang language and avoid duplicate translated products in the POS. - [WCPOS WP Multilang](/extensions/wp-multilang.md): Filter WCPOS products by WP Multilang language and avoid duplicate translated products in the POS. ### wpml Filter WCPOS products by WPML language and avoid duplicate translated products in the POS. - [WCPOS WPML](/extensions/wpml.md): Filter WCPOS products by WPML language and avoid duplicate translated products in the POS. ## support Get help with WCPOS through Discord, email support, or browse troubleshooting guides and FAQs. - [Support](/support.md): Get help with WCPOS through Discord, email support, or browse troubleshooting guides and FAQs. ### logs Access and understand WCPOS logs for troubleshooting, including the Store health activity log, server-side logs, and error codes. - [Logs](/support/logs.md): Access and understand WCPOS logs for troubleshooting, including the Store health activity log, server-side logs, and error codes. ### notifications Understand the in-app notification bell in WCPOS — where announcements, plugin updates, and licence alerts appear. - [Notifications](/support/notifications.md): Understand the in-app notification bell in WCPOS — where announcements, plugin updates, and licence alerts appear. ### performance Optimise WCPOS performance including server configuration, checkout speed, and WooCommerce HPOS migration. - [Performance](/support/performance.md): Optimise WCPOS performance including server configuration, checkout speed, and WooCommerce HPOS migration. - [Checkout Performance](/support/performance/checkout.md): Troubleshoot slow checkout times in WCPOS by analysing execution times and identifying bottlenecks. - [Slow Checkout and Order Storage (HPOS)](/support/performance/order-storage.md): Fix slow checkout in WCPOS on a large store: check which order storage WooCommerce uses and switch from legacy storage to HPOS with WooCommerce's own tool. - [Server Performance](/support/performance/server.md): Optimise WordPress server performance for WCPOS including HPOS, caching, database optimisation, and hosting recommendations. ### store-health The Store health area in WCPOS: sync performance presets and measured server load, per-collection download coverage, recovering refused changes, and the activity log. - [Store Health](/support/store-health.md): The Store health area in WCPOS: sync performance presets and measured server load, per-collection download coverage, recovering refused changes, and the activity log. ### translations How WCPOS is translated — AI-generated from tuned rules and improved by the community. Suggest fixes for the apps and plugin in the wcpos/translations repo, and for these docs in the wcpos/docs repo. - [Contributing Translations](/support/translations.md): How WCPOS is translated — AI-generated from tuned rules and improved by the community. Suggest fixes for the apps and plugin in the wcpos/translations repo, and for these docs in the wcpos/docs repo. ### troubleshooting - [Clear All Local Data](/support/troubleshooting/clear-local-data.md): How to clear the local WCPOS database and trigger a fresh sync from your WooCommerce store. - [Cloudflare](/support/troubleshooting/cloudflare.md): Stop Cloudflare's security checks from blocking the WCPOS app's connection to your store. - [Troubleshooting "There has been a critical error on this website."](/support/troubleshooting/critical-error.md): Fix the WordPress critical error in WCPOS by checking WooCommerce fatal error logs and identifying the cause. - [Plugin Conflicts](/support/troubleshooting/plugin-conflicts.md): Identify and resolve WordPress plugin conflicts affecting WCPOS using systematic troubleshooting methods. - [Troubleshooting "Cannot read properties of undefined (reading 'data')" Error](/support/troubleshooting/response-error.md): Fix the "Cannot read properties of undefined" error in WCPOS caused by empty server responses or plugin conflicts. - [Your Store and the POS Disagree on Totals](/support/troubleshooting/totals-disagree.md): What it means when WCPOS reports that your store changed an order's totals, and how to find the cause. ## error-codes Reference guide for WCPOS error codes across the sync, auth, checkout, payment, printing, and product domains, with troubleshooting steps. - [Error Codes](/error-codes.md): Reference guide for WCPOS error codes across the sync, auth, checkout, payment, printing, and product domains, with troubleshooting steps. ### api API errors occur when communicating with your WooCommerce server. - [API Errors](/error-codes/api.md): API errors occur when communicating with your WooCommerce server. ### API01001 API01001: Connection Timeout — The POS application attempted to connect to your WooCommerce server, but the server took too long to respond. - [API01001: Connection Timeout](/error-codes/API01001.md): API01001: Connection Timeout — The POS application attempted to connect to your WooCommerce server, but the server took too long to respond. ### API01002 API01002: Connection Refused — The server actively refused the connection attempt. - [API01002: Connection Refused](/error-codes/API01002.md): API01002: Connection Refused — The server actively refused the connection attempt. ### API01003 API01003: Connection Reset — The connection to the server was established but then unexpectedly closed. - [API01003: Connection Reset](/error-codes/API01003.md): API01003: Connection Reset — The connection to the server was established but then unexpectedly closed. ### API01004 API01004: DNS Resolution Failed — The POS could not convert your website's domain name (e.g., yourstore.com) into an IP address. - [API01004: DNS Resolution Failed](/error-codes/API01004.md): API01004: DNS Resolution Failed — The POS could not convert your website's domain name (e.g., yourstore.com) into an IP address. ### API01005 API01005: SSL Certificate Error — There's a problem with your website's SSL/TLS certificate. - [API01005: SSL Certificate Error](/error-codes/API01005.md): API01005: SSL Certificate Error — There's a problem with your website's SSL/TLS certificate. ### API01006 API01006: Network Unreachable — The POS cannot establish a route to the server. - [API01006: Network Unreachable](/error-codes/API01006.md): API01006: Network Unreachable — The POS cannot establish a route to the server. ### API01007 API01007: Device Offline — Your device is not connected to the internet. - [API01007: Device Offline](/error-codes/API01007.md): API01007: Device Offline — Your device is not connected to the internet. ### API01008 API01008: Website Unavailable — The POS can reach the internet, but your specific website is not responding. - [API01008: Website Unavailable](/error-codes/API01008.md): API01008: Website Unavailable — The POS can reach the internet, but your specific website is not responding. ### API02001 API02001: Invalid Credentials — The username or password you entered is incorrect. - [API02001: Invalid Credentials](/error-codes/API02001.md): API02001: Invalid Credentials — The username or password you entered is incorrect. ### API02002 API02002: Token Expired — Your authentication session has expired. - [API02002: Token Expired](/error-codes/API02002.md): API02002: Token Expired — Your authentication session has expired. ### API02003 API02003: Token Invalid — The authentication token being used is not recognized by the server. - [API02003: Token Invalid](/error-codes/API02003.md): API02003: Token Invalid — The authentication token being used is not recognized by the server. ### API02004 API02004: User Not Authorized — You're logged in, but your user account doesn't have permission to perform the requested action. - [API02004: User Not Authorized](/error-codes/API02004.md): API02004: User Not Authorized — You're logged in, but your user account doesn't have permission to perform the requested action. ### API02005 API02005: Insufficient Permissions — Your user account lacks the specific WordPress capabilities required for this action. - [API02005: Insufficient Permissions](/error-codes/API02005.md): API02005: Insufficient Permissions — Your user account lacks the specific WordPress capabilities required for this action. ### API02006 API02006: API Key Invalid — The WooCommerce REST API key being used is invalid. - [API02006: API Key Invalid](/error-codes/API02006.md): API02006: API Key Invalid — The WooCommerce REST API key being used is invalid. ### API02007 API02007: Token Refresh Failed — The POS tried to automatically renew your authentication session, but the refresh request failed. - [API02007: Token Refresh Failed](/error-codes/API02007.md): API02007: Token Refresh Failed — The POS tried to automatically renew your authentication session, but the refresh request failed. ### API02008 API02008: Refresh Token Invalid — The refresh token stored by the POS is not recognized by the server. - [API02008: Refresh Token Invalid](/error-codes/API02008.md): API02008: Refresh Token Invalid — The refresh token stored by the POS is not recognized by the server. ### API02009 API02009: Refresh Token Expired — Your refresh token has exceeded its lifetime and can no longer be used to obtain new access tokens. - [API02009: Refresh Token Expired](/error-codes/API02009.md): API02009: Refresh Token Expired — Your refresh token has exceeded its lifetime and can no longer be used to obtain new access tokens. ### API02010 API02010: Auth Required — The action you're trying to perform requires authentication, but you're not currently logged in. - [API02010: Auth Required](/error-codes/API02010.md): API02010: Auth Required — The action you're trying to perform requires authentication, but you're not currently logged in. ### API03001 API03001: Invalid Request Format — The request sent to the server was not in the expected format. - [API03001: Invalid Request Format](/error-codes/API03001.md): API03001: Invalid Request Format — The request sent to the server was not in the expected format. ### API03002 API03002: Missing Required Parameters — The request is missing data that the server needs to complete the action. - [API03002: Missing Required Parameters](/error-codes/API03002.md): API03002: Missing Required Parameters — The request is missing data that the server needs to complete the action. ### API03003 API03003: Invalid Parameter Value — One of the values in your request is invalid. - [API03003: Invalid Parameter Value](/error-codes/API03003.md): API03003: Invalid Parameter Value — One of the values in your request is invalid. ### API03004 API03004: Request Too Large — The request you're sending exceeds the server's size limits. - [API03004: Request Too Large](/error-codes/API03004.md): API03004: Request Too Large — The request you're sending exceeds the server's size limits. ### API03005 API03005: Rate Limit Exceeded — You've made too many requests to the server in a short period. - [API03005: Rate Limit Exceeded](/error-codes/API03005.md): API03005: Rate Limit Exceeded — You've made too many requests to the server in a short period. ### API03006 API03006: Unsupported Method — The HTTP method used (GET, POST, PUT, DELETE, etc.) is not supported for this endpoint. - [API03006: Unsupported Method](/error-codes/API03006.md): API03006: Unsupported Method — The HTTP method used (GET, POST, PUT, DELETE, etc.) is not supported for this endpoint. ### API03007 API03007: Request Queue Full — The POS has too many pending requests waiting to be sent. - [API03007: Request Queue Full](/error-codes/API03007.md): API03007: Request Queue Full — The POS has too many pending requests waiting to be sent. ### API04001 API04001: Invalid Response Format — The server responded, but the response format is not what the POS expected. - [API04001: Invalid Response Format](/error-codes/API04001.md): API04001: Invalid Response Format — The server responded, but the response format is not what the POS expected. ### API04002 API04002: Unexpected Response Code — The server returned an HTTP status code that wasn't expected for this request. - [API04002: Unexpected Response Code](/error-codes/API04002.md): API04002: Unexpected Response Code — The server returned an HTTP status code that wasn't expected for this request. ### API04003 API04003: Malformed JSON Response — The server returned data that appears to be JSON but is corrupted or invalid. - [API04003: Malformed JSON Response](/error-codes/API04003.md): API04003: Malformed JSON Response — The server returned data that appears to be JSON but is corrupted or invalid. ### API04004 API04004: Missing Response Data — The server responded successfully, but the response is missing expected data. - [API04004: Missing Response Data](/error-codes/API04004.md): API04004: Missing Response Data — The server responded successfully, but the response is missing expected data. ### API04005 API04005: JSON Recovery Attempted — The server sent a response with some invalid JSON content, but the POS attempted to recover and extract valid data. - [API04005: JSON Recovery Attempted](/error-codes/API04005.md): API04005: JSON Recovery Attempted — The server sent a response with some invalid JSON content, but the POS attempted to recover and extract valid data. ### API04006 API04006: Resource Not Found — The server could not find the requested resource. - [API04006: Resource Not Found](/error-codes/API04006.md): API04006: Resource Not Found — The server could not find the requested resource. ### API05001 API05001: WooCommerce API Disabled — The WooCommerce REST API is disabled on your site. - [API05001: WooCommerce API Disabled](/error-codes/API05001.md): API05001: WooCommerce API Disabled — The WooCommerce REST API is disabled on your site. ### API05002 API05002: WCPOS Plugin Not Found — The WCPOS plugin is not installed or not active on your WordPress site. - [API05002: WCPOS Plugin Not Found](/error-codes/API05002.md): API05002: WCPOS Plugin Not Found — The WCPOS plugin is not installed or not active on your WordPress site. ### API05003 API05003: WCPOS Plugin Outdated — The WCPOS plugin installed on your server is outdated and not compatible with your version of the POS application. - [API05003: WCPOS Plugin Outdated](/error-codes/API05003.md): API05003: WCPOS Plugin Outdated — The WCPOS plugin installed on your server is outdated and not compatible with your version of the POS application. ### API05004 API05004: WordPress API Disabled — The WordPress REST API is disabled on your site. - [API05004: WordPress API Disabled](/error-codes/API05004.md): API05004: WordPress API Disabled — The WordPress REST API is disabled on your site. ### API05005 API05005: Plugin Not Found — A required WordPress plugin is not installed or active. - [API05005: Plugin Not Found](/error-codes/API05005.md): API05005: Plugin Not Found — A required WordPress plugin is not installed or active. ### API06001 API06001: Invalid URL Format — The URL configured for your WooCommerce site is not in a valid format. - [API06001: Invalid URL Format](/error-codes/API06001.md): API06001: Invalid URL Format — The URL configured for your WooCommerce site is not in a valid format. ### API06002 API06002: Missing API URL — No URL has been configured for connecting to your WooCommerce store. - [API06002: Missing API URL](/error-codes/API06002.md): API06002: Missing API URL — No URL has been configured for connecting to your WooCommerce store. ### API06003 API06003: Invalid Site Configuration — The site configuration is invalid or incomplete. - [API06003: Invalid Site Configuration](/error-codes/API06003.md): API06003: Invalid Site Configuration — The site configuration is invalid or incomplete. ### AUTH101 Your session ended and you need to sign in again. - [AUTH101: Session expired](/error-codes/AUTH101.md): Your session ended and you need to sign in again. ### AUTH111 The store did not accept the sign-in credentials. - [AUTH111: Credentials rejected](/error-codes/AUTH111.md): The store did not accept the sign-in credentials. ### AUTH121 The signed-in store account does not match the cashier on this till. - [AUTH121: Signed in as wrong user](/error-codes/AUTH121.md): 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. - [AUTH131: Store session incomplete](/error-codes/AUTH131.md): The saved store session was incomplete, so WCPOS returned to the store list. ### AUTH201 Your account does not have permission to perform this action. - [AUTH201: Insufficient role](/error-codes/AUTH201.md): Your account does not have permission to perform this action. ### AUTH301 Another authentication plugin is preventing WCPOS from connecting. - [AUTH301: Auth plugin conflict](/error-codes/AUTH301.md): Another authentication plugin is preventing WCPOS from connecting. ### AUTH311 WCPOS can't reach its connection point on your store. - [AUTH311: Rest route missing](/error-codes/AUTH311.md): WCPOS can't reach its connection point on your store. ### AUTH321 WooCommerce is not active on this site, so WCPOS cannot connect. - [AUTH321: WooCommerce missing](/error-codes/AUTH321.md): 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. - [AUTH331: WCPOS plugin outdated](/error-codes/AUTH331.md): This store's WCPOS plugin is too old for this version of the app. ### AUTH401 A secure connection to this store could not be trusted. - [AUTH401: TLS untrusted](/error-codes/AUTH401.md): A secure connection to this store could not be trusted. ### AUTH411 The store address is missing or not a valid URL. - [AUTH411: Store URL invalid](/error-codes/AUTH411.md): 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. - [AUTH421: Auth token blocked by host](/error-codes/AUTH421.md): 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. - [AUTH431: Rest transport blocked](/error-codes/AUTH431.md): 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. - [AUTH441: Auth token too large](/error-codes/AUTH441.md): The login token is larger than this server accepts. ### AUTH999 Signing in or staying signed in hit an unexpected problem. - [AUTH999: Auth unexpected](/error-codes/AUTH999.md): Signing in or staying signed in hit an unexpected problem. ### CHECKOUT101 Checkout did not finish, and the cart is still safe to retry. - [CHECKOUT101: Checkout failed cart safe](/error-codes/CHECKOUT101.md): 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. - [CHECKOUT111: Cart update failed](/error-codes/CHECKOUT111.md): This change could not be applied to the cart, which is unchanged. ### CHECKOUT201 WCPOS could not confirm whether checkout completed. - [CHECKOUT201: Checkout outcome unknown](/error-codes/CHECKOUT201.md): WCPOS could not confirm whether checkout completed. ### CHECKOUT211 The store returned no checkout result, so the order status is unknown. - [CHECKOUT211: Checkout empty response](/error-codes/CHECKOUT211.md): The store returned no checkout result, so the order status is unknown. ### CHECKOUT301 Checkout cannot continue because a product SKU is duplicated or invalid. - [CHECKOUT301: SKU duplicate](/error-codes/CHECKOUT301.md): 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. - [CHECKOUT401: Totals diverged](/error-codes/CHECKOUT401.md): 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. - [CHECKOUT411: Cart line price basis unreadable](/error-codes/CHECKOUT411.md): 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. - [CHECKOUT421: Order tax rate unknown](/error-codes/CHECKOUT421.md): This order refers to a tax rate your store no longer has, so its tax may be wrong. ### CHECKOUT999 Checkout hit an unexpected problem. - [CHECKOUT999: Checkout unexpected](/error-codes/CHECKOUT999.md): Checkout hit an unexpected problem. ### CLIENT101 WCPOS could not finish starting. - [CLIENT101: App start failed](/error-codes/CLIENT101.md): WCPOS could not finish starting. ### CLIENT111 Syncing is taking longer than expected to start. - [CLIENT111: App start slow](/error-codes/CLIENT111.md): Syncing is taking longer than expected to start. ### CLIENT121 This browser lets only one tab send changes at a time. - [CLIENT121: Multi tab limited](/error-codes/CLIENT121.md): This browser lets only one tab send changes at a time. ### CLIENT131 WCPOS queued too many requests at once and dropped some. - [CLIENT131: Request queue overflow](/error-codes/CLIENT131.md): 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. - [CLIENT141: Search results did not match](/error-codes/CLIENT141.md): 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. - [CLIENT142: Search index did not answer](/error-codes/CLIENT142.md): 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. - [CLIENT143: Search index missed a record](/error-codes/CLIENT143.md): 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. - [CLIENT144: Search index rebuild failed](/error-codes/CLIENT144.md): 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. - [CLIENT151: Screen render failed](/error-codes/CLIENT151.md): Part of the screen failed to load and was replaced by an error message. ### CLIENT171 This device's clock and your store's clock are more than a minute apart. - [CLIENT171: Clock out of sync](/error-codes/CLIENT171.md): This device's clock and your store's clock are more than a minute apart. ### CLIENT181 WCPOS couldn't switch to that store. - [CLIENT181: Store switch failed](/error-codes/CLIENT181.md): WCPOS couldn't switch to that store. ### CLIENT201 This device ran out of memory, and the last action may not have finished. - [CLIENT201: Out of memory](/error-codes/CLIENT201.md): This device ran out of memory, and the last action may not have finished. ### CLIENT211 WCPOS stopped because of a device-level crash. - [CLIENT211: Native crash](/error-codes/CLIENT211.md): WCPOS stopped because of a device-level crash. ### CLIENT999 WCPOS encountered an unexpected error. - [CLIENT999: Unexpected error](/error-codes/CLIENT999.md): WCPOS encountered an unexpected error. ### db Database errors occur when storing or retrieving data in the local database. - [Database Errors](/error-codes/db.md): Database errors occur when storing or retrieving data in the local database. ### DB01001 DB01001: Connection Failed — The POS could not connect to its local database. - [DB01001: Connection Failed](/error-codes/DB01001.md): DB01001: Connection Failed — The POS could not connect to its local database. ### DB01002 DB01002: Query Timeout — A database operation took too long to complete. - [DB01002: Query Timeout](/error-codes/DB01002.md): DB01002: Query Timeout — A database operation took too long to complete. ### DB01003 DB01003: Transaction Failed — A database transaction could not be completed. - [DB01003: Transaction Failed](/error-codes/DB01003.md): DB01003: Transaction Failed — A database transaction could not be completed. ### DB02001 DB02001: Duplicate Record — The database tried to insert a record with an ID that already exists. - [DB02001: Duplicate Record](/error-codes/DB02001.md): DB02001: Duplicate Record — The database tried to insert a record with an ID that already exists. ### DB02002 DB02002: Record Not Found — The requested record does not exist in the local database. - [DB02002: Record Not Found](/error-codes/DB02002.md): DB02002: Record Not Found — The requested record does not exist in the local database. ### DB02003 DB02003: Constraint Violation — The data you're trying to save violates database rules. - [DB02003: Constraint Violation](/error-codes/DB02003.md): DB02003: Constraint Violation — The data you're trying to save violates database rules. ### DB03001 DB03001: Query Syntax Error — The database query has syntax errors. - [DB03001: Query Syntax Error](/error-codes/DB03001.md): DB03001: Query Syntax Error — The database query has syntax errors. ### DB03002 DB03002: Invalid Data Type — The data type doesn't match what the database expects. - [DB03002: Invalid Data Type](/error-codes/DB03002.md): DB03002: Invalid Data Type — The data type doesn't match what the database expects. ### DB03003 DB03003: Missing Required Field — A required field was not provided. - [DB03003: Missing Required Field](/error-codes/DB03003.md): DB03003: Missing Required Field — A required field was not provided. ### HOST101 The server is blocking the browser's permission check (CORS preflight), so the web app cannot reach it. - [HOST101: Cors preflight blocked](/error-codes/HOST101.md): 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. - [HOST111: Cors misconfigured](/error-codes/HOST111.md): 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. - [HOST121: Bot challenge blocking api](/error-codes/HOST121.md): 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. - [HOST131: Response headers rejected](/error-codes/HOST131.md): 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. - [HOST141: Search blocked by waf](/error-codes/HOST141.md): The host's security filter is blocking product searches. ### HOST151 Your host's cache can replay one person's store data to another. - [HOST151: Cache shared replay](/error-codes/HOST151.md): Your host's cache can replay one person's store data to another. ### HOST161 The host is rate-limiting this store's tills. - [HOST161: Host rate limited](/error-codes/HOST161.md): The host is rate-limiting this store's tills. ### LICENSE101 Your WCPOS Pro license is not active for this store or device. - [LICENSE101: License not active here](/error-codes/LICENSE101.md): Your WCPOS Pro license is not active for this store or device. ### LICENSE201 WCPOS Pro is disabled because its version does not match WCPOS. - [LICENSE201: Version skew Pro disabled](/error-codes/LICENSE201.md): WCPOS Pro is disabled because its version does not match WCPOS. ### LICENSE301 The updater is not authorized to download WCPOS Pro updates. - [LICENSE301: Updater not authorized](/error-codes/LICENSE301.md): The updater is not authorized to download WCPOS Pro updates. ### LICENSE999 License checking hit an unexpected problem. - [LICENSE999: License unexpected](/error-codes/LICENSE999.md): License checking hit an unexpected problem. ### PAYMENT101 Payment succeeded, but WCPOS could not refresh its status afterward. - [PAYMENT101: Payment ok status check failed](/error-codes/PAYMENT101.md): Payment succeeded, but WCPOS could not refresh its status afterward. ### PAYMENT201 WCPOS could not confirm whether the terminal charged the payment. - [PAYMENT201: Payment outcome unknown](/error-codes/PAYMENT201.md): WCPOS could not confirm whether the terminal charged the payment. ### PAYMENT301 The selected payment gateway is unavailable for this store. - [PAYMENT301: Gateway unavailable](/error-codes/PAYMENT301.md): The selected payment gateway is unavailable for this store. ### PAYMENT311 WCPOS couldn't confirm whether this refund went through. - [PAYMENT311: Refund outcome unknown](/error-codes/PAYMENT311.md): WCPOS couldn't confirm whether this refund went through. ### PAYMENT401 The payment terminal did not finish pairing with WCPOS. - [PAYMENT401: Terminal pairing incomplete](/error-codes/PAYMENT401.md): The payment terminal did not finish pairing with WCPOS. ### PAYMENT999 Payment handling hit an unexpected problem. - [PAYMENT999: Payment unexpected](/error-codes/PAYMENT999.md): Payment handling hit an unexpected problem. ### PRINT101 Automatic printing did not start for this receipt. - [PRINT101: Autoprint did not start](/error-codes/PRINT101.md): Automatic printing did not start for this receipt. ### PRINT201 WCPOS could not confirm that the print job completed. - [PRINT201: Print job failed](/error-codes/PRINT201.md): WCPOS could not confirm that the print job completed. ### PRINT301 The selected printer cannot be reached. - [PRINT301: Printer unreachable](/error-codes/PRINT301.md): The selected printer cannot be reached. ### PRINT311 This receipt could not be emailed or downloaded. - [PRINT311: Receipt delivery failed](/error-codes/PRINT311.md): This receipt could not be emailed or downloaded. ### PRINT999 Printing hit an unexpected problem. No sale is affected. - [PRINT999: Print unexpected](/error-codes/PRINT999.md): Printing hit an unexpected problem. No sale is affected. ### PRODUCT101 This product change hasn't reached your store yet. - [PRODUCT101: Product save failed](/error-codes/PRODUCT101.md): This product change hasn't reached your store yet. ### PRODUCT111 This variation could not be added to the product. - [PRODUCT111: Variation add failed](/error-codes/PRODUCT111.md): This variation could not be added to the product. ### PRODUCT201 This product image is unavailable, but the product can still be sold. - [PRODUCT201: Product image unavailable](/error-codes/PRODUCT201.md): This product image is unavailable, but the product can still be sold. ### PRODUCT301 No products matched the current search and filters. - [PRODUCT301: Search no results reason](/error-codes/PRODUCT301.md): No products matched the current search and filters. ### PRODUCT321 More than one product matches this barcode. - [PRODUCT321: Barcode ambiguous](/error-codes/PRODUCT321.md): More than one product matches this barcode. ### PRODUCT401 The displayed stock may be older than the store stock. - [PRODUCT401: Stock stale](/error-codes/PRODUCT401.md): The displayed stock may be older than the store stock. ### PRODUCT411 Barcode scanning settings could not be loaded, so scans may not match products. - [PRODUCT411: Barcode config unavailable](/error-codes/PRODUCT411.md): 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. - [PRODUCT421: Variable price meta invalid](/error-codes/PRODUCT421.md): 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. - [PRODUCT999: Product unexpected](/error-codes/PRODUCT999.md): Loading or updating products hit an unexpected problem. ### py Payment errors occur during checkout and payment processing. - [Payment Errors](/error-codes/py.md): Payment errors occur during checkout and payment processing. ### PY01001 PY01001: Payment Declined — The payment was declined by the payment processor or card issuer. - [PY01001: Payment Declined](/error-codes/PY01001.md): PY01001: Payment Declined — The payment was declined by the payment processor or card issuer. ### PY01002 PY01002: Insufficient Funds — The payment was declined because there isn't enough money in the account to cover the transaction. - [PY01002: Insufficient Funds](/error-codes/PY01002.md): PY01002: Insufficient Funds — The payment was declined because there isn't enough money in the account to cover the transaction. ### PY01003 PY01003: Card Expired — The payment card has passed its expiration date and can no longer be used for transactions. - [PY01003: Card Expired](/error-codes/PY01003.md): PY01003: Card Expired — The payment card has passed its expiration date and can no longer be used for transactions. ### PY01004 PY01004: Invalid Card Number — The card number entered is not valid. - [PY01004: Invalid Card Number](/error-codes/PY01004.md): PY01004: Invalid Card Number — The card number entered is not valid. ### PY02001 PY02001: Payment Gateway Error — An error occurred while communicating with the payment gateway. - [PY02001: Payment Gateway Error](/error-codes/PY02001.md): PY02001: Payment Gateway Error — An error occurred while communicating with the payment gateway. ### PY02002 PY02002: Payment Timeout — The payment processing took too long and timed out. - [PY02002: Payment Timeout](/error-codes/PY02002.md): PY02002: Payment Timeout — The payment processing took too long and timed out. ### sy System errors are related to device resources and system configuration. - [System Errors](/error-codes/sy.md): System errors are related to device resources and system configuration. ### SY01001 SY01001: Out of Memory — Your device is running low on memory (RAM) and cannot complete the requested operation. - [SY01001: Out of Memory](/error-codes/SY01001.md): SY01001: Out of Memory — Your device is running low on memory (RAM) and cannot complete the requested operation. ### SY01002 SY01002: Disk Full — Your device's storage is full. - [SY01002: Disk Full](/error-codes/SY01002.md): SY01002: Disk Full — Your device's storage is full. ### SY01003 SY01003: Permission Denied — The POS application doesn't have permission to access a required resource. - [SY01003: Permission Denied](/error-codes/SY01003.md): SY01003: Permission Denied — The POS application doesn't have permission to access a required resource. ### SY02001 SY02001: Invalid Configuration — The system configuration is invalid or corrupted. - [SY02001: Invalid Configuration](/error-codes/SY02001.md): SY02001: Invalid Configuration — The system configuration is invalid or corrupted. ### SY02002 SY02002: Service Unavailable — A required service or component is not available. - [SY02002: Service Unavailable](/error-codes/SY02002.md): SY02002: Service Unavailable — A required service or component is not available. ### SYNC101 WCPOS couldn't write a change to this device's storage. - [SYNC101: Local DB write failed](/error-codes/SYNC101.md): 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. - [SYNC111: Local DB corrupted](/error-codes/SYNC111.md): Some data stored on this device is damaged, so it can't sync. ### SYNC121 Your store can't be reached right now. - [SYNC121: Sync unreachable](/error-codes/SYNC121.md): Your store can't be reached right now. ### SYNC131 Your store had an error and didn't finish this request. - [SYNC131: Store server error](/error-codes/SYNC131.md): Your store had an error and didn't finish this request. ### SYNC141 Your store asked WCPOS to slow down for a moment. - [SYNC141: Store rate limited](/error-codes/SYNC141.md): 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. - [SYNC151: Store response malformed](/error-codes/SYNC151.md): 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. - [SYNC161: Local DB unavailable](/error-codes/SYNC161.md): This device's storage stopped responding, so saving is paused. ### SYNC171 WCPOS couldn't set up or remove storage on this device. - [SYNC171: Local DB setup failed](/error-codes/SYNC171.md): 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. - [SYNC181: Local database call stalled](/error-codes/SYNC181.md): 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. - [SYNC191: Write still sending](/error-codes/SYNC191.md): This change is still on its way to your store. ### SYNC201 Your store refused this change, so it hasn't reached the store. - [SYNC201: Record rejected](/error-codes/SYNC201.md): 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. - [SYNC202: Record reverted](/error-codes/SYNC202.md): Your store refused this change, so this device went back to the store's version. ### SYNC211 Your store refused a value it was sent. - [SYNC211: Record invalid field](/error-codes/SYNC211.md): Your store refused a value it was sent. ### SYNC221 A change on this device met a newer edit in your store. Nothing is lost. - [SYNC221: Record conflict](/error-codes/SYNC221.md): 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. - [SYNC222: Store edit overwritten](/error-codes/SYNC222.md): 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. - [SYNC231: Record sent, unrecorded](/error-codes/SYNC231.md): 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. - [SYNC301: Sync behind head](/error-codes/SYNC301.md): 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. - [SYNC311: Schema mismatch](/error-codes/SYNC311.md): 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. - [SYNC321: Sync partial](/error-codes/SYNC321.md): 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. - [SYNC331: Local record diverged](/error-codes/SYNC331.md): 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. - [SYNC341: App update required](/error-codes/SYNC341.md): This store now requires a newer version of the POS app. ### SYNC401 A background sync task stopped unexpectedly before finishing. - [SYNC401: Sync task crashed](/error-codes/SYNC401.md): A background sync task stopped unexpectedly before finishing. ### SYNC411 This device asked the store for data far more often than normal. - [SYNC411: Demand request flood](/error-codes/SYNC411.md): This device asked the store for data far more often than normal. ### SYNC999 Syncing hit an unexpected problem. - [SYNC999: Sync unexpected](/error-codes/SYNC999.md): Syncing hit an unexpected problem. ## reference ### architecture Technical architecture of WCPOS explaining how the POS client communicates with the WooCommerce REST API. - [Architecture](/reference/architecture.md): Technical architecture of WCPOS explaining how the POS client communicates with the WooCommerce REST API. ### fiscal-compliance Where WCPOS stands on fiscal certification (France NF525, Spain VERIFACTU, Norway, Chile) and EU OSS, and the available workarounds. - [Fiscal Compliance & Certification](/reference/fiscal-compliance.md): Where WCPOS stands on fiscal certification (France NF525, Spain VERIFACTU, Norway, Chile) and EU OSS, and the available workarounds. ### gateway-template Create a custom POS-only payment gateway for WCPOS - [Gateway Template](/reference/gateway-template.md): Create a custom POS-only payment gateway for WCPOS ### pos-discounts Developer reference for how WCPOS stores POS line-item price overrides, how they interact with WooCommerce coupons, and the available filters. - [POS Discount Technical Reference](/reference/pos-discounts.md): Developer reference for how WCPOS stores POS line-item price overrides, how they interact with WooCommerce coupons, and the available filters. ### role-endpoint-access Developer reference for which WCPOS REST endpoints are accessible to each default role (administrator, shop_manager, cashier), plus token-expiry behaviour and diagnostic tips. - [Role Endpoint Access](/reference/role-endpoint-access.md): Developer reference for which WCPOS REST endpoints are accessible to each default role (administrator, shop_manager, cashier), plus token-expiry behaviour and diagnostic tips. ### sync-engine Developer reference for the WCPOS sync engine introduced in v1.10.0: scopes, sync lanes, change detection, declared demand, coverage reporting, and the offline write queue. - [How the Sync Engine Works](/reference/sync-engine.md): Developer reference for the WCPOS sync engine introduced in v1.10.0: scopes, sync lanes, change detection, declared demand, coverage reporting, and the offline write queue. ### sync-performance How the WCPOS sync engine protects your server: bounded request ceilings, back-off under pressure, responsiveness guarantees, and the measured numbers behind them. - [Sync Performance and Server Politeness](/reference/sync-performance.md): How the WCPOS sync engine protects your server: bounded request ceilings, back-off under pressure, responsiveness guarantees, and the measured numbers behind them. ### wc-rest-api The WooCommerce REST API is like a set of standardised “channels” that allows store owners to connect their WooCommerce store to other applications and services. - [Understanding the WooCommerce REST API](/reference/wc-rest-api.md): The WooCommerce REST API is like a set of standardised “channels” that allows store owners to connect their WooCommerce store to other applications and services. ## Optional - [WCPOS Website](https://wcpos.com): Product website and downloads - [GitHub](https://github.com/wcpos): Source code and issue tracker - [Discord](https://wcpos.com/discord): Community support chat - [WordPress.org plugin](https://wordpress.org/plugins/woocommerce-pos/): Free version on the WordPress plugin directory - [WCPOS Pro](https://wcpos.com/pro): Pro features and licensing - [Compare WooCommerce POS systems](https://wcpos.com/compare): WCPOS compared with Oliver POS, WooCommerce's official POS, Square, Jovvie, Vitepos, YITH and FooSales: pricing, offline support, hardware, and when each is the better choice