Skip to main content

Point of Sale (POS) Card Reader Installation

Installation Guide for Point of Sale (POS) Card Reader

K
Written by Kurt Bernhard

The Laundroworks POS Card Reader is a desktop reader that can be controlled by Point-of-Sale software such as Cents, Wash-Dry-Fold POS, CleanCloud, Curbside Laundries, LAUNDROMax, TMS/CleanTie, or the Point Of Sale Tool within the LaundroPortal.
​

This allows customers to pay for POS purchases using the balance on their Laundroworks Laundry Card/LaundryCat App account directly.

If you're trying to connect one of these packages to your Laundroworks system, ensure you have a Laundroworks POS Card Reader kit, as it is not possible to integrate this functionality with your POS system, without one of our POS readers!

Laundroworks desktop POS Card Reader displaying a sale amount as a Laundry Card is placed above it

​

Installation Summary


Installing the Laundroworks POS Card Reader

Step 1: Number the Laundroworks POS Card Reader as POS1

DIP switches on the back of the POS Card Reader, with switches 1 to 7 down and switch 8 up (ON) to number it as POS1

There are DIP Switches on the back of the POS Card Reader that are used to set its reader number. Most stores only require 1 POS Card Reader, so this reader should be numbered as POS1
​

To do this, set all DIP Switches to their DOWN/OFF positions, except for the last one (#8) which should be in the UP/ON position. This will address the Card Reader as POS1 (this is the same process as for assigning laundry machine card reader numbers).

​

In rare cases where you have more than 1 POS reader, you'll need to assign each POS reader a different reader number.
​

Review our: Card Reader DIP Switch Settings article for more details on assigning Card Reader numbers
​

Step 2: Connect the Card Reader to Wall Power

The Card Reader does NOT need to be physically connected to your POS system, nor the Laundroworks system; the only physical connection required is wall power.
​

The reader will communicate with your VAC01 kiosk wirelessly, via VAC01's Zigbee Network, and VAC01 is what allows for communication with your external POS system.
​

Simply connect the POS Card Reader to any available power outlet, using the provided external reader power supply:

External power supply for the POS Card Reader


​

Step 3: Activate the Card Reader using the Store's Activation Card

Once the POS Reader powers ON, it should display "POS1 - Not Activated" after booting up.

Place this specific location's Activation Card on the card reader for a few seconds to activate it to this location:

POS Card Reader displaying Activated and the Location ID after the store's Activation Card is placed on it

Note: you MUST use the Activation card for THIS SPECIFIC LOCATION,

or else the card reader will not appear on the LaundroPortal for this location​

Once the Card Reader has been activated to this specific location,

it will automatically add itself to the Machines table, on the LaundroPortal:

LaundroPortal Machines list showing the POS1 reader with an OK - Idle status

Once a POS reader is activated to the store, this will also trigger the LaundroPortal to display the Point Of Sale section listed under the Management Tools section for this location:

Point Of Sale option highlighted in the LaundroPortal's Management Tools section

The above Point Of Sale menu is required in order to configure your chosen POS system to be able to communicate with your Laundroworks POS Card reader.
​

Do not proceed to configuring your POS software until you see:

  1. Your Laundroworks POS Card Reader showing up Online in the Machines list

  2. You're seeing the Point Of Sale section in your Management Tools section.

Note: You will NOT see the Point Of Sale menu option in your Management Tools section until you've activated a POS Card Reader to your store, and it's showing up on your LaundroPortal's Machines list.


How it works

While the Laundroworks POS Card Reader can be used as a stand alone reader to accept payments from Laundry Cards and LaundryCat App accounts (without the need of an actual POS system); by far the most common use of these readers is to integrate your Laundroworks system with Cents POS (or any of the other supported 3rd Party POS systems).

In order to use this reader with a supported POS system, you will need to configure the POS system in order for it to be able to communicate with your VAC kiosk, and by extension the Laundroworks POS Card Reader.

Once configured, the way the Laundroworks POS reader works is you will first initiate a transaction from your POS system; the POS system will give you the option to forward the transaction to the Laundroworks POS Card Reader if that's the payment method your customer is choosing to use.

The transaction will then be forwarded to your VAC01 kiosk, which will immediately forward the transaction details to your Laundroworks POS Card Reader; the transaction amount will appear on the Laundroworks POS Card Reader's display.

Your customers can then use a Laundry Card, or LaundryCat App account, to pay for that transaction using the Laundroworks POS Card Reader.

Once the Laundroworks POS reader processes the Laundry Card/LaundryCat App account payment, those details are returned to your POS system to indicate that payment was received for that specific transaction.


Configuring the POS Software

Select the Point Of Sale option found in the Management Tools section, and this will take you to a page where you may:

  • obtain credentials/settings to apply to your external Point-of-Sale software

  • test and run basic transactions against your Location's POS Readers

  • view records related to previous Point Of Sale transactions made​

Step 1: Select your POS Provider

At the top of the Point Of Sale page, you will find the credentials you'll need to enter into the external POS system you're integrating with.

Use the drop down menu to select your specific POS Provider

The POS Provider Credentials section is ONLY used to display the correct credentials for a given POS Provider.
​

Anytime you navigate away from this page, the POS Provider will return to its default value; this does NOT affect the POS reader's functionality in any way

You will then be shown the corresponding Configurations that would need to be applied in your external Point-of-Sale software, in order to link the Laundroworks POS Card Reader to your external POS System:

Point Of Sale Configuration Settings showing the POS Provider drop-down and the Laundroworks credentials for that provider

To actually configure your POS software to communicate with the POS Card Reader, you will copy the above credentials (they ARE case sensitive), and enter them somewhere within your selected POS system.
​

It is best to refer to your POS Provider's instructions to get specifics on where these credentials need to be entered;

however, it is strongly recommended that you test the POS reader, using the LaundroPortal directly, before moving on to configuring your external POS software.

If you're not seeing any credentials, and are instead presented with the following screen:

Point Of Sale page message stating there are no POS API users configured for this location

Please contact the Laundroworks support team so we can set up Credentials that your POS Provider can use for this integration

Once you've confirmed that the LaundroPortal is able to communicate with the POS Card Reader correctly, follow the instructions from your chosen POS Provider, in order to configure their POS system to be able to communicate with the Laundroworks POS Card Reader.

When available, you will find a quick link to the external POS Provider's instruction article, listed just below the POS credentials themselves:

Link to the POS provider's integration instructions, shown below the POS credentials

Step 2 - Running a Basic Test Transaction (using only the LaundroPortal)

Below the listed POS credentials, you'll be able to run a basic Transaction against your POS Card Reader;

this is useful to confirm the POS reader is communicating with your VAC01 correctly.
​

It is strongly recommended to test the POS reader, using the LaundroPortal, before attempting to configure the reader to work with your POS system.

Just below where the POS Credentials are listed, you'll find a Point Of Sale section which can be used to send transactions to the POS Card Reader from the LaundroPortal directly.
​

To run a Basic/Test transaction, you will:

  • Set a Transaction Amount (e.g. $0.01)

  • Choose the Command for the Transaction (e.g. Sale)

  • Choose the POS Device (the device should be displaying the "Device Online" message)

  • Optionally, write in a Comment to describe the transaction (e.g. Test Transaction)

  • Click Run Transaction

LaundroPortal Point Of Sale form with the Amount, Device, Command and Comment fields and the Run Transaction button

This will trigger the transaction to be sent to the POS Card Reader, and the Card Reader should then prompt for payment for this transaction's custom amount within a few seconds:

  • At this point a Laundry Card (either a user card, or Management Card) must be presented to the POS Reader within 30 seconds (if a Laundry User Card is not presented within 30 seconds, the transaction will timeout and will be automatically cancelled)

If a Laundry Card is placed on the reader within the 30 second window, the reader will charge the custom amount to the Laundry Card directly.

If the transaction was completed successfully:

  • the POS Reader will display an approved message

  • the Laundry Card's balance will be updated

  • and a Record of the transaction will appear in the Card-Tracker, Reader Logs, and in the Point of Sale Requests table at the bottom of the page:

Point of Sale Requests report showing an approved test sale on POS1

Using a Laundroworks POS Card Reader as a stand alone reader

The most common use of the Laundroworks POS Card Reader is for it to be integrated with a POS system, so that the POS system controls sending transactions to the Laundroworks POS Card Reader.

However, it is possible to use the POS Reader by itself, either as a stand alone reader that always charges the same amount for each purchase, or as a reader that you can send custom amounts to via the LaundroPortal.

POS Reader always charges the same amount (click to expand)

To set up a POS Card Reader so it always charges the same amount for every transaction, you'll need to change the POS reader's Control Type setting to "Fixed Price POS [0]":

POS1 Machine Configuration with the Control Type set to Fixed Price POS [0]

While a POS Card Reader is set to use the Fixed Price Control Type, the Card Reader will have a Fixed Price setting, which can be used to set what this Card Reader will charge whenever a Laundry Card/LaundryCat App account is tapped to the Card Reader.

In this configuration, any time a Laundry Card/LaundryCat App account is tapped to the reader, it will automatically charge its displayed fixed price.

POS Reader's price is controlled via the LaundroPortal (click to expand)

To set up a POS Card Reader so the price it charges is controlled via the LaundroPortal, you'll need to confirm the POS reader's Control Type setting is set to "API-Controlled POS [1]":

POS1 Machine Configuration with the Control Type set to API-Controlled POS [1]

This is the default setting all POS Card Readers are configured with, as this is the Control Type that is used in order for a POS system to be able to send transactions to the Card Reader.

Even if you're using a POS System to control this reader, it is always possible to send a transaction to the Card Reader directly via the LaundroPortal, while the Card Reader is set to the API-Controlled Control Type.

For instructions on how to send a transaction to the Card Reader via the LaundroPortal, review the run a Basic/Test transaction section of this article.


Reviewing Previous POS Requests

Every transaction request made against the POS Reader will create a POS Record for the Transaction, which may be reviewed in the Point of Sale Requests report that can be run at the bottom of the Point Of Sale menu at any time.

If the POS Reader interacts with an Account, either a Laundry Card (User or Management) or a Mobile App account (LaundryCat or WashLynx), a Reader Log will also have been created.

You may filter the transaction records for the POS Requests Report:

  • by Transaction Status

  • by the Transaction Command

  • to include corresponding Reader Log(s) found to be associated with a POS Record via the Reconcile with reader logs option

Note: the Reconcile with reader logs option is helpful to troubleshoot where unexpected results may have occurred for a given Transaction, for example:

  • a Transaction may NOT have registered a Status of Approved, yet a Credit/Debit was done against the used Account (Laundry Card/Mobile App Account) by the POS Reader, as evidenced by the Reader Log

  • more than one Credit/Debit was done against the used Account by the POS Reader for a single Approved Transaction, as evidenced by there being more than one associated Reader Log record for the same transaction

Typically these errors are a result of communication issues, either with respect to the Internet Stability on VAC01: see VAC Offline and Internet Issues

or Network Communication issues between VAC01 and the Readers: see Reader Network Communication Issues - Interference & Obstruction

You may also filter the displayed records by the Context field, which looks at the Comment & Requestor of transactions.

Point of Sale Requests report with the Reconcile with reader logs option enabled

Supported 3rd Party POS Systems


Troubleshooting

Below are problems commonly encountered during POS Card Reader installation.

For more general card reader troubleshooting, see the Card Reader Troubleshoot section of our Help Center.

Issue

Explanation and resolution

POS System is unable to send transactions to the Laundroworks POS Card Reader

Before troubleshooting this issue, first try running a basic test transaction via the LaundroPortal directly, as this will point out where the communication issue is likely coming from:

  • The LaundroPortal works to send transactions to the POS reader directly:

  • The LaundroPortal is unable to send transactions to the POS reader directly:

    • First try rebooting VAC01 kiosk, and the POS Card Reader, and then see if the LaundroPortal is able to send a transaction to the POS Card Reader directly.
      ​

    • If you see the following errors in the LaundroPortal's Point Of Sale section:

      Point Of Sale page errors showing that no POS API users are configured for this location

      there is no API user set up for the Point Of Sale section to use. Contact Laundroworks support to get an API user set up for your location
      ​

    • Ensure that VAC01 in your location is reporting online:

      LaundroPortal VACs section showing the VAC01 status, here reporting VAC Offline


      Only VAC01 communicates with Card Readers, so if VAC01 is offline, the POS reader will be unable to receive any transactions from the LaundroPortal.
      ​

    • Ensure the POS Card Reader is reporting as Online in the LaundroPortal's Machines list:

      LaundroPortal Machines list showing the POS1 reader online with an OK - Idle status


      If the POS reader is offline, that issue needs to be corrected first.
      If the POS reader is not showing up on the LaundroPortal's machines list, ensure it's been activated to the store, using the location specific Activation Card.

Did this answer your question?