📣 Upgrade your integration to continue accepting Braintree payments

[stechiu]

Upgrade your integration to continue accepting Braintree payments

Braintree updated the root SSL certificate provider for api.braintreegateway.com (sandbox and prod) on April 12, 2024. The SSL certificates for current iOS SDK versions (v5 and v6) are set to expire by June 31, 2025.

If you do not update your SDK to the latest version with the updated certificates by June 31, 2025, 100% of your impacted traffic (client via the Android or iOS SDK, server via the server SDKs, server via self-pinning) will fail.

To reduce the impact, your developer will need to update your SDK to version 6.17.0. For details on how to include the SDK, see our setup guide found here.

What other SDKs will be impacted?

The following SDKs need to be updated to the latest version by June 31, 2025. Check the minimum server versions in the Braintree doc.

• Android v4
• Ruby v4, v3
• Python v4
• Java v3
• PHP v5, v6

When do I need to make this change?  

By June 31, 2025.

Is there any flexibility in the deadline?

No. Please work with your TAM to ensure you will meet the deadline in time.

What if I’m using a lower version?  

Android SDK

SDK	Update with new cert?	Details
Android SDK v3	No	Unsupported by June 2025. Upgrade to v4.45.0 or later
Android SDK v4	Yes	Upgrade to v4.45.0 or later
Android SDK v5	Yes	N/A (v5 is unreleased)
Android Drop-In SDK v5	No	Unsupported by June 2025. Upgrade to v6.16 or later
Android Drop-In SDK v6	Yes	Upgrade to v6.16 or later

iOS SDK

SDK	Update with new cert?	Details
iOS SDK v5	Yes	Upgrade to v5.26.0 or later
iOS SDK v6	Yes	Upgrade to v6.17.0 or later
iOS Drop-In SDK v9	No	Update v9.12.2 or later

This change is being updated only in version 6.17.0. Any lower versions must migrate to this version by June 31, 2025 to avoid impact of traffic to Braintree SDKs.

What changes does my developer need to make to my integration?  

Your developers needs to update the SDK (client and server) to the latest version to eliminate customer service disruptions and for good security practice.

Braintree's official recommendation is that Merchants use official SDKs, not modified ones. We cannot support modified SDKs. Reference our docs for our official SDK - https://developer.paypal.com/braintree/docs/

It is suggested to make this update as soon as possible to reduce any impacts to the customer experience.  

I've updated my SDK but I'm still getting emails to update

Braintree regularly pulls the latest list of impacted Merchants who need to update their SDK version before sending each email. If you have communicated with your TAM that you will updated but have not, then you will continue to receive email reminders until you have completed the update.

What happens if I don’t update or miss the deadline?

If you are still processing on a legacy SDK when our SSL Root Certificate update goes live, your API calls will no longer be able to reach Braintree's servers. Your customers will start to see errors when trying to complete checkout and their app logs will show SSL-related errors.

As a result, the specific error message you encounter won't be from Braintree, but rather from the language or framework you are using. The error message will likely be unique to that language or framework, but you can expect it to mention SSL – something along the lines of an invalid certificate, a refused connection, a failed handshake, etc. If you begin to encounter an error along those lines, double check that your integration has been updated to at least the minimum version, and then feel free to reach back out to us for further support.

What region is impacted by this change?

All (global)

[telegraham]

Is that June 30th 2025 or July 31st 2025?

Thanks!

[stechiu]

Is that June 30th 2025 or July 31st 2025?

Thanks!

Hi Graham! It should be June 30, 2025. I've updated the typo, thank you

[telegraham]

@stechiu late to this but I think the typo is also in the main project README — thanks for the update!

[jbloodwhatnot]

Howdy, finding the documentation here confusing. Its saying we must upgrade to 6.17.0, yet older SDK versions seem to have been updated to the lastest cert.

E.g. the braintree drop in sdk for iOS was updated in 9.13.0, as far as I can see. (Must be used with version v5.26.0 of the braintree_ios sdk). I believe the drop in SDK on iOS does not yet support 6.x yet. So I assume updating to these minor versions should suffice for now as this line in this doc is confusing me To reduce the impact, your developer will need to update your SDK to version 6.17.0. For details on how to include the SDK, see our setup guide found [here](https://developer.paypal.com/braintree/docs/guides/client-sdk/setup#get-the-sdk).