!!!important
Square has begun the retirement process for Connect v1 APIs. See the Connect v1 Retirement information page for details.
!!!

• GA releases: SDKs now support the new modify_tax_basis field to Discounts and v2 Sandbox
• BETA releases: SDKs now support the Shifts API webhooks for Labor shift created, updated, deleted, CreateLocation endpoint, and the ability to customize statement description in Payments API.
• Deprecated: Support for v1Items API and v1Locations API is fully deprecated.

Version 2.20190925.0 (2019-09-25)

• GA release: All SDKs have been updated to support the new Merchants API.

• Beta release: All SDKs have been updated to support the new endpoints (RetrieveLocation, UpdateLocation) added to the Locations API.

• Beta release: All SDKs have been updated to support the new field (mcc) added to the Location type.

• GA release: All SDKs have been updated to support the new field (bin) added to the Card type.

• GA release: All SDKs have been updated to support the new CardPaymentDetails fields (verification_results, statement_description, and verification_method).

• GA release: All SDKs have been updated to support the new Payment field, (employee_id).

Version 2.20190814.2 (2019-08-23)

• Bug fix: Fixed path parameters for UpdateOrder

Version 2.20190814.0 (2019-08-15)

• New functionality: All SDKs have been updated to support the Sandbox v2 BETA release
• Deprecated functionality: All Transactions API functionality is deprecated in favor of Payments API and Refunds API functionality.
• New functionality: All SDKs have been updated to support the Payments API GA.
• New functionality: All SDKs have been updated to support the Refunds API GA.
• New functionality: All SDKs have been updated to support Orders API updates:
  • Pickup Fulfillments, SearchOrders, and ServiceCharges move from BETA to GA.
  • New BETA endpoint: Orders.UpdateOrder — use the UpdateOrder endpoint to update existing orders.
  • New BETA functionality: Create shipment-type fulfillments.
• New functionality: Locations.RetrieveLocation — use the RetrieveLocation endpoint to load details for a specific Location.

Version 2.20190710.0 (2019-07-10)

• Breaking change — As of 2019-07-10 Java Connect SDK does not support explicit ENUM types. Instead, the SDKs pass ENUM values as static Strings. Developer code can now choose to ignore unexpected String values when Square APIs return new values instead of being forced to throw runtime errors due to unexpected types. Additional information, including migration help, is available in the README.

• Bug fix: Transaction.Charge and Customers.CreateCustomerCard request objects — now include the verification_token required for Strong Customer Authentication.

• BETA releases:
  • Orders API: supports service charges with a new field and datatype.
  • Catalog API: supports measurement unites for item variation quantities with a new field and datatype.
• New functionality: Order entities — now include a source field that contains details on where the order originated.
• Improved functionality: ListLocations — Expanded business information available through the Locations API, including business hours, contact email, social media handles, and longitude/latitude for physical locations.

Bugfixes

• Update Jackson to 2.9.9 to resolve vulnerability

• Beta functionality: Orders API — support for fractional quantities,
  expanded metadata, and embedded information on payments, refunds, and returns.
• Beta functionality: Inventory API — support for fractional quantities.
• New functionality: Locations.business_hours — read-only field with
  information about the business hours at a particular location.

• New functionality: Employees API (Connect v2) — New fields to
  capture contact information for employee profiles.
• New functionality: V1Tender.CardBrand — New V1 enum to represent
  brand information for credit cards.