This repository contains a sample app that demonstrates best practices for writing an Apps on Devices integration.
The app demonstrates the following
- How to discover and connect the handoff reader
- How to collect and confirm a payment
- How to deep link to the device's admin settings
Before proceeding with the integration, ensure you have the following
- Stripe S700 DevKit smart reader
- Android Studio Flamingo or greater
Clone this repo and open it in Android Studio.
The Apps on Devices example app depends on the Example Terminal Backend.
We recommend deploying the backend to Render.com.
- Set up a free Render account if you haven't created one previously.
- Click the button below to deploy the backend. You'll be prompted to enter a name for the Render service group as well as your Stripe API test mode secret key.
- Go to the next steps in this README for how to use this app
Edit local.properties and add an entry for BACKEND_URL. For example if your instance is available at https://my-backend-123.onrender.com, you'll add the following.
BACKEND_URL=https://my-backend-123.onrender.com
Run the example app on a Stripe WisePOS E or S700 DevKit device.
- Deploy the sample app to learn how to upload and deploy your app
- Read troubleshooting apps on devices for resolutions to common issues
If you found a bug or want to suggest a new [feature/use case/sample], please file an issue.
If you have questions, comments, or need help with code, we're here to help:
- on Discord
- on Twitter at @StripeDev
- on Stack Overflow at the stripe-payments tag
- by email
Sign up to stay updated with developer news.
