Tap to Pay with Lightspeed Payments
iPhone Setup & Troubleshooting Guide
Prerequisites
- iPhone XS or above
- Lightspeed Payments account
- iOS 17 or above
- Version 24.2 or higher of Lightspeed Restaurant for iOS
- 4-digit (or longer) passcode for the iPhone
SETUP: ACTIVATING & CONFIGURING TAP TO PAY
1. Log in to the Back Office with your Lightspeed Restaurant account credentials
2. From the navigation menu, under Configuration > Settings select Payment methods
3. In the Lightspeed Payments banner, click Manage
4 Under Payment Methods, scroll down to Tap to Pay for iPhone and click Activate
1. Log in to the Back Office with your Lightspeed Restaurant account credentials
2. Under Configuration > select Configurations
3. Click the Configuration name you wish to edit
4. Select the Payments tab
5. Scroll down to Tips to explore your POS tipping settings
- With Tap to Pay on iPhone, you can configure tipping to allow for more dynamic options that fit your business needs.
- Options can be set for custom amounts or predefined tipping options.
1. During the first connection with the POS or after your first transaction is processed on the POS, you’ll be prompted to fill out some basic information on the iPhone
2. Accept Terms & Conditions of Apple Tap to Pay (required) to process transactions
1. From your POS Order screen, select all items and discounts to be added to the sale
2. Tap Pay
3. Choose Lightspeed Payments Tap to Pay as the payment type
4. If tips are enabled, the display will prompt the customer to select a tip
5. Tap Pay to prompt the customer to tap their card or contactless payment method to complete the payment
6. Once the payment is successfully processed, the iPhone will show the approved payment on the display
- On the first Tap to Pay transaction processed through Lightspeed Payments, you’ll be prompted to link Tap to Pay on the iPhone with your Apple ID.
1. Log on to Restaurant POS with your Lightspeed username and password
2. Navigate to Receipts in the navigation menu
3. From the Receipts screen, locate the receipt you wish to edit
4. When you have selected the desired receipt to edit, tap Receipt actions
5. Use Full refund or Partial refund to refund the customer
- The refund process is the same as for other payments and can be done via the Receipts tab
- As with Lightspeed Payments, refunds do not require the card to be presented.
TROUBLESHOOTING: BASIC TIPS & RESPONSIVE SOLUTIONS
Other general troubleshooting tips
Ensure the Apple Wallet app is installed on the device- Disable Airdrop and Sharing features
- Disable the Add a header option in the Back Office
Confirm that the device is set to the correct time zoneRun a test after closing the K-Series app on both the main iPad and the iPhoneLastly, resync the configuration across all devices, then close the K-Series app on every iPad and restart it, beginning with the main device
1. Go to Configuration > Payment Methods and check if Tap to Pay is listed as a payment method.
2. In the same section, ensure the Tap to Pay payment method is enabled.
3. Ensure the devices are up to date and confirm that the correct configuration is applied to the iPhones.
4. Check the logs of the main device for errors related to the Tap to Pay plugin configuration.
5. Go to Configuration > Payment Methods > Advanced Options and ensure the Tap to Pay option is not selected (unchecked) in the payment method settings.
6. Use With Caution: Modify and Revert the MID
— Note the current MID (Merchant ID).
— Temporarily change the last character to a different one (remember the original).
— Click Save and check if it saves the payment method correctly.
— Revert to the original MID, then Save again.
— Confirm that the changes are saved correctly.
7. Have the customer re-sync the configuration from the Back Office and from the device itself. This ensures proper synchronization across all devices.
8. Ask the customer to fully close and restart the Lightspeed POS K-Series app on both the main (active) device and the iPhones (passive devices).
9. Review the logs on the main device once more. The system should now attempt to rebuild the Tap to Pay plugin. If it still fails, ask the customer to repeat this step.
10. Try initiating a Tap to Pay transaction: The iPhone should prompt for the Apple Terms and Conditions. The user must accept the Terms to proceed with the payment.
- Note: Tap to Pay is only supported on iPhones, not iPads.
ℹ️ If the steps above didn’t resolve the issue, please contact our PartnerOps Team and request that they run the LSP visibility script.
If the Apple ID didn’t prompt when initial sale is complete:
1. Check if Apple Wallet app is installed
2. On the iPhone, have the customer open Sign in to your Apple Account, and accept the T&Cs
3. Retry Tap to Pay
4. Ensure the K-series app is downloaded with the same Apple ID as Tap to Pay
5. If it’s still not working, remove and re-add the LSPAY payment method
- Keep in mind that removing and adding LSPAY is extremely disruptive and needs to be done outside of business hours
1. Add a passcode for the iPhone
2. Try processing the payment again
1. Try changing the current Tap to Pay (TTP) payment method into a normal credit card payment method
2. Recreate the TTP payment method (if the LS Payment method isn’t showing at checkout)
3. Reload the device