---
title: "Troubleshoot Tap-to-Pay in ServiceTitan Mobile"
slug: "troubleshoot-tap-to-pay-in-servicetitan-mobile"
updated: 2026-10-15T01:29:57Z
published: 2026-10-15T01:29:57Z
canonical: "help.servicetitan.com/troubleshoot-tap-to-pay-in-servicetitan-mobile"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot Tap-to-Pay in ServiceTitan Mobile

## 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](/v1/docs/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](mailto:fintechsupport@servicetitan.com) for further assistance.

[KB - Troubleshoot Tap-to-Pay on Mobile Video](https://fast.wistia.net/embed/iframe/cpd4mwqdhy?web_component=true&seo=true&videoFoam=false)

---

### 

#### 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](http://go.servicetitan.com/ask) 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](/construction/docs/servicetitan-mobile-faq#mobile-settings).
- 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:

1. Log out and log back in on the technician's device.
2. Tap **Download Pricebook** from the app settings.
3. Ensure the appropriate [Business Units are assigned to the enabled processor](/construction/docs/best-practices-for-managing-business-units#add-the-business-unit-to-payment-processors).

If the issue continues, please contact Fintech support at [fintechsupport@servicetitan.com](mailto: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:

1. If you're on an iPhone, make sure it has a lock screen passcode set. This is required by Apple.
2. 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:

1. Contact your admin to check the *Disable Technician Access on Multiple Devices* setting.
2. This setting should be turned off if your team uses Tap-to-Pay across multiple devices.
3. If the change doesn't take effect immediately, try another transfer. It should work after that.

## Want to learn more?

- See [Payments](/construction/docs/payments-home)
- See [Use Tap-to-Pay in ServiceTitan Mobile](/v1/docs/use-tap-to-pay-in-servicetitan-mobile)