The Smart Tap sample app is a simple Android application that invokes the
get smart tap data
flow with the Smart Tap 2.1 protocol. The app reads the
smartTapRedemptionValue property of a Google Wallet pass object stored on an
Android-powered device. This includes the cryptographic operations needed to
authenticate the terminal and decrypt the payload.
For more information on the different data flows, see Data flow.
You will need two different Android-powered devices to test the sample app. The devices are listed below for reference.
- Terminal device: On this device, you will install the sample app
- User device: On this device, you will add a sample pass to the Google
Wallet app
- Make sure the device supports NFC (see this support article for additional troubleshooting tips)
You will also need the latest version of Android Studio on your local workstation.
This application contains the needed configuration to retrieve the demo pass added to the user device:
- Private key
- Key version
- Collector ID
On the user device, open the following link to add the demo loyalty pass to the Google Wallet app:
Demo pass Add to Google Wallet link
- Clone this repository
- Open Android Studio and import the repository folder
- Connect your terminal device for debugging (for instructions on how to do so, see the Android Studio documentation)
- Run the sample app in debugging mode on the terminal device
- Gently tap the user device to the terminal device
- The tap location may depend on the location of the NFC antenna on each device, so you may need to try tapping in several different locations
Once the devices connect via NFC, the terminal device will display the flow of
Smart Tap commands and responses, as well as the decrypted payload (2018).
This is the value stored in the pass object's smartTapRedemptionValue
property. The user device will show that the pass was successfully transmitted
to the terminal device.
Note: If you would like to inspect the flow further, set several breakpoints at different locations in the sample terminal app and restart debugging.
Feel free to submit an issue to this repository with any questions.