Skip to main content Skip to complementary content

Square 

Square is a large business technology platform serving all kinds of businesses. The Square operating system allows business owners to sell anywhere.

Square integration replicates data using the Square API version 2023-06-08.

See the Schema section for a list of objects available for replication.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Information noteMake sure that the account you use has read access to the tables you want to fetch.

To obtain your Application ID and Access Token:

  1. Log into your Square account.
  2. Click Account at the top right of the page.
  3. Click Dashboard.
  4. Navigate to Settings from the left navigation bar and click App Integrations.
  5. Click Manage at the right of the selected application.

Creating the connection

For more information, see Connecting to SaaS applications.

  1. Click Authenticate when you have filled in the required connection settings.

    You may be asked to log in to the source application.

    A window is displayed with an authentication code.

  2. Copy the code to the clipboard and return to the connection dialog.

  3. Paste the code in Complete authentication with the code provided by the source and click Verify.

    Tip noteYou may need to scroll down to see this field.

    When status is Verified, the authentication is verified.

  4. Provide a name for the connection in Connection name.

  5. Select Open connection metadata to define metadata for the connection when it has been created.

Connection settings
SettingDescription
Data gateway

Select a Data Movement gateway if required by your use case.

Information note

This field is not available with the Qlik Talend Cloud Starter subscription, as it does not support Data Movement gateway. If you have another subscription tier and do not want to use Data Movement gateway, select None.

For information on the benefits of Data Movement gateway and use cases that require it, see Qlik Data Gateway - Data Movement.

Start Date

Enter the date, in the format MM/DD/YYYY, from which the data must be replicated from your source to your target.

Application IDApplication ID.
Access TokenAccess Token.

Schema

Information note

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 2.

Depending on your destination, table and column names may not appear as they are outlined below.

bank_accounts

The bank_accounts contains information about a merchant’s bank account in Square.

Note: This table can’t be replicated if the Connect to a sandbox environment box is checked in the integration’s settings due to limits imposed by Square.

Replication Method

Full Table

Primary Key

id

Useful links

Square documentation

Square API method

cash_drawer_shifts

The cash_drawer_shifts table contains infomration about cash transactions in Square.

Replication Method

Full Table

Useful links

Square documentation

Square API method

categories

The categories table contains information about item categories for a given location in Square.

Replication Method

CDC

Primary Key

id

Replication Key

updated_at

Useful links

Square documentation

Square API method

customers

The customers contains information about customer profiles associated with your Square account.

Replication Method

CDC

Replication Key

updated_at

Useful links

Square API method

discounts

The discounts table contains information about discounts for a given location in Square.

Replication Method

CDC

Primary Key

id

Replication Key

updated_at

Useful links

Square API method

inventories

The inventories table contains info about the current calculated stock count for a Square location.

Replication Method

Full Table

Loading Behavior

Append-Only

Useful links

Square documentation

Square API method

items

The items table contains information about items for a given location in Square.

Replication Method

CDC

Primary Key

id

Replication Key

updated_at

Useful links

Square documentation

Square API method

locations

The locations table contains information about all of your business locations in Square.

Replication Method

Full Table

Useful links

Square documentation

Square API method

modifier_lists

The modifier_lists table contains information about modifier lists for a given location in Square.

Replication Method

CDC

Primary Key

id

Replication Key

updated_at

Useful links

Square documentation

Square API method

orders

The orders table contains information about order updates in Square.

Replication Method

CDC

Replication Key

updated_at

Useful links

Square documentation

Square API method

payments

The payments table contains information about all payments taken in Square.

Replication Method

Full Table

Useful links

Square documentation

Square API method

payouts

The payouts table contains information about all payouts made in Square.

Replication Method

Full Table

Useful links

Square documentation

Square API method

refunds

The refunds table contains information about refunds on items in Square.

Replication Method

Full Table

Useful links

Square documentation

Square API method

roles

The roles table contains information about employees’ roles in Square.

Note: This table can’t be replicated if the Connect to a sandbox environment box is checked in the integration’s settings due to limits imposed by Square.

Replication Method

Full Table

Primary Key

id

Useful links

Square documentation

Square API method

shifts

The shifts table contains information about employee’s shifts in Square.

Replication Method

CDC

Replication Key

updated_at

Useful links

Square documentation

Square API method

taxes

The taxes table contains information about taxes enabled on your items in Square.

Replication Method

CDC

Primary Key

id

Replication Key

updated_at

Useful links

Square API method

team_members

Replication Method

CDC

Replication Key

updated_at

Useful links

Square documentation

Square API method

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!