Deploy your app
Learn how to deploy your Android app to your devices.
After Stripe reviews and approves your app for deployment, we notify you by email, in the Dashboard, or through a webhook. You can then follow the instructions below to deploy your app.
During deployment, your app is immediately sent and downloaded to your device. The device reboots to install the app. Devices reboot every 24 hours and apply any updates automatically. To check for and apply updates immediately, you can manually reboot your device.
Add or edit a deploy group![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Before you can add or edit a deployment group, you must create a Terminal location and add readers to that location.
After you create a deploy group, you can edit it at any time by clicking edit next to the location.
- In the Dashboard, click Developers > Apps.
- On the Terminal apps tab, click Manage deploy groups.
- Click Add deploy group.
- Complete the following steps in the Deploy group window:
- Enter a group name.
- Choose your Terminal device type.
- Choose the location(s) to add.
- Click Done.
Deploy an app version![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can deploy your app after a Stripe reviewer approves it.
- On the Terminal apps tab, choose the app that you want to deploy.
- On the app details page, click Deploy version.
- Choose a version of the approved app, then click Next. You can’t deploy an earlier version of an app. The app version must be newer than the currently deployed app.
- Choose the deploy group, then click Next.
- Choose your preferred kiosk app, then click Next. This is the default app that launches when the Stripe reader turns on. If there’s only one app to deploy, choose that app instead.
- Confirm the deployment details, then click Deploy. The app deploys immediately.
Deploy group best practices![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
You can sort devices into different deploy groups to roll out software independently and isolate fault in case of any issues. You might have fewer or more deploy groups based on tooling, risk tolerance, and specific business needs.
We recommend the following deploy group setup:
- Alpha - Contains locations that correspond to your internal devkits or internal production devices.
- Beta - Contains a small number of actual user locations. You can randomly choose these locations, select them based on meaningful criteria (for example, less risky locations), or have users opt in to the Beta deploy group based on their risk tolerance.
- General - Contains all remaining actual user locations, except those in the Alpha or Beta groups.
When your app is ready for deployment, promote deploy groups from least to most risky:
1 | Alpha | First, deploy to the Alpha deploy group to test your app in a way that minimises risk to users. Discovering a bug or undesirable behaviour at this stage only affects a small number of internal devices, rather than actual users and real payments. |
2 | Beta | Second, deploy to the Beta deploy group. This balances exposing your app to real users and not exposing all users to potential issues. |
3 | General | Finally, deploy to the General deploy group after addressing any issues or confirming that no issues existed for the Beta deploy group. |