Get started
Color

Connect Square

Create a Square application, copy an access token and connect it so Pop Dispatch can verify your Square account.

For
OwnerAdministrator
Hosting
Office serverYour own hosting
Devices
ServerWeb browser
Business
All businesses

Checked against Pop Dispatch 0.1.0

You will connect your own Square account so Pop Dispatch can save the access token and check it with Test connection. Square charges you for payments on your account; Pop Dispatch adds no fee. Today this card only saves your account details and runs Test connection.

Before you start #

  • You need the owner or manager role.
  • Sign in to the Square Developer Console with the Square account you want to use. Read Square's pages on sandbox and production credentials at developer.squareup.com.

Make an application and access token #

  1. Open the Square Developer Console at developer.squareup.com and sign in.
  2. Open Applications and choose your application, or create one.
  3. Open the Credentials section for that application.
  4. Copy the access token for Sandbox or Production, whichever you are connecting. Square may show the token once; copy it before you leave the page.

Connect it in Pop Dispatch #

  1. Open Settings > Connections and find "Square payments".
  2. Paste the access token.
  3. In Mode, type sandbox while you test, or live for production.
  4. Select "Save details", then "Switch on".
  5. Select "Test connection". Pop Dispatch lists your Square locations with the token. The test sends no payment and charges nothing.
Technical details

Pop Dispatch checks the connection with a GET to https://connect.squareupsandbox.com/v2/locations when Mode is sandbox, or https://connect.squareup.com/v2/locations when Mode is live, with the access token as a Bearer token and the header Square-Version: 2024-10-17. Square documents this at developer.squareup.com.

If something goes wrong #

  • "Square did not accept the account details": generate a new access token in the Developer Console and save it again.
  • "Square did not answer": check the server's internet connection and try again.