Overview
This article provides guidance on how to troubleshoot and resolve common issues with Tap-to-Pay on Mobile. Tap-to-Pay on Mobile allows quick, secure card-present transactions, saving time and lowering credit card fees compared to manual keyed-in transactions. For more on Tap-to-Pay, see Use Tap-to-Pay in ServiceTitan Mobile.
If you continue to experience issues after completing the troubleshooting steps, please contact our Fintech Support team at fintechsupport@servicetitan.com for further assistance.
Who uses this feature
Technicians
Applies to all business types
Applies to all trades
Feature configuration
Account configuration is required to use this feature. Please contact Technical Support for details.
Requirements to use Tap-to-Pay
Before using Tap-to-Pay to accept NFC cards or Apple/Google wallets, please make sure your setup meets all requirements below.
Device requirements
Tap-to-Pay is currently supported only on:
iPhone XS, XS MAX, XR or newer, running iOS 16.4 or later.
Any NFC enabled Android device, running Android 15 or later.
The device must have a passcode or Face ID/Touch ID enabled. Tap-to-Pay will not work without a screen lock.
App requirements
You must be running the latest version of the ServiceTitan Mobile app.
Technicians must be logged in to the app before attempting to start a Tap-to-Pay session.
Ensure your device has Bluetooth and network connectivity (Wi-Fi or cellular data).
Ensure sharing location is Always on or Only when using.
Technicians must be dispatched and arrived to the job.
Account and feature requirements
Your company must be onboarded to PayEngine or Adyen.
Tap-to-Pay requires that Online Payments be active and configured.
Go to Settings > Invoicing > Online Payments, accept the agreement, and make sure a valid payment type is selected.
Tap-to-Pay button is missing
If you can see the card reader button but not the Tap-to-Pay option:
Log out and log back in on the technician's device.
Tap Download Pricebook from the app settings.
Ensure the appropriate Business Units are assigned to the enabled processor.
If the issue continues, please contact Fintech support at fintechsupport@servicetitan.com. It may indicate an incomplete onboarding process that requires assistance.
Error when connecting to Tap-to-Pay for the first time
If you see a 400 Error or Unexpected failure when first connecting to Tap-to-Pay:
If you're on an iPhone, make sure it has a lock screen passcode set. This is required by Apple.
Retry the connection.
Technician login or QR code issues
This section goes over issues with technician login or QR codes.
QR code doesn't log in the technician
The QR code will not automatically log a technician into the mobile app for security reasons.
Ensure the technician is already logged in before scanning the QR code.
Once logged in, future QR scans will correctly transfer them to the payment screen.
Technician gets logged out on tablet after scanning QR code
If scanning the QR code logs the technician out of their tablet:
Contact your admin to check the Disable Technician Access on Multiple Devices setting.
This setting should be turned off if your team uses Tap-to-Pay across multiple devices.
If the change doesn't take effect immediately, try another transfer. It should work after that.