Skip to main content

Create an App Key to Sell Tickets On-Site Using the Box Office App

The TicketSpice Box Office app requires you to enter an app key to sell tickets on-site at your event

Written by Maddy
Updated today

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?

  • 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?

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?

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?

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?

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.

Did this answer your question?