# Square setup

## Requirements

To complete the setup, you will need:

1. A login for the Square account
2. A [Square Terminal](https://squareup.com/au/en/hardware/terminal) device 
    - Note: the integration **does not** support the Square Reader

## Square permissions

To pair SETLS with your Square account, your Square login must have "full access" as shown below. Permissions are set in the Square Dashboard under **Staff > Team > Permissions**.

[![image.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/SNyimage.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/SNyimage.png)

When logging into Square, SETLS requests the following permissions on your Square account.

<table border="1" id="bkmrk-permission-name-used" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**Permission name**</td><td>**Used to**</td></tr><tr><td><div><div>MERCHANT_PROFILE_READ</div></div></td><td>  
</td></tr><tr><td><div><div>PAYMENTS_READ</div></div></td><td>  
</td></tr><tr><td><div><div>PAYMENTS_WRITE</div></div></td><td>  
</td></tr><tr><td><div><div>DEVICES_READ</div></div></td><td>  
</td></tr><tr><td><div><div>DEVICE_CREDENTIAL_MANAGEMENT</div></div></td><td>  
</td></tr></tbody></table>

If you see the below screen, your permissions are not set correctly and you will need to see who in your team has full admin privileges for Square.  
[![error.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/L6werror.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/L6werror.png)

## Process

1. In the "Toy library" menu, click "Integrated Square" 
    - If you don't see this option, please contact <admin@setls.com.au>  
        [![square.PNG](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/square.PNG)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/square.PNG)
2. Click "Connect to Square" and log into Square  
      
    [![1.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/1.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/1.png)
3. The Square status page will refresh and show: 
    - Your Square "Business" and "Locations" details
    - A new access token
4. Click "Add Square Terminal" and set: 
    - Device name
    - Branch (optional)
    - NB: we only support one Terminal per branch  
        [![4.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/4.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/4.png)
5. Follow the on-screen instructions to log into the Terminal with the device code. When the Terminal is successfully paired, the dialog will close automatically.  
    [![5.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/5.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/5.png)
6. The Square status page will display the device details  
    [![6.png](https://wiki.setls.com.au/uploads/images/gallery/2025-05/scaled-1680-/6.png)](https://wiki.setls.com.au/uploads/images/gallery/2025-05/6.png)

<div id="bkmrk-you%27re-now-ready-to-">You're now ready to accept payments!</div>