Troubleshooting: Square Reader and integration

Troubleshooting: Square Reader and integration

Most of the time the Square Reader is a very reliable piece of hardware. However, the Square Reader may become disconnected or start behaving erratically.  
If you are using the Square Stand and are connected using the Square Reader (not Square POS) gateway, ensure that the Square POS app is connected to the reader via bluetooth and not the Square USB hub. In this configuration the Square USB hub is known to be problematic.
Most issues can be resolved by:
  1. Force quit the SuitePOS app (versus send it into background).
  2. Hold the Square Reader button until all the lights on the reader flash red (this hard reset can take up to 10 seconds). 
  3. For the Square Gateway
    1. Open the Square POS app and ensure the Square Reader is connected
    2. Open the SuitePOS app
  4. For the Square Plus Gateway
    1. Openthe SuitePOS app
    2. Clickthe menu 

      icon and go to Settings and Connect Square Reader (following the instructions).
  5. Run a Square transaction.

In some situations, you may not be able to process returns. This is normally due to the fact that you have lost or have not authorized SuitePOS for Square and you need to. 

  1. Open the SuitePOS App
  2. Click the menu

    icon and go to Settings and Re-Authorize Square.
  3. Perform a Sync
You also may get errors to do with "mismatched location id" when running a Square transactions. This is due to Square Account (and location) that was authorized does not match the location id on the POS Settings record. Once corrected you will need to re-authorize Square per above.


    • Related Articles

    • Tutorial: Setting up Square Reader Gateway

      Square Reader uses the Square Reader SDK to process credit card payments. Unlike the Square POS integration, the Square POS app does not need to be installed (alongside SuitePOS) on your device. The Square Reader (with optional power dock) is ...

    • Square Payments Overview

      Square Payments is a great payment solution for retailers that want a modern, fast, easy to set up and a reliable gateway at competitive processing rates. SuitePOS is integrated using three methods: Square POS. Square Reader and Square Terminal. The ...

    • Tutorial: Setting up Square POS Gateway.

      SuitePOS uses the Square POS app in a special mode to process payments. Unlike Square Reader, this means the Square POS app will need to be installed alongside SuitePOS on your device. The Square Reader is connected via the USB hub to the Square ...

    • Tutorial: Setting up Square Terminal

      Square Terminal uses the Square Terminal API's to process credit card payments. The Square Terminal is connected via wifi to your local area network and can take contactless, chip and swipe payments. Step 1: Preliminary Order the Square Terminal from ...

    • Square Authorization Flow and OAUTH Tokens Explained.

      All our Square gateway integrations require Authorization in SuitePOS before transactions can take place. This is known as the "obtainToken flow". The following steps are involved using Square Authorization in the POS Settings Screen : Get an ...