1. Showpass
  2. Hardware & Apps
  3. Payment hardware

Organizer guide: Setting up Square integration (OAuth)

Showpass Support
Updated

This guide walks you through connecting your Square account to Showpass (a one-time OAuth setup), then pairing your Square hardware. The same OAuth connection works for both Square Terminal and Square Stand setups.

OAuth is short for "open authorization." It's a one-time process that gives Showpass permission to talk to your Square account so card payments can be processed through your box office.

What you'll need

  • A Showpass organizer account with the Manage Integrations permission. Admins have it. If your role only has Box Office access, an admin can connect Square for you or add the permission to your role.
  • A Square account in the same name as your business.
  • Your Square hardware (Square Terminal, Square Stand, or Square Tap Reader).

Step 1: Connect your Square account (OAuth)

From Integrations (admin access)

  1. Log in to the Showpass Dashboard.
  2. Open the pop-out menu and select Integrations.
  3. Find the Square integration and click Connect Square Account.
  4. You'll be redirected to Square's login page. Enter your Square credentials.
  5. After logging in, you'll see the "Square Account Authorized" confirmation. Select a Square Location from the dropdown and click Save.
  6. Your Square account is now linked to your Showpass organization. This step is done once per organization.

From the Box Office

The Box Office Square settings need the Manage Integrations permission. If your role only has Box Office access, ask an admin to connect Square for you or to add that permission to your role.

  1. Navigate to your Showpass Dashboard and open the Box Office from the Sell Tix menu.
  2. Go to Settings → Square Integration.
  3. Click Connect account.
  4. You'll be redirected to Square's login page. Enter your Square credentials.
  5. After logging in, select the correct Square location.

Step 2: Pair your Square Terminal

Once OAuth is done, pair the physical Terminal device.

  1. In the Box Office, go to Settings → Square Integration.
  2. Click Connect terminal. Showpass displays a device code and a countdown showing when it expires.
  3. On the Terminal: select Sign In → Use a device code.
  4. Enter the device code on the Terminal using its keypad, then sign in.
  5. Return to the Showpass popup and click Check status. When pairing is complete, Showpass shows "Square Terminal is connected and ready to use!" and the terminal shows Connected.

Notes on device codes:

  • Pairing is tied to the individual Showpass login, so pair the Terminal while signed in as the person who will sell with it.
  • If the code expires before you finish, click Generate new device code and repeat the steps.
  • If your Terminal is already signed into another Square account, sign out first before entering the device code.

Step 3: Pair your Square Stand or Tap Reader

If you're using a Square Stand with a separate Tap Reader (older Stand model), pair the Tap Reader through the Showpass iPad app:

  1. Open the Showpass app on your iPad.
  2. Enter Point of Sale.
  3. Go to Settings > Square integration.
  4. Ensure Use in app payment processing is toggled on.
  5. Select Square Reader, then tap Pair a Reader.
  6. Follow the prompts to finish pairing.

The newer Square Stand model has a built-in card reader and doesn't need a separate Tap Reader pairing step.

Step 4: Verify the connection

Once paired, go to Settings → Square Integration in the Box Office. Your terminal shows Connected.

If something goes wrong