Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📣 Upgrade your integration to continue accepting Braintree payments #1277

Open
stechiu opened this issue Apr 18, 2024 · 4 comments
Open

Comments

@stechiu
Copy link
Collaborator

stechiu commented Apr 18, 2024

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)

@stechiu stechiu pinned this issue May 7, 2024
@telegraham
Copy link

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

Thanks!

@stechiu
Copy link
Collaborator Author

stechiu commented May 24, 2024

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

@agedd agedd unpinned this issue May 30, 2024
@agedd agedd pinned this issue May 30, 2024
@telegraham
Copy link

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

@braintree braintree deleted a comment from Emmanuelruina Sep 5, 2024
@jbloodwhatnot
Copy link

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).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants