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)