Setting up and scanning QR codes
Last updated: October 10, 2024
Tickets and confirmation emails can be generated with a type of barcode called a QR code, which stores information about that specific customer. These codes can then be scanned to check in your customers. You can enable QR codes for each individual item in your Dashboard that you want to allow scanning for.
Before you enable QR code ticket-scanning check-in, make sure you have the following:
An iOS device (iPhone, iPad, or iPod touch) running iOS 10 or newer OR an Android device running OS 8.0 or newer
The FareHarbor app, which you can download for free from the App store or the Google Play store
Enabling QR code ticket-scanning check-in
- Navigate to the item you would like to enable QR code ticket-scanning check-in for.
- Go to the item’s Info & Policies, then select the Advanced tab.
- Check the box for “Enable ticket-scanning check-in”.
- Select Save.
(Optional) Custom ticket instructions: Though this is not often needed, you can add custom ticket instructions if you would like. When no custom instructions are entered, the ticket will display the default message:

Note: If you decide to add custom ticket instructions, remember that this text will need to be translated for all available languages in your Dashboard.
Once QR scanning is enabled for an item, all confirmation emails sent to the customer for that item will include a link that they can click to view, print or add their tickets to their digital wallet.

Google Wallet and Apple Wallet
Note: Adding tickets to an Apple Wallet is not supported on the iPad. It is only available for the iPhone and iPod Touch.
The following images show the tickets as they appear in the customer’s Google Wallet (left) or Apple Wallet (right) on a smartphone:

Note: If a customer received their confirmation email before you enabled QR scanning, they will not see the tickets with QR codes in their email. If you’d like to re-send the confirmation with QR codes, you can do so by navigating to the booking overview, then clicking the Send email or text button under Booking actions.
QR codes and Boca tickets
If you have Boca tickets enabled, you can print theater-style tickets by opening the customer’s booking, clicking the Print button, and selecting the Boca Format option. For more information on printing tickets with a Boca printer, see this page.
Defining ticket colors per customer type
In certain situations, it is helpful to visually distinguish tickets by customer type. This is useful in circumstances in which your staff must be able to quickly identify different tickets at a glance.
By default, tickets display a white background. In your customer type settings, you may choose from a selection of seven colors to define a ticket color associated with the customer type. You may assign the same color to multiple customer types.
To define a ticket color for a customer type:
- Navigate to Settings > Customer Types.
- Select Edit under your target customer type.
- In your customer type settings, select a Ticket color from the defined color options.
- Click Save.

Note: For colors to take effect, tickets must first be enabled in your item’s settings. Refer to the Enabling QR code ticket-scanning check-in section of this page for more information.
Once a ticket color has been defined for a customer type, the background of the ticket will display the selected color, as shown in the following examples:

Scanning QR codes
Once you have enabled QR code ticket-scanning check-in, you can use your smartphone or tablet to quickly and easily check in your customers. Learn how to scan QR codes with the FareHarbor iOS app, with the FareHarbor Android app, or from the manifest.
Still having trouble? See the Troubleshooting QR codes section below.
Troubleshooting QR Codes
Why aren’t my codes scanning?
QR codes can be scanned in a variety of formats, whether they appear on a ticket, plain paper, or a customer’s phone. However, sometimes you might run into issues scanning codes.
Here are some things you can try if you’re having trouble:
- Try scanning in better lighting, or turn on the light if your device has one.
- Make sure the code isn’t partially covered, smeared, faded, or damaged.
- Make sure you are not trying to scan at an odd angle.
- Try a variety of distances from the code for scanning (it doesn’t necessarily need to fill the green guide frame – it can sometimes read better when appearing smaller on the screen).
If the above options don’t resolve the issue, get in touch with FareHarbor Support for assistance.
The wrong checked-in status is being selected when I scan a code
When scanning a code, the scanner picks the first checked-in status available. If you use more than one status to mark guests as checked in (such as checked in and checked in late), you can adjust the order of these options by going to Settings > Check-in Options.
The status at the top of the list will be the default checked-in status. Change the order by clicking and dragging the reorder
icon next to the status name. Once you reorder the list, a green notification will appear at the bottom of the page saying Order saved.
When I try to scan a code, I see a message that says “Did not automatically check in.”
You will see this notification when you are attempting to scan a code for an availability whose start date is more than one hour in the future. In these cases, you will need to tap on the button that says “Check in 1 Adult” or “Check in all X people” to complete the check-in.
Why don’t I see the generated QR code in my Dashboard?
You cannot see the QR code that was generated for a booking while logged into your user account in FareHarbor.
To see the QR code(s):
- Copy the URL from the email preview pop-up window to your clipboard.
- Log in to your Dashboard using your browser’s incognito mode.
- Paste the URL from step 1 into the browser’s address bar.
You should now be able to view the QR code.
Why don’t my customers have the ability to add their tickets to Google Wallet or Apple Wallet?
The ability to add tickets to Google Wallet and Apple Wallet is currently part of a beta testing program and will be rolled out to a wider audience at the end of the beta testing phase.
In addition, this feature is not available on the iPad, only for the iPhone and iPod Touch.
Internal-only content. Don't copy and paste to anyone.
If the client is having trouble enabling QR code ticket scanning check-in, make sure they have the following:
- Check-in enabled in company Settings.
- The user needs to have the “Manage check-in options” permission under the Setup tab.
Adding tickets to Apple Wallet and Google Wallet
In order for an end customer to be able to add their ticket(s) to a Google Wallet or Apple Wallet, during the beta testing phase of this feature a flag will have to be enabled in the back end by FareHarbor Dev. Once the beta testing has ended, it will be available to all clients. Note that clients must have Enable ticket-scanning check-in permission enabled at the item level for each item that they want customers to be able to add tickets to their digital wallets.
The following are instructions on how a customer can add a ticket to a Google Wallet or Apple Wallet on a smartphone:
To add a ticket to Google Wallet using a smartphone:
- Click Go to tickets from the booking confirmation or confirmation email.
- Click the Add to Google Wallet button. Log in to your Google account if not already logged in.
- Click the Add button in the lower-right corner. A green checkmark confirms that the ticket has been added to your Google Wallet.
- Open your Google Wallet to view the ticket.
To add a ticket to Apple Wallet using a smartphone:
- Click Go to tickets from the booking confirmation or confirmation email.
- Click Add to Apple Wallet.
- Click Add in the top-right corner of the window to add the ticket to your Apple Wallet.
- Open your Apple Wallet to view the ticket.