2022-12-14 Changelog

Square Customers API OAuth API Refunds API Webhooks

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

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.