2026-01-22 Changelog

Bank Accounts API

• New endpoints:
  • CreateBankAccount - Store a new customer bank account.
  • DisableBankAccount - Disable a customer bank account.

Catalog API

• Additional support for kitchen display systems for restaurant sellers. For more information, see Kitchen display names.

  • New kitchen_name and buyer_facing properties on the CatalogItem object.
  • New kitchen_name property on the CatalogItemVariation and CatalogModifier objects.

• New CatalogModifierToggleOverrideType enum.

• RETIREMENT: Mobile Authorization API

• RETIREMENT: Reader SDK

  • The Square Reader SDK and Mobile Authorization API are now retired. Existing Reader SDK integrations can no longer take payments. To ensure continued support and functionality for your application, you must migrate from the Reader SDK to the Mobile Payments SDK.

OAuth API

• New use_jwt parameter to use a JSON Web Token for authentication. JWTs behave the same as standard tokens. For more information, see JWT access tokens.

Orders API

• New blocked_service_charges property on the OrderLineItem object. Used to block ad hoc service charges on a line item.
• New auto_applied property on the OrderLineItemAppliedTax object.
• New type property on the OrderReturnServiceCharge object.
• New OrderCardSurchargeTreatmentType enum.

Payments API

• The Payments API now reports on the payment card surcharges that a seller might add to a card payment.
• New errors property on the Payment.BuyNowPayLaterDetails object.
• New errors property on the Payment.DigitalWalletDetails object.
• New created_at and disabled_at properties for the Payment.CardPaymentDetails.Card property.

Terminal API

• Terminal API now supports adding a surcharge to credit card payments in the US.

Common entities

• ErrorCode modified to add PARTIAL_PAYMENT_DELAY_CAPTURE_NOT_SUPPORTED and PAYMENT_SOURCE_NOT_ENABLED_FOR_TARGET enumerators.

Learn about versioning for the Square API and SDKs.