Square Python SDK Quickstart

Learn how to quickly set up and test the Square Python SDK.

Link to section

Prepare for the Quickstart

Before you begin, you need a Square account and account credentials. You use the Square Sandbox for the Quickstart exercise.

  1. Create a Square account and an application. For more information, see Create an Account and Application.

  2. Get a Sandbox access token from the Developer Dashboard. For more information, see Make your First API Call.

  3. Install the following:

    • Python - Square supports Python version 3.7 and later.

    • Square Python SDK - To install it, use the pip command:

      pip install squareup


If you prefer to skip the following setup steps, download the Square Python SDK Quickstart sample and follow the instructions in the README.

Link to section

Create a project

  1. Open a new terminal window.

  2. Create a new directory for your project and then go to that directory.

    mkdir quickstart cd ./quickstart
Link to section

Write code

  1. In your project directory, create a new file named quickstart.py with the following content:

  2. Save the quickstart.py file.

    This code does the following:

    • Creates a Client object using your Square access token. For more information, see Set your Square credentials.
    • Calls the list_locations method on the client object.
    • If the request is successful, the code prints the location information on the terminal.
Link to section

Set your Square credentials

The Python code in this Quickstart reads your Square Sandbox access token from the SQUARE_ACCESS_TOKEN environment variable. This helps avoid the use of hardcoded credentials in the code.

For the following commands, replace yourSandboxAccessToken with your Square Sandbox access token:

Link to section

Linux or macOS

export SQUARE_ACCESS_TOKEN=yourSandboxAccessToken
Link to section

Windows: PowerShell

Set-item -Path Env:SQUARE_ACCESS_TOKEN -Value yourSandboxAccessToken
Link to section

Windows: Command shell

set SQUARE_ACCESS_TOKEN=yourSandboxAccessToken
Link to section

Run the application

  1. Run the following command:

    python ./quickstart.py
  2. Verify the result. You should see at least one location (Square creates one location when you create a Square account).

Link to section

See also