< Back to changelog

2021-02-26 Changelog

Customers API
Orders API
Payments API
Connect v1

Version Summary

Existing API updates Permalink Get a link to this section

SDKs Permalink Get a link to this section

  • All Square SDKs:

    By default, all SDKs send requests to Square's production (https://connect.squareup.com) or sandbox (https://connect.squareupsandbox.com) hosts based on the client's environment parameter.

    You now have the option to use a custom URL instead. To use a custom URL, follow the example for your language to set the environment parameter to custom and the customUrl parameter to your URL:

    • Java

      new SquareClient.Builder()
    • .NET

      new Square.SquareClient.Builder()
    • Node.js

      new Client({
        environment: Environment.Custom,
        customUrl: 'https://example.com'
    • PHP

      new Square\SquareClient([
        'environment' => Environment::CUSTOM,
        'customUrl' => 'https://example.com',
    • Python

        environment = 'custom',
        custom_url = 'https://example.com',)
    • Ruby

        environment: 'custom',
        custom_url: 'https://example.com'
  • Square .NET SDK:

    Square has overridden the Equals and GetHashCode methods for models:

    • In the Equals override, Square has implemented a field-level comparison.

    • The Square GetHashCode override now ensures that hashes are deterministic and unique for each object.

  • Square Node.js SDK:

    Endpoints that return 64-bit integers now return a BigInt object instead of a Number object.

  • Connect Node.js SDK: (deprecated)

    The deprecated Connect Node.js SDK is in the security maintenance state. It will not receive any bug fixes or API updates from the Square version 2021-02-26 release. However, the SDK will receive support and security patches until it is retired (end of life) in the second quarter of 2021. For more information, including steps for migrating to the Square Node.js SDK, see the Connect SDK README.

Documentation updates Permalink Get a link to this section

  • Catalog API:

  • Inventory API:

  • Get Started topic. Revised the Get Started experience. In addition to clarifications, it now includes the use of the Square Sandbox and API Explorer. These are the tools and environments developers use to explore Square APIs.