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

# Take payments with Tap to Pay

> Set up Tap to Pay on a facility iPhone, take a card payment on the phone or from the desk, and put a payment on a customer's balance or invoices.

Tap to Pay turns a facility iPhone into a card terminal: the customer taps a contactless card, Apple Pay, or another wallet on the top of the phone. No reader or extra hardware is needed. You can also send charges to a Stripe smart reader. Payments go to your facility's Stripe account like every other payment.

## Before you start

* Stripe is connected and card payments are active. See [Connect payment processing](https://www.carstoragesoftware.com/docs/settings/connect-payment-processing.md).
* Tap to Pay is switched on for your facility. This happens automatically the first time your Stripe account becomes active, and it needs a facility address (Terminal requires a business address). If the **Tap to Pay** buttons described below are missing on a customer, ask support to enable it.
* A facility iPhone XS or later with a recent iOS, and the **Car Storage Software Utilities** app. Install it from [Settings > Download apps](https://www.carstoragesoftware.com/dashboard/settings/apps). See [Use the staff apps](https://www.carstoragesoftware.com/docs/apps-and-portals/use-the-staff-app.md).
* The person doing the one-time setup on the phone is a facility admin. Payments from the desk need the **payments** permission.

## Set up the iPhone (once per phone)

**1. Sign in to the Utilities app as a facility admin**

Until Tap to Pay is set up, the app's home screen is the setup screen.

**2. Tap Set up Tap to Pay on iPhone**

Review and accept Apple's Tap to Pay on iPhone Terms and Conditions. Only an admin is shown the terms. Other staff see "Ask a facility admin to set up Tap to Pay on iPhone".

**3. Read How to accept contactless payments**

Apple's short tutorial on how customers should hold their card or phone. You can reopen it any time from **How to tap** on the charge screen or from the **Account** screen.

After this the app remembers the phone, reconnects quietly whenever you open it, and the home screen goes back to **Take a payment** and **Save a card on file**. A line under the buttons shows the reader state, for example "Tap to Pay on iPhone is ready." Tap **Reconnect** if it says it could not connect.

Once signed in, the app also shows **Ready for charges from your desk**, which means this phone appears as a destination in the desk's **Send to** list. If it shows **Turn on notifications** instead, tap it and allow notifications, or the desk can still send a charge but you must open the app yourself to receive it.

## Take a payment on the phone

**1. Tap Take a payment**

Under **Who's paying?** search for the customer, or skip if it is a walk-up payment with no customer.

**2. Pick an invoice (optional)**

If the customer has open invoices, pick one to fill in its remaining amount, or choose another amount.

**3. Enter the amount**

Fill in **Amount**, and optionally **What's this for?** and **Receipt email**, then tap **Continue**.

**4. Tap Charge and hold the card to the phone**

The button reads **Charge** with the amount. Hold the customer's card near the top of the phone until you see confirmation. The screen shows **Approved** when it goes through.

**5. Offer a receipt**

A receipt is emailed automatically when a receipt email was set. Otherwise enter one and tap **Email receipt**. If a charge is declined, the customer was not charged, and you can send **Email payment record**.

**Take another payment** starts over at **Who's paying?**.

## Save a card on file on the phone

From the home screen tap **Save a card on file**, search for the customer, and pick them. The phone prepares the card setup and the customer taps their card straight away. The card then appears under the customer's payment methods.

## Send a charge from the desk

Use this when the customer is standing at the desk and the phone or reader is in someone's hand.

**1. Open the customer**

On a contact's **Billing Setup** card, under **Payment methods on file**, click **Charge** to take a payment. To save a card instead, open **Add payment method** and choose **Tap to Pay**. Both open the same **Tap to Pay** dialog.

**2. Enter the amount**

On the **Charge** tab fill in **Amount** and, optionally, **For**. The **Save card** tab has no amount.

**3. Choose where to send it under Send to**

The list shows each staff iPhone signed in to the Utilities app (yours is marked "(you)") and each card reader. **QR code** appears when no phone is signed in yet. If only one destination exists it is picked for you.

**4. Click Send**

The button reads **Send** with the amount and device name. The dialog then shows **Sent to phone**, **Opened on phone**, or **Sending to reader**, and **Waiting for tap** once the customer can tap. It ends with **Paid** and the amount.

![Tap to Pay dialog with an amount of 42.00, a For note, and Send to options for a card reader and a QR code](https://mintcdn.com/carstoragesoftware/QS5Fef4kWSxWDLds/images/apps-and-portals/tap-to-pay-charge-dialog.webp?fit=max\&auto=format\&n=QS5Fef4kWSxWDLds\&q=85\&s=fc88fe009af47741ea22c87f6016b5aa)

![Tap to Pay dialog showing Waiting for tap with the reader name and amount, and a Cancel button](https://mintcdn.com/carstoragesoftware/QS5Fef4kWSxWDLds/images/apps-and-portals/tap-to-pay-waiting-for-tap.webp?fit=max\&auto=format\&n=QS5Fef4kWSxWDLds\&q=85\&s=0e345ce6dbcc4d37a2265b68525b84d5)

On the phone, the charge arrives as a notification titled "Charge" with the amount. Tapping it opens the Utilities app straight into the tap with the amount filled in. If the app is already open it starts without a tap on the notification. Staff do not need to type anything.

* **Cancel** stops the request. **Send again** appears after a cancel.
* If it fails, the dialog says **Didn't go through** with the reason and offers **Try again**.
* Sending a new charge to a phone replaces whatever it was still waiting on.
* On a computer, the **QR code** option shows a code plus a 15-minute link. Scanning it with the facility iPhone opens the Utilities app on that customer.

Paying one invoice works the same way. Open the draft or open invoice, choose **Tap to Pay** in **Actions** (it shows "Take a card payment on a phone or reader"), and the dialog opens with the amount fixed to what is left on the invoice, less processing fees. See [Collect a payment](https://www.carstoragesoftware.com/docs/payments/collect-a-payment.md).

### New customer registration

If your team fills in the public registration form with a customer standing there, the confirmation screen says "Save their card with Tap to Pay on iPhone to finish" and shows the same send-to-device panel.

## Add a smart reader

Under **Payment devices** on [Settings > Download apps](https://www.carstoragesoftware.com/dashboard/settings/apps), click **Add reader**, type the **Code** shown on the reader's screen (for example `quick-brown-fox`), set a **Name** (default "Front desk"), and click **Add**. The reader then appears in **Send to** as a **Card reader**. The same list shows each connected phone, and the trash button removes a device.

## Put a payment on a customer's balance and invoices

A payment taken with no customer, or one that has not yet been credited, shows in a **Tap to Pay payments** list with the date, card brand and last four digits, the note, and "No customer" if none was attached. The list is on the [Payments overview](https://www.carstoragesoftware.com/dashboard/payments) (payments with no customer only) and in the **Account Balance** card on each customer (that customer's own, plus ones with no customer).

![Tap to Pay payments list on a customer record with two payments and Add to balance buttons above the Account balance card](https://mintcdn.com/carstoragesoftware/QS5Fef4kWSxWDLds/images/apps-and-portals/tap-to-pay-unapplied-payments.webp?fit=max\&auto=format\&n=QS5Fef4kWSxWDLds\&q=85\&s=57e79e6bbd824aabbc4b3ecfd910cf3e)

**1. Click the button on the row**

On Payments overview a payment with no customer says **Apply to customer**. On a customer record, or for a payment already tied to a customer, it says **Add to balance**.

**2. Choose the customer (overview only)**

In the **Apply to customer** dialog pick the customer and click **Add to balance**.

**3. Pay invoices from it**

The amount is added to the customer's balance, a message confirms it, and **Pay from balance** opens so you can pick invoices to pay with it right away. Close it to leave the credit on the balance, where it applies to future invoices.

The amount credited is what the card actually paid. Stripe's processing fee stays your cost. A payment that was refunded, was disputed, did not complete, or is already on a balance cannot be added. If the payment came from an invoice's **Tap to Pay**, that invoice is selected for you in **Pay from balance**.

![Tap to Pay payments panel on Payments overview with one 45.00 payment and an Apply to customer button](https://mintcdn.com/carstoragesoftware/QS5Fef4kWSxWDLds/images/apps-and-portals/tap-to-pay-overview-panel.webp?fit=max\&auto=format\&n=QS5Fef4kWSxWDLds\&q=85\&s=922af8b5e1504ffb8d06de891c63fe55)

## Troubleshooting

| You see | What to do |
| - | - |
| "No phone or reader yet. Sign in to the Utilities app on the facility iPhone." | Sign in to the app on a phone, or add a reader. The dialog rechecks every few seconds. |
| "Open the Utilities app on \[phone] to receive it." | That phone has notifications off. Open the app and the charge appears. |
| "That device is no longer connected. Pick another one." | The phone signed out or the reader was removed. Choose a different destination. |
| "Tap to Pay is not set up on this iPhone. Ask a facility admin to set it up." | An admin must do the one-time setup on that phone. |
| "Tap to Pay on iPhone needs a newer version of iOS." | Update the iPhone in **Settings > General > Software Update**. |
| "This iPhone does not support Tap to Pay." | Use an iPhone XS or later, or another payment method. |
| "This card requires chip insertion, which Tap to Pay cannot support." or "...requires PIN verification that cannot be completed with Tap to Pay." | Ask for another card. |
| "PIN entry is blocked because the device is in an insecure state." | Turn off Developer options, screen recording, and accessibility overlays, then retry. |
| "The reader is offline. Check it is on and connected to the internet." / "The reader is busy with another payment." | Fix the reader and send again. |
| "Add a facility address in Settings before using Tap to Pay." | Add your address in [Settings](https://www.carstoragesoftware.com/dashboard/settings), then try again. |
| "Connect Stripe before taking in-person payments." | Finish [payment processing setup](https://www.carstoragesoftware.com/docs/settings/connect-payment-processing.md). |
| "Tap to Pay could not connect to the reader. Confirm Terminal is enabled for this facility." | Ask support to enable Tap to Pay for your facility. |
| "Reader disconnected. Reconnecting..." | Wait a moment. If it ends with "Reader disconnected. Try again.", tap **Try again**. |

## Related

* [Use the staff apps](https://www.carstoragesoftware.com/docs/apps-and-portals/use-the-staff-app.md)
* [Collect a payment](https://www.carstoragesoftware.com/docs/payments/collect-a-payment.md)
* [Manage billing on a customer record](https://www.carstoragesoftware.com/docs/contacts/manage-billing-on-a-customer-record.md)
* [Billing concepts](https://www.carstoragesoftware.com/docs/concepts/billing.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.