Skip to content

stripe-samples/terminal-apps-on-devices

Repository files navigation

Apps on Devices integration

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

Prerequisites

Before proceeding with the integration, ensure you have the following

Setup

Clone the repo

Clone this repo and open it in Android Studio.

Deploy the Example Terminal Backend

The Apps on Devices example app depends on the Example Terminal Backend.

We recommend deploying the backend to Render.com.

  1. Set up a free Render account if you haven't created one previously.
  2. 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.
  3. Go to the next steps in this README for how to use this app

Deploy to Render

Point the example app to your backend

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

Run the example app on a Stripe S700 DevKit smart reader.

Screenshot 2024-07-23 at 9 38 59 AM

Next steps

Get support

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:

Sign up to stay updated with developer news.

Author(s)

About

No description, website, or topics provided.

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages