Adyen Card Reader Setup β Android
The Zenoti Mobile App supports an Adyen card reader configuration screen on Android devices. This article explains how to download the required Adyen libraries and configure your card reader so you can process payments through the Adyen integration on an Android device.
Audience: Employees who set up or manage payment hardware on Android devices running the Zenoti Mobile App.
Note: For conceptual background on the Zenoti Mobile App and supported payment methods, see Zenoti Mobile App Overview.
Before you begin
- Your organization must have Adyen configured as its payment processor. For POS configuration, see the relevant POS configuration article.
- Your Android device must have an active internet connection to download the Adyen native libraries.
- You must have the necessary permissions in the Zenoti Mobile App to access device settings.
Steps
Open the Adyen card reader configuration screen
- On your Android device, open the Zenoti Mobile App.
- Navigate to Device Settings.
- Tap Tap to Pay in the Settings menu to open the Adyen card reader configuration screen.
The Adyen card reader configuration screen opens. It contains the following areas:
- A toolbar at the top of the screen
- A download row showing the status of the required Adyen libraries
- A reader name field
- A reader detail field (hidden until reader information is available)
- A reader action control
Download the Adyen libraries
Before you can use the card reader, the Zenoti Mobile App must download the required Adyen native libraries onto your device. These libraries are not bundled with the app and must be downloaded on demand.
- On the Adyen card reader configuration screen, locate the download row near the top of the screen.
- Check the download row status:
- If the libraries are already present, the download row indicates they are ready and you can proceed to the next section.
- If the libraries are not yet downloaded, the download row displays a progress indicator and a download action.
- Tap the download action shown in the download row to begin downloading the libraries.
- Wait for the download to complete. A progress indicator displays while the download is in progress.
Important: All Adyen card reader controls on this screen remain unavailable until the libraries have been successfully downloaded. Do not attempt to configure or use the card reader until the download row confirms the libraries are present.
Tip: Ensure your Android device has a stable internet connection before starting the download. If the download fails, check your connection and tap the download action again.
Configure the card reader
Once the Adyen libraries are downloaded and confirmed as present, the card reader controls become available.
- In the reader name field, enter or confirm the name for your card reader.
- Review the reader detail field. This field is hidden by default and only becomes visible when relevant reader information is available β for example, after the card reader is detected or linked to the device.
- Use the reader action control to complete the card reader setup, such as linking or registering the card reader with your device.
Worked example: A center named "Riverside Spa" sets up a new Android tablet at its front desk. The employee opens Device Settings, taps Tap to Pay in the Settings menu, and sees the download row showing a progress indicator. After tapping the download action and waiting for the download to complete, the reader controls become active. The employee enters "Riverside-1" in the reader name field. Once the card reader is detected, the reader detail field becomes visible and displays the connected reader's identifying information. The employee uses the reader action control to confirm the configuration.
Tips
- Always verify the download row confirms the Adyen libraries are present before handing the device to front desk employees for payment processing. Card reader functionality is fully blocked until the download succeeds.
- If the reader detail field does not appear after completing the download, confirm that the physical card reader is powered on and within range of the Android device.
- Assign clear, center-specific names in the reader name field (for example, "FrontDesk-Android-1") so employees can identify the correct reader during payment processing.
Troubleshooting
The download row shows a progress indicator but the download does not complete.
Check that the Android device has an active internet connection. Move to an area with better connectivity if needed, then tap the download action again to retry.
Card reader controls remain unavailable after the download completes.
Close and reopen the Adyen card reader configuration screen. If controls are still unavailable, confirm the download row shows the libraries as present and not partially downloaded. Retry the download if needed.
The reader detail field does not appear after a successful library download.
The reader detail field is hidden until relevant reader information is available. Confirm the card reader is powered on, in range, and properly linked to the device. If the field still does not appear, use the reader action control to initiate or retry the pairing process.