Deprecation Policy
Note
We recommend that you make regular updates to your Braintree integration and update your client
SDK version at least once a year.
Overview
Braintree makes regular updates to our client SDKs and follows
semantic versioning guidelines with these updates. Whenever we
need to make updates that will require code changes to existing integrations, we increase the major
version number of the SDK to indicate that your integration will likely need to be updated for it to
work with the newest version. Examples of changes that would require a major version update:
- Adding or dropping support for a specific version of a mobile OS or web browser
- Security updates and changes
Note
We do our best to add support for these without introducing a new major version, but if the
changes required are great enough, they could result in a breaking change.
Platform support
We regularly review the most widely used browsers and OS versions for each of our client platforms
and make support decisions based on this information. The active major version of the Braintree
Android SDK will support the most widely used Android versions at the time of its release. For
example, the active Braintree Android SDK targets API level 21+.
Status categories
Client SDKs can have one of the following statuses:
| Status | Description | State of development |
|---|---|---|
| Active | An active SDK version is the most current and fully supported SDK. It is the recommended version to be used by everyone. Only 1 exists at a time. | This version will receive new features. |
| Inactive | An SDK becomes inactive once assigned a deprecation date. Any number can exist at a time. | No new features will be added, only security updates. |
| Deprecated | Processing will be supported for 1 year after the deprecation date, but you should upgrade immediately to avoid any disruption. Any number can exist at a time. | Deprecated SDKs will not receive updates. |
| Unsupported | A retired SDK version is no longer supported by Braintree developers or Braintree Support. Any number can exist at a time. | Processing for these SDKs can be suspended at any time. |
The README for each client SDK includes the status and deprecation dates for all major versions, and
we will update these statuses as we release new major versions.
Note
There may be unforeseen circumstances where we need to make exceptions to these statuses. If that
happens, we will do our best to communicate these changes.