2024-10-17 Changelog

• Customers API:

  • Customer object - The cards field will be retired in Square API version 2024-12-18. This field is replaced by the ListCards and ListGiftCards endpoints with the customer_id query parameter.

    Note that the retirement date for the deprecated CreateCustomerCard and DeleteCustomerCard endpoints isn't currently scheduled, but you should migrate to the Cards API and Gift Cards API as soon as possible. For more information, see Migration notes.

• Gift Card Activities API:

  Note

  The following November 1, 2024, changes to compliance limits are currently paused.

  • Starting November 1, 2024, compliance limits are changing for France, Ireland, Spain, and the United Kingdom. Square enforces compliance limits for gift card activities that load funds onto digital or physical gift cards.

    The following limits will be lowered:

    Limit	Country and change
    Maximum balance amount per gift card	France - From 750 EUR to 400 EUR Ireland - From 750 EUR to 400 EUR Spain - No change United Kingdom - From £750 to £400
    Maximum load amount per gift card per day	France - From 750 EUR to 400 EUR Ireland - From 750 EUR to 400 EUR Spain - No change United Kingdom - From £750 to £400
    Maximum load amount per payment card per day	France - From 7.500 EUR to 800 EUR Ireland - From 7,500 EUR to 800 EUR Spain - From 7,500 EUR to 800 EUR United Kingdom - From £7,500 to £800

• Refunds API:

  • RefundPayment endpoint - A new cash_details and external_details properties to record additional required details about cash and external refunds, respectively.

• Web Payments SDK:

  • (Beta) A new card payment method flow that uses additional parameters for tokenize() to initiate SCA and buyer verification without calling verifyBuyer() in payment requests. For more information, see Take a Card Payment with the Web Payments SDK.

• Refunds API:
  • RefundPayment endpoint - Updated the destination_id property definition to clarify how to manage linked refunds to Square payments and cross-method refunds with gift cards.

Learn about versioning for the Square API and SDKs.