2022-03-16 Changelog

Square Customers API CustomerGroups API Subscriptions API Vendors API

Version Summary

• Square Version: 2022-03-16
• Java: 18.3.0.20220316
• .NET: 17.3.0
• Node.js: 17.3.0
• PHP: 17.3.0.20220316
• Python: 17.3.0.20220316
• Ruby: 18.1.0.20220316

Details

Link to section

New API releases

• Vendors API: (beta)

  • The initial release to support managing suppliers to a Square seller using the Square API.

Link to section

API updates

• Customers API:

  The following changes apply. For more information, see Migration notes.

  • CreateCustomer and SearchCustomers endpoints. Requests with unrecognized fields are now rejected.

  • CreateCustomer and UpdateCustomer endpoints. Requests with an invalid phone number or email address now return specific error codes.

• Customer Groups API:

  The following changes apply. For more information, see Migration notes.

  • CreateCustomerGroup endpoint. Requests that reuse an idempotency key from a previous request now return the response from the original request.

  • CreateCustomerGroup and UpdateCustomerGroup endpoints. Requests with unrecognized fields are now rejected.

• Subscriptions API:

  • The Subscriptions API is now available in France and Spain.

Link to section

Documentation updates

• Loyalty API:

  • Reorganized the Loyalty section of the documentation. This change includes the addition of the following new topics:

    • Retrieve a Loyalty Program

    • Create and Retrieve Loyalty Accounts

    • Manage Loyalty Points

    • Manage Loyalty Rewards

    • Search for Balance-Changing Loyalty Events

• Subscriptions API:

  • Manage Subscriptions. Added a link to the seller transaction fees for card payments and a note explaining that subscription charges incur these fees.

• App Marketplace:

  • App Marketplace API Usage Requirements. Updated this topic and API-specific topics to reflect current best practices for partner applications in the App Marketplace.