Square APIs and SDKs

Web Payments SDK

App Marketplace Requirements

/

Square APIs and SDKs

2022-12-14 Changelog

Square

Customers API

OAuth API

Refunds API

Webhooks

BETA

Link to section

Version summary

Square Version: 2022-12-14
Java: 27.0.0.20221214
.NET: 25.0.0
Node.js: 25.0.0
PHP: 25.0.0.20221214
Python: 25.0.0.20221214
Ruby: 26.0.0.20221214

Link to section

Details

Link to section

API updates

Customers API:
- SearchCustomers endpoint. The following changes apply:
  - segment_ids filter. Added a filter to support searching customers based on their membership in customer segments. For more information, see Search by segment IDs.
  - custom_attribute filter and related filter objects. Moved to general availability (GA).
OAuth API:
- The RetrieveTokenStatus endpoint (beta) enables token introspection of an OAuth access token or an application's personal access token. For more information, see Token Introspection.
Refunds API:
- Added several Error codes to provide more detailed information about refund attempt failures:
  - CARD_PRESENCE_REQUIRED
  - UNSUPPORTED_SOURCE_TYPE
  - UNSUPPORTED_COUNTRY
  - UNSUPPORTED_CURRENCY
  - CARD_MISMATCH
Webhooks:
- Added a helper method to the Node.js SDK. For more information, see Webhook event notification validation.

Link to section

Documentation updates

Pagination. Added a note that the lifespan of a page cursor is 5 minutes.

If you need more assistance, contact Developer and App Marketplace Support or ask for help in the Developer Forums.