Set up Square payment terminal with your kiosk device

When to use this

Use this guide to connect a physical Square payment terminal to your Displai kiosk device. This allows your kiosk to accept in-person payments through Square’s payment processing system.

Steps

1. Log into the Displai dashboard and navigate to the Screens page from the main menu.

2. Locate your kiosk device in the screens list, click the three-dot menu, and select Payment Terminal.

3. In the “Add a payment Terminal” modal, select Square and click Next.

4. Select your desired Square integration from the list and click Next. If no integration appears, add one from the Integrations page in the main menu first.

5. Enter your terminal details:

   • Give the terminal a nickname to identify it easily
   • Select the Square location where this terminal will be used

6. A pairing code will be generated in the dashboard. Leave this window open while you complete the next steps on your Square terminal.

7. On your physical Square terminal device, tap Sign in, then tap Use a Device Code.

8. Enter the pairing code displayed in the Displai dashboard when prompted on the terminal.

9. Once the terminal confirms successful pairing, return to the Displai dashboard and click Save to complete setup.

Verify

Your Square payment terminal should display a ready state and appear in your Screens list with the nickname you assigned. Test by processing a small transaction through your kiosk to confirm the terminal processes payments correctly.

If it doesn’t work

Pairing code expired or not accepted:

• Pairing codes typically expire after a few minutes. Generate a new code in the dashboard and try again immediately.
• Ensure you’re entering the code on the correct Square terminal device assigned to that location.

Square integration not appearing in step 4:

• Navigate to Integrations in the main menu and add a Square integration before attempting terminal pairing.
• Verify your Square account has active status and proper permissions.

Terminal fails to connect after pairing:

• Confirm the Square location selected in step 5 matches the location configured in your Square account.
• Check that your network allows the terminal to communicate with Square’s servers.

If pairing continues to fail after multiple attempts, contact support with your terminal device ID and the timestamp of your pairing attempts.

Related articles

• Connect Square POS to Displai Connect your Square POS account to Displai from the Integrations page so your Square menu items sync automatically.
• Unpair a Square payment device from Displai Disconnect a Square payment terminal from Displai by resetting or deleting its device code in Square, then removing it in Displai.
• Create a catalog synced with Square POS in Displai Create a catalog in Displai that pulls in your Square POS items so you can show them on your digital signage.