Braintree makes regular updates to our server SDKs which follow semantic versioning guidelines. This page will guide you through the largest breaking changes that are specific to the language you are integrating with Braintree. Check the SDK's [CHANGELOG](https://github.com/braintree/braintree_dotnet/blob/master/CHANGELOG.md) for more information on changes.
Previous versions of the Braintree .NET SDK targeted .NET Standard 1.3 to support older versions of .NET Core. Starting with version 5.0.0, the SDK targets .NET Standard 2.0 and NET Framework 4.5.2.
For .NET Core integrations, previous versions of the Braintree .NET SDK allowed you to opt-in to re-using a static HttpClient to avoid socket exhaustion scenarios. Starting with version 5.0.0, we removed this option and updated the SDK so that all configurations use one instance of HttpClient.
Previous versions of the Braintree .NET SDK used a custom
Enumeration class, which did not support JSON serialization. Starting with version 5.0.0, the SDK uses .NET
Enum types. Additionally, the type
MASTER_CARD in the
CreditCardType enum was renamed to
Down For Maintenance exceptions have been renamed to Service Unavailable exceptions, since we do not bring our services down to perform maintenance operations anymore.
We also added additional timeout exceptions to give extra clarity on the source (client request vs gateway response).
For more information, check our guide on Exceptions.