Tap to Pay Screen Auto-Rotation Behavior on Android 14 vs Android 13

[Numan6141]

Summary

We’ve observed a difference in behavior with the Tap to Pay screen when using the Stripe Terminal SDK (v4.1.0) on a tablet:

• On Android 14: The Tap to Pay screen automatically rotates to landscape.
• On Android 13: The Tap to Pay screen does not auto-rotate and remains in portrait mode.

This inconsistency raises the question of whether the auto-rotation behavior on Android 14 is expected or if it’s related to a compatibility issue with the SDK on this version of Android.

Could you confirm if this behavior is intended? If not, is there a workaround or fix we should apply to ensure a consistent experience across both Android versions?

Looking forward to your response.

Android version

Android 14 vs Android 13

Impacted devices (Android devices or readers)

Chinese Tablet (10inch)

SDK version

4.1.0

[surfing-chriso]

@patrick-stripe @fred-stripe I am experiencing the same issue. Tablet manufacturer is Hosoton. Tablet is 14" H104. Tried SDK versions 4.1.0, 3.8.0 with some custom ux. Application presented in portrait mode but the application rotates to landscape upon activation of the tap to pay screen. SDK version 3.2.1 works fine with no rotation but I require the custom ux modifications enabled in 3.8.0+.

Your help would be appreciated.

Thank you

[chr-stripe]

Hi all, this can happen if the device manufacturer updates the display configuration for the device between OS updates. At this time, Tap to Pay on Android is meant to display in portrait on phones, and in landscape on tablets, so auto-rotating between those states dynamically is not supported at this time. We are exploring the possibility of configuring the device's orientation through the Terminal.setTapToPayUxConfiguration() in the future, but have no concrete timeline on when this would be available yet.

We're aware of this happening before on some tablets after an OS update, and at least one device manufacturer has recommended making use of adb to manually configure the density on a per-device basis. For example:

$ adb shell wm density 320    # set density to 320
$ adb shell wm density reset  # reset device density to default manufacturer value

[surfing-chriso]

@chr-stripe Thanks for your reply.

We are exploring the possibility of configuring the device's orientation through the Terminal.setTapToPayUxConfiguration() in the future, but have no concrete timeline on when this would be available yet.

This would be very welcomed! I add for your consideration many other payment kiosks are presented in portrait mode (think food outlets) therefore I believe there is a strong use case for supporting tablets (or other large touchscreen android-based devices) in portrait mode.