Update to Adyen’s 3DS2 Android SDK for Android 15
October 31, 2024 14:12
On October 15, 2024, a stable version of Android 15 was released and is currently available to download on already operating devices and potentially will come pre-installed on newly acquired devices. This version introduces support for 16KB page size devices, in addition to currently supported 4KB.
This article is meant for merchants who want their apps to target Android 15 (API 35). If your apps target lower Android API versions, there is no impact to your LIVE traffic, you can skip the article.
What does this mean?
Based on our testing, our previous SDKs (2.2.20 and earlier) are not fully compatible with Android 15, manifesting issues ranging from UI glitches, with no impact to transaction processing, to complete failure. Only the Adyen’s latest Android SDK version (2.2.21 for Classic or 5.7.0 for Checkout) is compatible with Android 15.
If you are using versions between 2.2.16 - 2.2.20 on Classic / 4.13.5 - 5.6.0 on Checkout, the SDK will not work on the new devices supporting 16KB page size, causing the merchant app to crash. Although the new devices are not released yet, we still strongly recommend merchants to upgrade to avoid future issues. Currently existing devices with 4KB page size running that version seem to only experience UI glitch, no impact to transaction processing.
If you are using versions between 2.2.12 - 2.2.15 on Classic / 4.11.0 - 4.13.4 on Checkout might experience minor UI glitches that do not impact transaction processing on any device. As depicted in the screenshot below, the cancel button might shift closer to the status bar, causing unintentional transaction cancellation.
Devices running Android SDK version below 2.2.12 are considered outdated and not eligible for testing. We cannot guarantee that transaction processing will not be impacted. We strongly recommend upgrading to the latest version to ensure stable live traffic.
Android SDK version | Checkout Android Component | Android 15 - 4KB page size (all current existing devices) | Android 15 - 16KB page size (new device model, not released yet) |
|---|---|---|---|
2.2.16 - 2.2.20 | 4.13.5 - 5.6.0 | UI problem No impact on LIVE traffic | Merchant app will crash |
2.2.12 - 2.2.15 | 4.11.0 - 4.13.4 | UI problem No impact on LIVE traffic | UI problem |
< 2.2.12 | < 4.11.0 | Too old for testing | Too old for testing |
What should I do?
Confirm if you want your app to target Android 15. If you target lower versions, there is no action required and no LIVE impact.
We advise you to confirm what version you are on by following the instruction linked below or check what you are sending in paymentMethod.threeDS2SdkVersion in payment request.
Upgrade your Checkout Android Component to 5.7.0 or Classic SDK version to 2.2.21.
Resources:
Getting SDK version Upgrading Checkout component Upgrading Classic SDK Compatibility Table