Learn how to resolve known issues with apps on devices.
Your app won’t upload to Stripe If your APK is too big or your upload internet speeds are too slow, you might receive a timeout error when you upload your APK with the Files API. Stripe enforces a 45 second timeout on its servers, and produces an error if an app isn’t uploaded within that time. To resolve this issue, upload your APK to a server with better internet (for example, an AWS EC2 instance or another VPS), and then upload to Stripe from there. The network connection between your server and Stripe servers is generally much faster than home or office connections to Stripe through an ISP.
Sandbox-approved app resubmission for live mode If you obtained approval for your app in a sandbox and want to use the app in live mode, you must submit it again for approval. The app review process is the same for both sandbox and live mode. Make sure to upload the exact same APK for automatic approval.
Access to the device admin settings screen from your app By default, the device user can access admin settings by swiping from the left edge of the screen and tapping Settings. This method doesn’t work when a third-party app is the default launch app. You can use the stripe://settings/ URI to deep-link into admin settings and then launch the URI from your app using the following code in your Activity or Fragment: MyActivity.kt Select a language Kotlin Java No results startActivity( Intent(Intent.the related setting).setData(Uri.parse("stripe://settings/")))
Updates to the device language in your DevKit The reader app on the DevKit can’t currently update the device language. You can change the device language through the Android Settings app. Use adb to launch the Android Settings app: $ adb shell am start -a android.settings.the related setting
Android Settings on Stripe devices For security and reliability reasons, Stripe blocks the Android Settings app on production Stripe devices. Because of this, you can’t launch or deep link into Android settings on Stripe devices.
Run multiple apps on the Stripe Reader the related setting/the related setting The Stripe Reader the related setting/the related setting supports running multiple apps, but we don’t provide an app launcher. You must build the functionality within your apps to allow switching between apps. When you deploy your apps, you can specify the default_kiosk_application, which is the app that launches when the device checks for updates and after payments. You can’t use the Dashboard to configure multiple apps on a device.
Deploy a web app on your Stripe devices You can package your web app to run on your Stripe devices. Use a framework, such as Cordova, to modify your web app for compatibility with Android and generate an Android application package (APK). You can then upload the APK in your Stripe Dashboard. Frameworks aren’t aware of Stripe or the Android Terminal SDK, so you must create a JavaScript bridge between your web app and the SDK to send commands from JavaScript. Alternatively, you can use the server-driven integration to collect payments, which doesn’t require using the Terminal handoff client library or a JavaScript bridge. This allows Stripe to handle all payment collection commands and communication with the device.
Constant restarts on your app The Stripe Terminal card readers restart the default app in the event of a crash. This manifests differently for production and DevKit devices:
Production – If you configure your app as the default app on production devices, the app automatically restarts when there’s a crash. If the app crashes during initialization (for example, a missing or broken database migration), the device can enter a crash loop.
DevKit – If you configure the Stripe payment app as the default app on DevKit devices, your app queues on the device and then becomes the primary app. If the app crashes, the Stripe payment app restarts instead.
App crashes when processing payments with a large number of line items If your app crashes while attempting to process a payment with a large number of line items, the issue might be memory. The Android OS limits data sent per inter-process (IPC) to 500 KB, when saving state for your activity. To help prevent your app from crashing, you can store your data out of memory, such as in a database.
Bugs in deployed apps If you discover a bug in an app that’s already deployed, you can fix the issue in the app, upload a new version, and then deploy your app.
View the logs for your app on production readers Stripe doesn’t expose logs on production readers. We rely on Sentry integrations for observability.
A sideloaded point-of-sale app in a DevKit won’t start after a completed payment transaction On Stripe readers configured for Apps on Devices, the preferred kiosk app starts after a transaction completes. On a DevKit, the device’s preferred kiosk app is only set when you include the device in a deploy group. To set the preferred kiosk app on a DevKit device:
Upload your app selecting only DevKit device types. This allows you to skip [app review](/the relevant part of the product) .
[Deploy the app version](/the relevant part of the product) to a deploy group that targets your DevKit.
