---
title: "Event Settings: Ticket Scanner"
description: "Each event in TicketsCandy has its own ticket scanner settings that allow you to connect the TicketsCandy Scanner App and control when tickets can be used for check-in. To access these settings: 1. Open your **Event Dashboard**. 2. Click **Event…"
url: "https://help.ticketscandy.com/kb/event-settings-ticket-scanner/"
updated: "2026-08-28"
category: Event Setup
---

# Event Settings: Ticket Scanner

Each event in TicketsCandy has its own ticket scanner settings that allow you to connect the TicketsCandy Scanner App and control when tickets can be used for check-in.

To access these settings:

1. Open your **Event Dashboard**.
2. Click **Event Settings** in the navigation menu.
3. Select **Ticket Scanner**.

Customers automatically receive an e-ticket with a QR code after completing their purchase. You can scan this QR code at the event using the TicketsCandy Scanner App.

 

## Download the Scanner App

The **TicketsCandy Scanner App** is available for both iOS and Android devices.

- [Download for iOS](https://apps.apple.com/us/app/ticketscandy-scanner/id1552115336)
- [Download for Android](https://play.google.com/store/apps/details?id=com.ticketscandy.ticketscanner)

After installing the app, you will need to connect it to your TicketsCandy account or event using one of the API keys available on this page.

 

## Ticket Scanner API

The **Ticket Scanner** page provides two types of API keys that can be used to connect the scanner app.

### Event API Key

The **Event API Key** connects the scanner app to one specific event.

Use this key when:

- The device should scan tickets for only one event.
- Different staff members or devices are assigned to different events.

### Global API Key

The **Global API Key** connects the scanner app to all events within your account.

Use this key if the same device needs to scan tickets across multiple events without reconnecting to each event separately.

 

## Scanner App Settings

The **Scanner App Settings** allow you to control when tickets become valid and when they stop being valid for scanning.

These settings are based on the ticket's booking period and can help prevent customers from checking in too early or too late.

### Ticket Scan Start Time

The **Ticket Scan Start Time** controls how early a ticket can be scanned before its booking period begins.

You can choose from:

- **Valid Anytime Before Booking Period** - The ticket can be scanned at any time before the booking period begins without a time restriction.
- **At Booking Period Start** - The ticket becomes valid when the booking period begins. If it is scanned earlier, the scanner app will show that the ticket is not yet valid.
- **Custom Time Before Booking Period** - Enter a specific number of minutes before the booking period when the ticket should become valid for scanning.

For example, you could allow customers to check in starting 30 minutes before their scheduled booking time.

### Ticket Scan End Time

The **Ticket Scan End Time** controls how long a ticket remains valid after its booking period ends.

You can choose from:

- **Valid Indefinitely After Booking Period** - The ticket remains valid for scanning after the booking period ends without a time limit.
- **At Booking Period End** - The ticket stops being valid as soon as the booking period ends. If scanned afterward, the scanner app will show an error.
- **Custom Time After Booking Period** - Enter a specific number of minutes after the booking period ends during which the ticket can still be scanned.

For example, you could allow customers to check in up to 15 minutes after their scheduled booking period ends.
