# 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, split and external card payments, runs a cash-drawer register and prints receipts; WCPOS Pro adds integrated card readers, refunds, stock editing, order history, the customer-facing display, and multiple registers and stores. - [WCPOS Documentation](/index.md) ## getting-started ### connect-store Connect the WCPOS app to your WooCommerce store, sign in with WordPress, add more cashiers, and fix a sign-in that won't finish. - [Connect to Your Store](/getting-started/connect-store.md): Connect the WCPOS app to your WooCommerce store, sign in with WordPress, add more cashiers, and fix a sign-in that won't finish. ### free-vs-pro What the free WCPOS plugin does, what WCPOS Pro adds, and what a Pro feature looks like when you're on the free plugin. - [Free vs Pro](/getting-started/free-vs-pro.md): What the free WCPOS plugin does, what WCPOS Pro adds, and what a Pro feature looks like when you're on the free plugin. ### installation What your WordPress site needs for WCPOS 2.0, how to install the plugin, where to open the POS, how to check what's installed, and which computers, tablets and phones run the apps. - [Installation](/getting-started/installation.md): What your WordPress site needs for WCPOS 2.0, how to install the plugin, where to open the POS, how to check what's installed, and which computers, tablets and phones run the apps. ### 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. ### make-sale Ring up a sale from start to finish: build the cart, take the payment, give change, hand over the receipt and start the next sale. - [Make a Sale](/getting-started/make-sale.md): Ring up a sale from start to finish: build the cart, take the payment, give change, hand over the receipt and start the next sale. ### pro-license Buy a WCPOS Pro licence, install the Pro plugin, activate your licence key in WP Admin, and check that the POS now runs Pro. - [Pro License](/getting-started/pro-license.md): Buy a WCPOS Pro licence, install the Pro plugin, activate your licence key in WP Admin, and check that the POS now runs Pro. ### upgrade-2-0 Check whether your store can take WCPOS 2.0 today, what to do before you click Update, how to check every till made it, what changes on day one, and how to roll back. - [Upgrade to 2.0](/getting-started/upgrade-2-0.md): Check whether your store can take WCPOS 2.0 today, what to do before you click Update, how to check every till made it, what changes on day one, and how to roll back. ## 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. ### barcode-scanners Plug in or pair a barcode scanner, check it in Barcode Scanning, test a scan, and connect it directly when keyboard mode isn't enough. - [Barcode Scanners](/hardware/barcode-scanners.md): Plug in or pair a barcode scanner, check it in Barcode Scanning, test a scan, and connect it directly when keyboard mode isn't enough. - [Scanner Settings](/hardware/barcode-scanners/scanner-settings.md): Set how this device tells a scan from typing, pick a scan sound theme and volume, connect a scanner, and test a scan in Settings, Barcode Scanning. - [Scanner Setup Wizard](/hardware/barcode-scanners/scanner-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. ### card-readers Choose a smart reader or connect a Bluetooth reader in Settings → Card readers, and fix a reader the till can't find. Tap to Pay comes in an app update. - [Card Readers](/hardware/card-readers.md): Choose a smart reader or connect a Bluetooth reader in Settings → Card readers, and fix a reader the till can't find. Tap to Pay comes in an app update. - [Authorize.net Tap to Pay](/hardware/card-readers/authorize-net.md): Take a Tap to Pay payment in the Authorize.net phone app and let WCPOS record it on the order. Setup, sandbox and production, refunds and the limits of the beta - [Mercado Pago Terminal Gateway](/hardware/card-readers/mercado-pago.md): Take card payments on a Mercado Pago Point Smart terminal from the POS checkout, and set up the Mercado Pago Terminal extension in WP Admin. - [Mollie](/hardware/card-readers/mollie.md): Take card payments on a Mollie terminal from the POS: send a sale to the terminal, cancel, refund, show an iDEAL or Bancontact QR code, and set it up. - [PayArc Terminal Gateway](/hardware/card-readers/payarc.md): Take card payments on a PayArc PAX terminal from the WCPOS checkout, refund them, and set the gateway up - [PayPal Reader (Zettle) Gateway](/hardware/card-readers/paypal-zettle.md): Take card payments on a PayPal Reader (Zettle) from the POS checkout, and set up the PayPal Reader extension in WP Admin. - [Square Terminal Gateway](/hardware/card-readers/square-terminal.md): Take card payments on a Square Terminal from the POS checkout, and set up the Square Terminal extension in WP Admin. - [Stripe Terminal Gateway](/hardware/card-readers/stripe-terminal.md): Take card payments on a Stripe reader at the till: set up the extension, connect a smart reader or a Bluetooth reader, and take the payment. - [SumUp Terminal Gateway](/hardware/card-readers/sumup.md): Take card payments on a SumUp reader at the till: set up the extension, pair a Solo over the cloud or connect a Bluetooth reader in the app, and take the payment. - [Windcave Terminal Gateway](/hardware/card-readers/windcave.md): Take card payments on a Windcave terminal from the WCPOS checkout, refund them, and set up the Windcave Terminal extension (HIT) in WP Admin. ### cash-drawer Plug the cash drawer into the receipt printer, turn on Auto-open cash drawer, and test it. What opens the drawer, and what to check when it stays shut. - [Cash Drawer](/hardware/cash-drawer.md): Plug the cash drawer into the receipt printer, turn on Auto-open cash drawer, and test it. What opens the drawer, and what to check when it stays shut. ### customer-display Pair a second screen with a till in Settings → Customer Display so the customer sees the cart and total, choose what it shows for each store, and fix a display that can't connect. - [Customer Display](/hardware/customer-display.md): Pair a second screen with a till in Settings → Customer Display so the customer sees the cart and total, choose what it shows for each store, and fix a display that can't connect. ### receipt-printers Add a receipt printer in WCPOS, change its settings, test it, and choose which printer each template prints to. - [Receipt Printers](/hardware/receipt-printers.md): Add a receipt printer in WCPOS, change its settings, test it, and choose which printer each template prints to. - [Bluetooth Printers](/hardware/receipt-printers/bluetooth-printers.md): Your Bluetooth printer isn't on the list when you add it, or its test page doesn't print: where each app looks, Classic versus Low Energy, and pairing on Android. - [Cloud Printing](/hardware/receipt-printers/cloud-printing.md): Send receipts to a printer that isn't connected to the till, and print orders automatically: Star CloudPRNT, Epson Server Direct Print, Star Online and PrintNode. - [Epson Secure Printing](/hardware/receipt-printers/epson-secure-printing.md): New Epson printers sold in the EU and UK ship with Secure Printing on. When the app can print with it on, when it can't, and how to turn it off. - [Network Printers](/hardware/receipt-printers/network-printers.md): Why a network printer isn't found, or stops working after weeks: another network, guest Wi-Fi, or an address that moved. Read the address, fix it, and add the printer by its address. - [Printer Setup Wizard](/hardware/receipt-printers/printer-setup-wizard.md): Add a receipt printer in the app, print the test page, and answer a few questions to fix it if nothing comes out. - [Supported Printers](/hardware/receipt-printers/supported-printers.md): Which receipt printers are tested, which are expected to work and which are not supported yet, what the Vendor setting does, and how to report your printer. - [USB Printers on Linux](/hardware/receipt-printers/usb-printers-linux.md): On Linux the desktop app needs your permission to use a USB receipt printer. One udev rule gives it, and the printer then prints. - [USB Printers on Windows](/hardware/receipt-printers/usb-printers-windows.md): On Windows the desktop app prints to a USB receipt printer through Windows. If the app can't find it, install the printer in Windows first, with the Generic / Text Only driver if it has no driver of its own. ## settings Open Settings in the POS, find its seven pages, and know which settings stay on this device and which the store owner sets in WordPress for every till. - [Settings](/settings.md): Open Settings in the POS, find its seven pages, and know which settings stay on this device and which the store owner sets in WordPress for every till. ### checkout Choose which payment methods the till offers and in what order, set the order status each one gives a sale, stop the POS selling stock you don't have, and pick which emails POS orders send. - [Checkout](/settings/checkout.md): Choose which payment methods the till offers and in what order, set the order status each one gives a sale, stop the POS selling stock you don't have, and pick which emails POS orders send. - [Email Notifications](/settings/checkout/email-notifications.md): Choose which WooCommerce emails go out for POS sales: to the admin, to the customer and to the cashier who made the sale. - [Payment Gateways](/settings/checkout/payment-gateways.md): The WCPOS payment gateways: card terminals, phone payments and invoices. Where each one shows at checkout, how to add one to your store, and what to do when it doesn't show. - [Payment Methods](/settings/checkout/payment-methods.md): The ways your store takes payment at the till: Cash and Card in every store, card readers and other gateways with WCPOS Pro, cash rounding, why a tile can't be used, and what to do when a payment gets stuck. ### general The General screen in WP Admin: store details, the register, POS-only products, decimal quantities, the barcode field, the default customer, customer receipts, privacy and HTTPS. - [General](/settings/general.md): The General screen in WP Admin: store details, the register, POS-only products, decimal quantities, the barcode field, the default customer, customer receipts, privacy and HTTPS. ### languages - [WCPOS Polylang](/settings/languages/polylang.md): Show each product once in the POS, in one Polylang language, and pick that language per store with WCPOS Pro. - [Translations](/settings/languages/translations.md): Fix a word in the POS, the plugin or these docs in your language: see it on screen, find it on GitHub, and open a pull request. - [WP Multilang](/settings/languages/wp-multilang.md): Show the POS only the products sold in one WP Multilang language, chosen per store with WCPOS Pro. - [WPML](/settings/languages/wpml.md): Show each product once in the POS, in one WPML language, instead of once per translation. ### pos-settings Open Settings in the POS and find the right page: General, Tax, Printing, Card readers, Customer Display, Barcode Scanning and Theme. - [POS Settings](/settings/pos-settings.md): Open Settings in the POS and find the right page: General, Tax, Printing, Card readers, Customer Display, Barcode Scanning and Theme. ### receipt-templates Choose the receipt WCPOS prints: add a template from the gallery, make it the default, send it to the right printer, and see where each part of the receipt comes from. - [Receipt Templates](/settings/receipt-templates.md): Choose the receipt WCPOS prints: add a template from the gallery, make it the default, send it to the right printer, and see where each part of the receipt comes from. - [Customise Your Receipt](/settings/receipt-templates/customise-receipt.md): Change how your WCPOS receipt looks: pick a ready-made template, ask AI to tweak one, or edit it by hand, then choose which ones cashiers can print. - [HTML Templates](/settings/receipt-templates/html-templates.md): Write and edit HTML receipt templates with Mustache placeholders, check them on a real order, and fix the common mistakes. - [Online Store Receipts](/settings/receipt-templates/online-store-receipts.md): Let online customers download their own receipt or invoice from My Account, made from your WCPOS receipt template. - [Receipt Data](/settings/receipt-templates/receipt-data.md): Every field a receipt template can print, from the store name to the totals, with copy-ready snippets for HTML and thermal templates. - [Thermal Templates](/settings/receipt-templates/thermal-templates.md): Write XML receipt templates for ESC/POS and Star thermal printers: every element, column layout, the preview, and what changes on paper. ### sessions See who is signed in to the POS and on which devices, and sign a lost device or a departed cashier out from WP Admin. - [Sessions](/settings/sessions.md): See who is signed in to the POS and on which devices, and sign a lost device or a departed cashier out from WP Admin. ### store-defaults Set the store name, language, default customer and money format the POS uses on this device, and restore the values from your WooCommerce store. - [Store Defaults](/settings/store-defaults.md): Set the store name, language, default customer and money format the POS uses on this device, and restore the values from your WooCommerce store. ### tax - [Customer Tax IDs](/settings/tax/customer-tax-ids.md): Add a customer's VAT number, ABN, CPF or other tax ID in the POS, print it on their receipts, and choose which WordPress field it is saved in. - [Fiscal Compliance](/settings/tax/fiscal-compliance.md): Where WCPOS stands on fiscal till laws country by country (France NF525, Spain VeriFactu, Norway, Chile, EU OSS), what 2.0 already records, and what 2.1 adds. - [POS Tax](/settings/tax/pos-tax.md): What each row on the POS Tax settings page does, which values come from WooCommerce, and how to check the tax rates on this device. - [Store Tax IDs](/settings/tax/store-tax-ids.md): Add the VAT, ABN, GSTIN, EIN or company-registry numbers that WCPOS prints on POS receipts and invoices, for the whole site or, with Pro, for each store. - [WooCommerce Tax](/settings/tax/woocommerce-tax.md): Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how to set it up, what to expect at the till, and how POS orders get their rates. ### theme Change how the POS looks on this device: ten themes, the Scale of buttons and text, and the icons and fonts it draws. - [Theme](/settings/theme.md): Change how the POS looks on this device: ten themes, the Scale of buttons and text, and the icons and fonts it draws. ### wp-admin-settings Find every WCPOS setting in WP Admin → POS → Settings: the General, Checkout, Cloud Print, Access, Sessions and Extensions screens, the Tools and Account pages, store details, Force SSL, and what the receipt font warning means. - [WP Admin Settings](/settings/wp-admin-settings.md): Find every WCPOS setting in WP Admin → POS → Settings: the General, Checkout, Cloud Print, Access, Sessions and Extensions screens, the Tools and Account pages, store details, Force SSL, and what the receipt font warning means. ## error-codes Reference guide for every WCPOS error code, grouped by domain, with what each one means for your data and how to troubleshoot it. - [Error Codes](/error-codes.md): Reference guide for every WCPOS error code, grouped by domain, with what each one means for your data and how to troubleshoot it. ### 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. ### AUTH341 This store reports the same identity as a store already saved on this device. - [AUTH341: Store identity clash](/error-codes/AUTH341.md): 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. - [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. ### CLIENT161 This browser tab does not currently run the register, so it did not send a new payment request. - [CLIENT161: This tab does not run the register](/error-codes/CLIENT161.md): 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. - [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. ### DISPLAY101 The customer display could not build the cart snapshot and shows the idle screen until the next change. - [DISPLAY101: Customer display snapshot failed](/error-codes/DISPLAY101.md): The customer display could not build the cart snapshot and shows the idle screen until the next change. ### 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. ### PAYMENT111 The store recorded this payment, but the till could not save its own copy. - [PAYMENT111: Payment recorded, till copy not saved](/error-codes/PAYMENT111.md): 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. - [PAYMENT113: Invoice sent, but this till's copy did not save](/error-codes/PAYMENT113.md): 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. - [PAYMENT121: Card charged, order not finished](/error-codes/PAYMENT121.md): The card was charged, but the order did not finish. ### 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. ### PAYMENT211 The terminal did not take this payment. - [PAYMENT211: Terminal refused the payment](/error-codes/PAYMENT211.md): The terminal did not take this payment. ### PAYMENT212 The gateway did not accept this payment. - [PAYMENT212: Gateway refused the payment](/error-codes/PAYMENT212.md): The gateway did not accept this payment. ### PAYMENT213 The store refused to record this payment. Nothing was taken. - [PAYMENT213: Store refused to record the payment](/error-codes/PAYMENT213.md): The store refused to record this payment. Nothing was taken. ### PAYMENT221 A payment could not be voided, so that money is still held. - [PAYMENT221: Void refused](/error-codes/PAYMENT221.md): A payment could not be voided, so that money is still held. ### 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. ### PAYMENT501 The order had already been paid online, so the payment taken at the till is an additional one. - [PAYMENT501: Order already paid online](/error-codes/PAYMENT501.md): 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. - [PAYMENT511: More taken than the order owed](/error-codes/PAYMENT511.md): More was taken at the till than the order still owed. ### 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. ### REGISTER101 Your store refused a paid in, paid out or no sale that the till has already recorded. - [REGISTER101: Cash movement refused](/error-codes/REGISTER101.md): 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. - [REGISTER111: Cash movement reversal refused](/error-codes/REGISTER111.md): 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. - [REGISTER201: Register could not be opened](/error-codes/REGISTER201.md): 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. - [REGISTER211: Register count refused](/error-codes/REGISTER211.md): 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. - [REGISTER212: Drawer carry failed](/error-codes/REGISTER212.md): 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. - [REGISTER221: Register already open on another device](/error-codes/REGISTER221.md): 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. - [REGISTER231: No permission to run the till](/error-codes/REGISTER231.md): 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. - [REGISTER301: Manager approval refused](/error-codes/REGISTER301.md): Your store would not accept the manager approval for this count, so the register is still open. ### 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. ### SYNC203 Your store no longer has this order, so this device settled its own copy. - [SYNC203: Record gone on store](/error-codes/SYNC203.md): Your store no longer has this order, so this device settled its own copy. ### 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. ## developers ### architecture How WCPOS is built: the plugin on your WordPress site, the POS app on each till, the database the till sells from, how the two stay in step, and how checkout records payments. - [Architecture](/developers/architecture.md): How WCPOS is built: the plugin on your WordPress site, the POS app on each till, the database the till sells from, how the two stay in step, and how checkout records payments. ### discount-records Developer reference for how WCPOS records a price changed at the till and an Add Discount line on the WooCommerce order, how both interact with coupons, and the filter and receipt fields that expose them. - [Discount Records](/developers/discount-records.md): Developer reference for how WCPOS records a price changed at the till and an Add Discount line on the WooCommerce order, how both interact with coupons, and the filter and receipt fields that expose them. ### gateway-checkout-fields For gateway developers: two filters let the POS draw your gateway's checkout fields on the tender pane with its own controls, then run your gateway's process_payment() with what the cashier enters. - [Gateway Checkout Fields](/developers/gateway-checkout-fields.md): For gateway developers: two filters let the POS draw your gateway's checkout fields on the tender pane with its own controls, then run your gateway's process_payment() with what the cashier enters. ### gateway-template Build your own POS-only payment gateway for WCPOS from the gateway template: one PHP file, a setup script and automatic GitHub releases. - [Gateway Template](/developers/gateway-template.md): Build your own POS-only payment gateway for WCPOS from the gateway template: one PHP file, a setup script and automatic GitHub releases. ### role-endpoint-access Developer reference: which WCPOS REST endpoints the administrator, shop_manager and cashier roles can reach, how a refused request is answered, and how to tell a role problem from a sign-in problem. - [Role Endpoint Access](/developers/role-endpoint-access.md): Developer reference: which WCPOS REST endpoints the administrator, shop_manager and cashier roles can reach, how a refused request is answered, and how to tell a role problem from a sign-in problem. ### search-matching Which fields each search box in WCPOS looks at, how the words you type are matched, phone numbers, and the wcpos_search_fields filter for a store's own fields. - [Search Matching](/developers/search-matching.md): Which fields each search box in WCPOS looks at, how the words you type are matched, phone numbers, and the wcpos_search_fields filter for a store's own fields. ### sync-engine Developer reference for the WCPOS 2.x sync engine: one database per store and cashier, background lanes, the change check, coverage, the write queue, one live browser tab and local storage. - [Sync Engine](/developers/sync-engine.md): Developer reference for the WCPOS 2.x sync engine: one database per store and cashier, background lanes, the change check, coverage, the write queue, one live browser tab and local storage. ### sync-performance The numbers behind Store health's Performance tab: what each sync setting costs your server, how the POS backs off when your server struggles, and how the till stays responsive. - [Sync Performance](/developers/sync-performance.md): The numbers behind Store health's Performance tab: what each sync setting costs your server, how the POS backs off when your server struggles, and how the till stays responsive. ### woocommerce-rest-api How WCPOS reads your store through the WooCommerce REST API, how to see the data the POS holds on the JSON tab, and why plugins that change prices or products on the fly don't reach the till. - [WooCommerce REST API](/developers/woocommerce-rest-api.md): How WCPOS reads your store through the WooCommerce REST API, how to see the data the POS holds on the JSON tab, and why plugins that change prices or products on the fly don't reach the till. ## manage-store ### add-ons Add card terminals, multilingual catalogs, store credit and inventory locations to WCPOS. Install, update and turn off extensions from WP Admin, and list your own. - [Add-ons](/manage-store/add-ons.md): Add card terminals, multilingual catalogs, store credit and inventory locations to WCPOS. Install, update and turn off extensions from WP Admin, and list your own. ### compatible-plugins Which WooCommerce plugins WCPOS works with, what WCPOS does for each one, and what you need to do. - [Compatible Plugins](/manage-store/compatible-plugins.md): Which WooCommerce plugins WCPOS works with, what WCPOS does for each one, and what you need to do. ### coupons Find, make, change and delete your store's WooCommerce coupons from the Coupons screen in WCPOS Pro. - [Coupons](/manage-store/coupons.md): Find, make, change and delete your store's WooCommerce coupons from the Coupons screen in WCPOS Pro. - [Smart Coupons](/manage-store/coupons/smart-coupons.md): Keep StoreApps Smart Coupons store-credit balances right for POS orders, with the balance left on the receipt and a note on the order. ### customers Find, add, edit and delete your store's customers from the Customers screen in WCPOS. - [Customers](/manage-store/customers.md): Find, add, edit and delete your store's customers from the Customers screen in WCPOS. ### orders Find past sales in WCPOS, open an order to reprint its receipt, refund, re-open, sync or delete it, and settle sales that need attention. - [Orders](/manage-store/orders.md): Find past sales in WCPOS, open an order to reprint its receipt, refund, re-open, sync or delete it, and settle sales that need attention. - [Refund Rules](/manage-store/orders/refund-rules.md): Refund an order from WCPOS in full or in part: the refund form line by line, where the money goes, what happens if a refund fails, and how refunds show on the order. ### products The Products screen: find, sort and filter your catalogue, edit stock and prices in the list, edit a product or variation in its dialog, and choose the columns. - [Products](/manage-store/products.md): The Products screen: find, sort and filter your catalogue, edit stock and prices in the list, edit a product or variation in its dialog, and choose the columns. - [Custom Fields](/manage-store/products/custom-fields.md): Copy a product's extra fields onto the cart line with Meta Data Keys, and add, change or remove a custom field on one line. - [POS-Only Products](/manage-store/products/pos-only-products.md): Choose which products sell at the till, online, or both: switch on POS visibility, set it per product, in bulk or per variation, and see what the POS and your website show. - [Product Sync](/manage-store/products/product-sync.md): How products reach each till: the boot screen, the first download on a new device, keeping up with changes in your store, and refreshing the product list. ### reports Read a day's or a month's sales in WCPOS: the total and how it compares, payments, products, cashiers, taxes and refunds, then print or export any of them. - [Reports](/manage-store/reports.md): Read a day's or a month's sales in WCPOS: the total and how it compares, payments, products, cashiers, taxes and refunds, then print or export any of them. - [Closure Reports](/manage-store/reports/closure-reports.md): Balance the day in WCPOS: set the close rules, run the day at the till, then check, recount and export the numbered closures in Reports, and track down a variance. ### staff-permissions Choose what each WordPress role can do in the POS: the Access screen's tasks, the Cashier defaults, till permissions, the no-permission hints and Restore defaults. - [Staff Permissions](/manage-store/staff-permissions.md): Choose what each WordPress role can do in the POS: the Access screen's tasks, the Cashier defaults, till permissions, the no-permission hints and Restore defaults. ### stores What a WCPOS Pro store is, what each store sets for itself, how cashiers pick and switch stores, and how orders, reports, prices and stock follow the store. - [Stores](/manage-store/stores.md): What a WCPOS Pro store is, what each store sets for itself, how cashiers pick and switch stores, and how orders, reports, prices and stock follow the store. - [ATUM Locations](/manage-store/stores/atum-locations.md): Give each WCPOS Pro store the stock, prices and SKUs of its own ATUM Multi-Inventory location. - [Register Settings](/manage-store/stores/register-settings.md): Turn on opening and closing the register, set the opening float, the manager approval limit and the closing time. The free plugin has one register; more registers come with WCPOS Pro. - [Registers and Devices](/manage-store/stores/registers-devices.md): What a store, a register and a device are in WCPOS, how a device picks and switches them, what several devices on one register see, and which setups need WCPOS Pro. - [Set Up Stores](/manage-store/stores/set-up-stores.md): Create a store in WCPOS Pro, add its registers and cash rules, choose who can use it, and see what cashiers get at sign-in. ## releases ### previous-versions Go back to an earlier version of WCPOS or WCPOS Pro: turn off auto-updates, download the version you need, and upload it over the one you have, without deleting anything. - [Previous Versions](/releases/previous-versions.md): Go back to an earlier version of WCPOS or WCPOS Pro: turn off auto-updates, download the version you need, and upload it over the one you have, without deleting anything. ### roadmap What comes after WCPOS 2.0: fiscal compliance, control over what each cashier can do, and your other WooCommerce plugins at the till. How to ask for the feature your store needs. - [Roadmap](/releases/roadmap.md): What comes after WCPOS 2.0: fiscal compliance, control over what each cashier can do, and your other WooCommerce plugins at the till. How to ask for the feature your store needs. ### whats-new WCPOS 2.0 brings a new register, a checkout that belongs to the POS with split payments and card readers at the till, registers and a cash drawer in the free plugin, a customer-facing display, and receipts built for fiscal rules. - [What's New](/releases/whats-new.md): WCPOS 2.0 brings a new register, a checkout that belongs to the POS with split payments and card readers at the till, registers and a cash drawer in the free plugin, a customer-facing display, and receipts built for fiscal rules. ## sell Find your way around the POS: the menu, the bar at the top, the products and the cart, the phone layout, keyboard shortcuts and what to do when a warning appears. - [Sell](/sell.md): Find your way around the POS: the menu, the bar at the top, the products and the cart, the phone layout, keyboard shortcuts and what to do when a warning appears. ### cart The cart holds the order you're ringing up: who it's for, what's on it, extra charges and discounts, the totals, and how the cart looks. - [Cart](/sell/cart.md): The cart holds the order you're ringing up: who it's for, what's on it, extra charges and discounts, the totals, and how the cart looks. - [Apply a Coupon](/sell/cart/apply-coupon.md): Put one of your store's coupons on a sale: find it, apply it, remove it, and what to do when the till refuses it. - [Change Cart Items](/sell/cart/change-cart-items.md): Change a cart line's quantity or price, split it, edit or remove it, add custom fields, and set how the cart sorts its lines. - [Discounts](/sell/cart/discounts.md): Take money off at the till: a quick discount key or a new price on one item, a discount or a coupon on the whole order, and a new coupon made on the spot. - [Open Orders](/sell/cart/open-orders.md): Keep several sales going at once: switch between open orders, start a new one, hand an order to another cashier, register or store, print a bill and void what you no longer need. - [Order Details](/sell/cart/order-details.md): Order details at the till: add a note for the customer, hand the order to another cashier, change its currency, sync it to your store, print it or void it. ### close-register Close the day at the till: check the drawer, count it, file the numbered closure, match the card terminal and sign out. - [Close the Register](/sell/close-register.md): Close the day at the till: check the drawer, count it, file the numbered closure, match the card terminal and sign out. ### find-products Find a product at the till: search, filters, tiles and rows, Browse by, barcode scans and variations. - [Find Products](/sell/find-products.md): Find a product at the till: search, filters, tiles and rows, Browse by, barcode scans and variations. - [Product Display](/sell/find-products/product-display.md): Set up the Product Panel on this device: grid or table, tile size, Browse by, sort order, variations, tile fields, columns and the filter bar. - [Scan Barcodes](/sell/find-products/scan-barcodes.md): Scan products into the cart with a scanner or the camera, read what each scan message means, and set up scan sounds. - [Search Products](/sell/find-products/search-products.md): Find a product by name, SKU or barcode, narrow the list with the filter bar, and reset it with Clear all. - [Variable Products](/sell/find-products/variable-products.md): Pick the size, colour or other option of a variable product: open it in place, choose from a popover or an expanded row, or scan the option's own barcode. ### keyboard-shortcuts Ring up a sale from the keyboard: Alt shortcuts for search, checkout, carts, discounts and voids, and the list that shows them all. - [Keyboard Shortcuts](/sell/keyboard-shortcuts.md): Ring up a sale from the keyboard: Alt shortcuts for search, checkout, carts, discounts and voids, and the list that shows them all. ### offline-mode Keep selling when the connection drops: what the POS shows, what still works, how sales wait to send, and what needs your store. - [Offline Mode](/sell/offline-mode.md): Keep selling when the connection drops: what the POS shows, what still works, how sales wait to send, and what needs your store. ### open-register Start the day with a float, see what the drawer should hold, and move cash in and out of it. - [Open the Register](/sell/open-register.md): Start the day with a float, see what the drawer should hold, and move cash in and out of it. ### print-email-receipts What the paid screen tells you after a sale, how to print, email or download the receipt, and how to open a receipt again later. - [Receipts and the Paid Screen](/sell/print-email-receipts.md): What the paid screen tells you after a sale, how to print, email or download the receipt, and how to open a receipt again later. ### refunds Give a customer their money back from the POS: open the order, choose what to refund, pick where the money goes and confirm. - [Refunds](/sell/refunds.md): Give a customer their money back from the POS: open the order, choose what to refund, pick where the money goes and confirm. ### take-payment Take cash and give change, record a card from your own terminal, take part of the balance, and send the amount to a card reader. - [Take Payment](/sell/take-payment.md): Take cash and give change, record a card from your own terminal, take part of the balance, and send the amount to a card reader. - [Cancel a Payment](/sell/take-payment/cancel-payment.md): Undo the payments taken so far on an order that isn't finished, or just one of them, and see what has to go back to the customer. - [Email Invoice Gateway](/sell/take-payment/email-invoice.md): Send the customer an invoice by email instead of taking payment at the till, then follow it up from the Orders screen: send it again, cancel it, or take payment in the store. - [Legacy Tab](/sell/take-payment/legacy-tab.md): Take payment on your store's own payment page inside the POS, for payment methods that have no tile on the Payments tab. - [Payment Screen](/sell/take-payment/payment-screen.md): Choose how the customer pays at checkout: which methods give change, what the pay button does for each, and what changes when you're offline. - [Split Payments](/sell/take-payment/split-payments.md): Pay one order with more than one payment: part in cash and the rest another way, shared evenly, a set amount first, a percent, or item by item. - [Tips](/sell/take-payment/tips.md): How a tip the customer adds on a card reader lands on the order, which readers ask for one, and how to pay cash tips out of the drawer. - [Vipps MobilePay Gateway](/sell/take-payment/vipps-mobilepay.md): Take a Vipps or MobilePay payment at the till: the customer scans a QR code or approves a request sent to their phone. - [Web Checkout Gateway](/sell/take-payment/web-checkout.md): Let the customer pay for a POS order on your online store's payment page with the payment methods your web store offers, then press Process Payment for the receipt. ## troubleshooting ### clear-local-data Delete everything the POS stores on this device and download it again from your store: what to try first, how to check for unsent sales, and what happens after. - [Clear Local Data](/troubleshooting/clear-local-data.md): Delete everything the POS stores on this device and download it again from your store: what to try first, how to check for unsent sales, and what happens after. ### common-problems - [Checkout Problems](/troubleshooting/common-problems/checkout-problems.md): What to do when a payment method isn't available, the store doesn't answer, a payment or order is refused, or a gateway's payment page looks wrong. - [Cloudflare](/troubleshooting/common-problems/cloudflare.md): Stop Cloudflare's security checks from blocking the WCPOS app's connection to your store. - [Critical Error](/troubleshooting/common-problems/critical-error.md): What WordPress's critical error means at the till, where the POS shows it, and how to find the PHP error behind it. - [Plugin Conflicts](/troubleshooting/common-problems/plugin-conflicts.md): Find the WordPress plugin that is breaking the POS, and fix the plugins known to clash with WCPOS. - [Response Error](/troubleshooting/common-problems/response-error.md): What to do when your store answers the POS with an empty reply, an error page or stray text instead of data, including the old "Cannot read properties of undefined (reading 'data')" message. - [Totals Don't Match](/troubleshooting/common-problems/totals-dont-match.md): What it means when the POS says your store changed an order's totals, how to bring the POS back in line with your store, and what to send support. ### contact-support Get help with WCPOS: ask in Discord from the POS, copy your debug info from Store health, and know when to email support. - [Contact Support](/troubleshooting/contact-support.md): Get help with WCPOS: ask in Discord from the POS, copy your debug info from Store health, and know when to email support. ### logs Read the activity log on your till, find an error and its code, send the details to support, and check your store's own log in WP Admin. - [Logs](/troubleshooting/logs.md): Read the activity log on your till, find an error and its code, send the details to support, and check your store's own log in WP Admin. ### notifications The bell in the POS: plugin updates, licence notices and news from WCPOS, how to read them, and how to clear the red number. - [Notifications](/troubleshooting/notifications.md): The bell in the POS: plugin updates, licence notices and news from WCPOS, how to read them, and how to clear the red number. ### performance Find out why the POS is slow: read Store health first, then fix a slow checkout, slow updates or a struggling server. - [Performance](/troubleshooting/performance.md): Find out why the POS is slow: read Store health first, then fix a slow checkout, slow updates or a struggling server. - [Order Storage (HPOS)](/troubleshooting/performance/order-storage-hpos.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. - [Slow Checkout](/troubleshooting/performance/slow-checkout.md): Find out why checkout is slow: where the till waits for your store, how to measure it, and what to change on your website and the Legacy tab's payment page. - [Slow Server](/troubleshooting/performance/slow-server.md): See how your WordPress server is coping in Store health, what the POS does when it struggles, and what to change on your hosting. ### printer-problems - [Android Permissions](/troubleshooting/printer-problems/android-permissions.md): Allow Nearby devices so WCPOS on an Android phone or tablet can find your Bluetooth printer, and what to check when a Wi-Fi printer still isn't found. - [Browser Permissions](/troubleshooting/printer-problems/browser-permissions.md): Chrome's local network permission, mixed content and the printer's certificate — the three things that stop a browser reaching a printer. - [Epson Stopped Printing](/troubleshooting/printer-problems/epson-stopped-printing.md): An Epson that is holding a job it won't print refuses every other job too. Switching it off and on clears it in under a minute. - [iPad & iPhone Permissions](/troubleshooting/printer-problems/ipad-iphone-permissions.md): On an iPad or iPhone, a refused Local Network permission looks exactly like a printer that's switched off. Where to turn it back on. - [Non-Latin Receipts](/troubleshooting/printer-problems/non-latin-receipts.md): Question marks, boxes or the wrong letters on a printed receipt mean the printer is using the wrong character table. Set the receipt language, or print the receipt as an image. - [Receipt Logo Missing](/troubleshooting/printer-problems/receipt-logo-missing.md): The receipt printer prints everything but the store logo, and only from a browser. The logo's address is the cause; here is how to check it and fix it. - [Receipt Width](/troubleshooting/printer-problems/receipt-width.md): Read the test page's ruler, pick 32, 42, 48 or 64 characters per line, and fix receipts that wrap, stop short of the edge or cut the logo off. - [Server Direct Print](/troubleshooting/printer-problems/server-direct-print.md): When Server Direct Print is on, an Epson turns away every job the POS sends while its own web page and self-test still work. Turn it off, or print through Cloud Print. ### store-health Check what is on this till, what has not reached your store yet, how hard the POS is working your server, and the activity log. - [Store Health](/troubleshooting/store-health.md): Check what is on this till, what has not reached your store yet, how hard the POS is working your server, and the activity log. ## 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