DEV Community

Cover image for Announcing Square’s New Python SDK
Richard Moot for Square Developer

Posted on • Originally published at developer.squareup.com

Announcing Square’s New Python SDK

We’re excited to announce the release of our new Python SDK. Run your business with Square APIs including Catalog, Customers, Employees, Inventory, Labor, Locations, Orders, and more.

To install the Python SDK, just pip install squareup from the command line. You can alternatively clone the SDK from GitHub and install it using python setup.py install --user. Next, all you need to do is provide your access token and you’re ready to use Square APIs.

from square.client import Client

client = Client(
    access_token='SANDBOX_ACCESS_TOKEN',
    environment='sandbox',
)

api_locations = client.locations
result = api_locations.list_locations()

One of the great features in the new Python SDK is that the response object contains new rich information about both the request and response. These details can be used for control flow and debugging.

Below are examples of checking the basic response status.

result.is_success()
#=> true

result.is_error()
#=> false

result.errors
#=> []

result.reason_phrase
#=> OK

result.status_code
#=> 200

If you were previously using the squareconnect SDK, you might be wondering how squareup compares. Let’s take a look! For example, let’s create the following customer along with their address:

customer = {
    "given_name": "Amelia",
    "family_name": "Earhart",
    "email_address": "Amelia.Earhart@example.com",
}

First, let’s look at how we used to create a customer with the legacy squareconnect SDK:

from __future__ import print_function

import squareconnect
from squareconnect.rest import ApiException
from squareconnect.apis.customers_api import CustomersApi

api_instance = CustomersApi()
api_instance.api_client.configuration.host = "https://connect.squareupsandbox.com"
api_instance.api_client.configuration.access_token = "SANDBOX_ACCESS_TOKEN"

try:
   # ListLocations
   api_response = api_instance.create_customer({
     "given_name": "Amelia",
     "family_name": "Earhart",
     "email_address": "Amelia.Earhart@example.com",
   })
   print(api_response.customer)

For comparison, let’s create the same customer with the new squareup SDK:

from square.client import Client

client = Client(
access_token='SANBOX_ACCESS_TOKEN',
environment='sandbox',
)
api_customers = client.customers
result = api_customers.create_customer({
 "given_name": "Amelia",
 "family_name": "Earhart",
 "email_address": "Amelia.Earhart@example.com",
})
print(result.body["customer"])

That’s all there is to it!

As you can see, the new squareup Python SDK interface is much simpler and less verbose. The new SDK also ships with a ton of usability and debugging features.

Give the squareup Python SDK a try today by installing it with pip install squareup.

With the new squareup SDK it’s easier than ever to use Square as a platform to run your business with Python. We can’t wait to see what you’ll build! If you have any questions or feedback, drop by our developer community. We’d love to hear from you.

Top comments (0)