The Box Office app allows you to process in-person transactions quickly and efficiently, making it easy to accommodate walk-up attendees or last-minute sales. To get started with selling tickets on-site, you'll first need to create an App Key for your event.
An App Key links your Box Office to the correct ticketing page, telling the app which tickets, merchandise, and membership options to sell. This app key also specifies whether your staff are selling tickets, or whether you are offering the ability for attendees to self-checkout and purchase tickets on their own. In this article, we'll walk you through how to create and customize your app key to make the most of the TicketSpice Box Office app.
If you need to download the TicketSpice scanning app, you can do so here:
Note: The TicketSpice Box Office app is compatible with iPhones and iPads running on iOS 17.6 or higher.
The TicketSpice Box Office app is not available on Android devices.
Jump To...
Create a Staff Operated App Key
Before selling tickets on-site with Box Office, you’ll need to create and configure an app key. During setup, you’ll choose whether you want to use a staff-operated app or set up a self-checkout kiosk.
A Staff-Operated app key is designed for situations where your team is actively managing sales using the Box Office app. Staff can place orders on behalf of attendees, accept both cash and credit card payments, and access key settings freely within the app. This option is ideal for Box Office staff and any in-person sales handled by your team.
Pro Tip: The Box Office app and the Scanning app each require their own unique app key. The app keys for these apps are not interchangeable, and must be set up separately.
From the Pages screen, click the pencil icon on the page that you want to edit
Hover your mouse over the Onsite tab in the top menu bar
Select Box Office from the dropdown
Click Create App Key or New App Key
Enter a name for your App Key
Select the Staff Operated app key type
Customize your Box Office app settings
Ask for denomination breakout when starting and ending a session: This setting prompts staff to enter the quantity of each cash denomination. The system then automatically calculates the total starting and ending cash amounts. If disabled, staff are only asked to enter the total starting and ending cash amounts
Allow team to check in tickets after purchase: This setting lets staff check in tickets immediately after completing an order. If enabled, a "Check In" button appears on the order confirmation screen. If disabled, the Box Office prompts users to connect with the team for check in
Use New User Interface: This setting enables the new interface. This interface is recommended, and is required to use the NYC1 card readers
Use Current Day as Default Date for Ticket Orders (new user interface only): This setting automatically sets today's date as the default for orders. If disabled, staff must manually select a date for each new order. Note: This setting only applies to date-based event pages. This setting does not apply to Standard, Series of Events, or Reserved Seating pages
Require Attendee Email: This setting requires an email address for every order. If disabled, the email field is optional unless a membership is purchased
Auto Print Tickets and Receipt After Purchase: This setting automatically prints both tickets and receipts after each order is completed. If disabled, staff can manually select to print tickets, receipt, or both
Scope to Category: This setting limits the app key view to only display tickets within a selected ticket category. If disabled, all tickets are visible. Note: This setting is only available on the new user interface, and is only visible when your page is using ticket categories. This setting is not available on Reserved Seating pages
Use NYC1 Reader (Beta): This setting enables the NYC1 card readers for credit card processing on the Box Office. Note: This feature is only available on the new user interface and is currently limited to select customers. Reach out to our support team to request access to this feature
Click Create to save your settings
Create a Self-Checkout (Supervised) App Key
Before you can begin selling tickets on-site with Box Office, you’ll need to set up an app key. As part of this process, you’ll decide whether the app will be used by staff or set up for self-service use.
A Self-Checkout (Supervised) app key is designed for situations where attendees are purchasing tickets on their own using the Box Office app. In this mode, attendees can complete their orders independently and can only purchase tickets using a credit card. Access to app settings is restricted, preventing any changes unless the correct password is entered. This option is ideal for supervised self-service stations where you want to enable quick purchases while maintaining control over app settings.
Pro Tip: The Box Office app and the Scanning app each require their own unique app key. The app keys for these apps are not interchangeable, and must be set up separately.
From the Pages screen, click the pencil icon on the page that you want to edit
Hover your mouse over the Onsite tab in the top menu bar
Select Box Office from the dropdown
Click Create App Key or New App Key
Enter a name for your App Key
Select the Staff Operated app key type
Enter a password for your app key, if desired. This password is used to edit the app key settings or log out of the Box Office app. If you leave this password blank, the app key will be automatically added as the password
Customize your Box Office app settings
Use Current Day as Default Date for Ticket Orders: This setting automatically sets today's date as the default for orders. If disabled, attendees must manually select a date for each new order. Note: This setting only applies to date-based event pages. This setting does not apply to Standard, Series of Events, or Reserved Seating pages
Require Attendee Email: This setting requires an email address for every order. If disabled, the email field is optional unless a membership is purchased
Auto Print Tickets and Receipt After Purchase: This setting automatically prints both tickets and receipts after each order. If disabled, attendees can manually select to print tickets, receipt, or both
Scope to Category: This setting limits the app key view to only display tickets within a selected ticket category. If disabled, all tickets are visible. Note: This setting is only visible when your page is using ticket categories. This setting is not available on Reserved Seating pages
Use NYC1 Reader (Beta): This setting enables the NYC1 card readers for credit card processing on the Box Office. Note: This feature is currently limited to select customers. Reach out to our support team to request access to this feature
Click Create to save your settings
Set Up Your Ticketing Options for On-Site Sales
Before you begin selling tickets on-site using Box Office, it’s important to make sure your ticketing page is ready to go. This includes confirming that your ticket pricing is configured correctly for in-person sales and that your ticket levels are visible in the Box Office App.
From the Pages screen, click the pencil icon on the page that you want to edit
Scroll to the ticket block
Click Edit Ticket Information directly above the ticket block
Scroll to your ticket levels, and open your ticket level(s) to see more information
To add a different price for on-site ticket sales, enable the Box Office Price toggle. Then, enter the price you'd like to charge through Box Office, along with a fee if desired
Use the Visibility field to control where each ticket level appears. We recommend reviewing and confirming the correct visibility option is selected for each ticket level on your page
Everywhere - this option displays the ticket level both online and in the Box Office App
Online Only - this option displays the ticket level online, but not in the Box Office app
Box Office Only - this option displays the ticket level in the Box Office app, but not online
Click Done when you've customized your Box Office settings
Click Save Now in the upper-right corner of your page to save your changes. Click Publish to publish these changes to your live page
FAQs
How do I manage my app key?
How do I manage my app key?
From the Pages screen, click the pencil icon on the page that you want to edit
Hover your mouse over the Onsite tab in the top menu bar
Select Box Office from the dropdown
Find the app key you want to manage, and do any of the following
Click text me app key to text the app key to the phone number of your choice
The pencil icon allows you to edit the app key
The trash can icon allows you to delete the app key
Can I offer Pre-Registration as a payment method if I plan on accepting on-site sales through the Box Office App?
Can I offer Pre-Registration as a payment method if I plan on accepting on-site sales through the Box Office App?
No, right now, pre-registration is not compatible with the Box Office. When using the Box Office app, we recommend turning off the pre-registration feature on your page. This will ensure that you can accept Box Office transactions as expected. Here is how to turn off Pre-Registration as a payment method if needed.
From the Pages screen, click the pencil icon on the page for which you'd like to enable Pre-Registration
Scroll down to the Billing Information section
Hover your mouse over the Payment Method field, and click the pencil icon
Toggle Allow Pre Registration to Off
Click Done
Click Save Now in the upper-right corner of your page to save your changes. Click Publish to publish these changes to your live page
Can I use Box Office to sell tickets for my free event?
Can I use Box Office to sell tickets for my free event?
Right now, you can use Box Office to offer tickets for your free event. However, it's important to note that your billing must be enabled. If your billing is disabled, the Box Office will not work.
If your billing is disabled, we recommend enabling the billing section, and making sure that all of your fields are set to be free if you don't want to charge your attendees.
Here is how to enable your billing on your page if you are hosting a free event and want to use Box Office:
From the Pages screen, click the pencil icon on the page that you want to edit
Hover over the Settings tab
Select Basic Setup from the dropdown
Deselect the Disable Billing checkbox
Will my actions work on the Box Office App?
Will my actions work on the Box Office App?
Generally, actions work on the Box Office App. Actions to change the price, dynamically adjust the capacity of a ticket level, show and hide specific fields, set a value, select a specific option, and dynamically require and not require certain fields work on the Box Office App.
If I close ticketing on the website for my event, can I still sell tickets at the venue using the Box Office app?
If I close ticketing on the website for my event, can I still sell tickets at the venue using the Box Office app?
Yes, you can close online ticketing for your event, but accept Box Office transactions. The Box Office app works even when your online ticketing page is closed.












