Get Started with Square Integrations

Learn whether your business is a fit for a Square integration by contacting Square for a demo, scheduling a consultation with a Square account executive, and completing all Square Bridge prerequisites. When all the prerequisites are met, you can onboard with Square Bridge.

Link to section

Step 1: Learn whether a Square integration is right for you

Not every seller can create a Square integration. In some cases, the seller's external system isn't yet supported by the Square Bridge integration tool. Other sellers might be hesitant to set up a sandbox environment in their external system, which is a necessity for Square Bridge. There might be other disqualifying factors that are discovered in your discussion with your account executive.

You need to schedule a demo with your account executive. During the demo, you can see the features of a Square integration and get an opportunity to talk with Square integration onboarding experts. They can help determine what Square Bridge can do for you.

In cases where a Square integration isn't a fit, there might be other integrations available through partners or sellers could build a custom integration using the Square API. Contact your account executive to understand different ways to integrate your external system to Square and determine which makes the most sense for your business.


Square assigns your account executive or account manager. For these instructions, these roles are the same. Square uses the title account executive to refer to the Square employee.

Link to section

Step 2: Start the Deal Support Request process

The Deal Support Request (DSR) is a collection of correspondence that describes the state of your deal with your account executive. It's continually updated throughout the requirements and scoping phases.

  1. Initiate a DSR - Contact your Square Sales account executive and ask them to file a DSR for Square Bridge.

  2. Requirements gathering and scoping - Your account executive contacts you to schedule a requirements gathering call. This is a technical call, which involves experts from your team and the Square Bridge team to evaluate your specific needs.

    This is followed by additional scoping calls, as needed, between your team and the Square Bridge team to refine the integration needs and assess how Square Bridge can help you.

  3. Start the integration - Integration begins after a successful scoping call. Your account executive and the Square Bridge team provide you with your start date.

Link to section

Step 3: Gather account credentials

To complete the onboarding process, you need up to five sets of credentials (usernames and passwords) for the accounts used with Square Bridge. You need to provide:

  • Two Square Accounts. One for testing and one for production.
  • Two ERP environments. One for testing and one for production. Some external systems require an account for each environment.
  • One Google or Microsoft account for signing in to the Square Bridge integration application.

You must verify and collect all these accounts before starting the integration.


Square asks for a separate Square account for testing because the Square Sandbox is intended to be a developer-facing tool. Square Bridge is an end-to-end solution that typically doesn't require development by sellers. By having a separate account for testing, transactions don't flow to your production ERP system and interfere with your financial reporting.

Link to section

Step 4: Confirm your Square account access

Ensure that you have credentials to access two Square accounts: one for production usage and one for testing purposes.

To confirm access and verify that you have sufficient credentials in your Square accounts, do the following in each account:

  1. Sign in to the Square account.

  2. In the Seller Dashboard, open the Team application.

  3. In the list of team members, choose yourself.

  4. In the information window that opens on the right side of the page, review your assigned permissions. If the permission set shows Owner or permissions show Full access, you have sufficient credentials. Otherwise, review the following list of permissions for which Square Bridge asks your authorization.

    Square Bridge: Authorize Square Bridge to access a Square account

Link to section

Your first integration

After you're approved for a Square integration, the onboarding process takes place in the following phases:

  • Run the Square Bridge integration to create an integration (see Using Square Bridge).
  • Test your integration in a testing environment (in both Square and your external system).

When onboarding is complete, you've created a fully functioning sandbox integration for testing and evaluation.

To start a new integration, run Square Bridge and answer the prompt to sign in using a Google or Microsoft email address.

  1. Go to

  2. Sign up with a Google or Microsoft account. If you want to use a Google account and don't have one, see Create a Google Account.

    A graphic showing the Square Bridge sign-in page.

  3. On successful authentication, you are prompted to agree to the Square terms of service. Accept the terms of service and choose Submit to continue.

    A graphic showing the Square Bridge Terms of Service page.


For security reasons, following 30 minutes of inactivity, you're automatically signed out of Square Bridge.

You're prompted to create your first Square integration with your ERP system.

A graphic showing a Square Bridge page with no integrations created yet.

  1. In Square Bridge, choose the Create Integration button to run the onboarding wizard that links a Square account with your external system account. The wizard walks you through the integration configuration and setup.

There are several ERP-specific onboarding topics that have additional onboarding steps that you must complete. After you complete an integration configuration, read Sync monitoring to learn about monitoring the health of your integration.


Create a test integration using an alternative Square account (using a different email address from your live Square account) with a non-production version of your external system environment.

Don't create an integration between your live Square account and external production system account until you've validated Square Bridge with test environments.

When integration testing is complete, create a production integration that uses the settings from your sandbox integration.

Link to section

Square integration support

If you encounter issues with your Square integration, email [email protected] For other issues regarding Square (unrelated to your Square integration), contact Support.

Link to section


Before you start the Square Bridge signup and configuration process, complete the following steps:

  1. Ensure that you have two Square accounts: one for production and one for testing.

Did you know?

If you want to provide access to your Square account to other members of your organization, you can use a set of credentials you are comfortable sharing or leverage Square's Full Access Team Member or Authorized Representative.

  1. Ensure that you have two ERP accounts: one for production and one for testing. When the Square Bridge team requests it, provide access to the ERP testing system.
  2. Ensure that you have a Google or Microsoft account available for Square Bridge. To request access, email [email protected].
Link to section

Next steps

To learn how to use Square Bridge to configure and manage an integration, see Using Square Bridge.