Android Tap-to-pay SDK Changelog

We recommend updating to this version of the SDK for security enhancements.

New Features

• Added optional timeoutCardWaitSeconds to startPayment, allowing integrators to configure how long the SDK waits for card presentation.
• The default card-wait timeout is now 240 seconds. Supported values are clamped between 60 and 240 seconds.
• Updated SDK build support for Android 16 / API 36.
• Updated core security, attestation, obfuscation, and payment kernel dependencies.

Fixes

• Fixed an issue where rotating the device during an active transaction could interrupt the payment flow.
• Fixed a recovery issue where transactions could keep failing with “Could not connect to the server” after a temporary network failure until the app was restarted.
• Improved NFC card-read handling by retrying after supported L1 read errors.

Integration Notes

• Existing integrations continue to work without code changes.
• Integrators can optionally pass timeoutCardWaitSeconds when starting a payment to customize the card presentation timeout.

New Features

• Added support for SUNMI devices and other Android terminals that use internal (non-external) NFC adapters

Fixes

• Prevent fatal crash when the SDK performs an authenticated network request without an AuthTokenProvider configured

Fixes

• Reliability improvements
• Improved security

Fixes

• Fixed crashes caused by no network connection or authorization errors

New Features

• Improved security
• Improved transaction speed

Important

• Starting from this version, core library desugaring(Opens in a new tab) is required

New Features

• Improved test capabilities for the production environment
• WBC Rotation - January 2026
• The CardReadFailed -> UnexpectedOutcome error is caught, and the system smoothly retries reading the card

Fixes

• Fixed an issue where the SecurePin Entry screen closes after the first digit is entered on Zebra TC77 and Honeywell CT45 devices

New Features

• Added clear error screens for common problems, such as attestation failures when USB debugging is turned on.

Fixes

• Fixed infinite loading when NFC is disabled or unavailable on the device.
• Security improvements.
• Small UI improvements and bug fixes.

Fixes

• Added security improvements and bug fixes to enhance overall stability and performance of the SDK.

Fixes

• Added support for 16 KB page sizes.

Fixes

• Fixed wrong currency code in Peru.

Fixes

• Decreased the SDK size by removing unused resources.
• Fixed an issue where the testing SDK build would not initialize.

New Features

• Added support of Online Pin SCA (Strong Customer Authentication).
• Added card data to PaymentEvent.TransactionDone event: card type, card scheme, last four digits, and merchant code.
• Transparent attestation process. The SDK now returns error details if attestation fails in PaymentEvent.TransactionFailed event. This helps developers understand and resolve attestation issues more effectively.
• API changes to make it more concise. Now TapToPay.startPayment() function returns Flow<PaymentEvent> instead of Flow<Result<PaymentEvent>>.

New Features

• Added Products to TapToPay.startPayment method.
• Enabled periodic monitoring and attestation.
• Now SDK uses Google Trusted Time API.

Fixes

• Fixed a crash that occurred when attempting to make a payment without explicitly setting skipSuccessScreen parameter.
• Fixed a bug in Pixel 8 and Pixel 9 devices with Android 16 where the payment would immediately fail a transaction with timeout error.

Fixes

• Fixed a bug with payment availability when using OkHttp 5.0.0 or higher.

Fixes

• Miscellaneous bug and crash fixes

Fixes

• NoBeanFoundDefinitionError exception that occurred in some cases when starting a payment
• Miscellaneous bug and crash fixes

New Features

• Faster Transactions – Reduced latency when initiating transactions, resulting in faster checkout.
• Mitigated Threats Filter – Attestation now excludes resolved threats for smoother processing and less transaction failures.
• Affiliate Key Support – Added support for affiliate key integration.
• Success Screen Skip Flag – New flag to bypass the success screen.
• Support for targetSDK 35
• Client-Side Certificate Verification – Enhanced security with device certificate checks during attestation.
• Pre-PIN Attestation – Attestation is initiated before displaying the PIN screen to enhance security.

Fixes

• Resolved an issue during TapToPay initialization.

Fixes

• Fixed the class duplication issue occurring after obfuscation.

Fixes

• Mitigated threats are now filtered out during attestation. If a threat has "mitigated": true, it is excluded from the threat list that is used to determine whether the COTS is attested.

New Features

• New events of the payment process: card requested, card presented, CVM requested, CVM presented - New PaymentException types

Fixes

• Cleanup PAN data from memory
• Disable NFC for other apps during the payment process. - Handling empty candidates list in payment processing