Support Duration for Square Java SDK v40.1.0.20240604

Questions
1

Hi Square Team,

The process of upgrading the Square Java SDK from version 40.1.0.20240604 to 44.2.0.20250521 has been quite painful for us due to the significant changes in the SDK structure.

Could you please clarify:

  1. How long will the v40.1.0.20240604 SDK version continue to be supported?
  2. Is it possible for us to continue using this version indefinitely, or will it eventually stop working due to API incompatibilities or deprecations?

We would like to understand the risks of remaining on this version to evaluate whether we can postpone the upgrade or if we need to prioritize migrating despite the challenges.

Thank you for your guidance!

Best regards,
Murphy

2

:waving_hand: I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

Additional Documentation

Versioning in the Square API
Java SDK
Migrate from Deprecated APIs

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

3

Hey @murphyzhang!

There is not currently a public timeline for retirement of the Legacy version of the Java SDK. For now, it remains available for use alongside the new version. That said, I’d definitely still recommend upgrading to the newest version of the SDK in order to stay up to date with newly released features and fixes.

If you’re having trouble with the migration, I’m happy to help however I can!

4

Thank you for your continued support.

I would like to ask:

Is there a publicly available retirement schedule for legacy versions of the Square Java SDK?

If such a schedule exists, could you please share the documentation link with us?
If there is currently no publicly available schedule, would it be possible for the Square team to provide one or clarify the expected support timelines for older SDK versions?

This would help us better plan our upgrade path and ensure we remain compliant with Square’s best practices.

Thank you for your assistance!

Best regards,

5

@murphyzhang No public schedule exists, unfortunately. Older SDK versions are theoretically available indefinitely, although they will not receive new feature updates or fixes. Square will send out notice ahead of time if a version is being formally retired.