Setting up the Box Office App

The Filmbot Box Office App offers a way for staff to quickly issue comp and cash tickets, and can be used from any browser.

Initial Setup

1. Navigate to Users > Your Profile, scroll to the bottom of the page, and set a Box Office Pin for yourself (ensure it doesn't start with the number 0).
2. Navigate to Sales > Box Office (if you don't have this menu item, contact us to enable it)
3. The first time you use the app, you will need to follow the on-screen instructions. Note, most festivals can skip the ticket printing instructions.
4. Once you have gone through the setup once, the next time you use the app in the same browser, the settings will be retained, and you can just click Launch Box Office
5. If the app does not fully fit on your screen you can use cmd +/- (Mac) or ctrl +/- (Windows) to adjust the zoom until it fits.

Connecting a Stripe Reader

If you have a compatible BBPOS WisePOS™ E reader purchased from Stripe, you can connect it to the Box Office app in order to accept payments in person. The reader can accept chip cards, and contactless payments, including Apple Pay and Google Pay.

Note that in order to use the Stripe reader with the Box Office app, the app and the reader need to either be on the same local network via ethernet, or on the same WPA2 WiFi network.  Your WiFi network must use WPA-Personal or WPA2-Personal encryption and be password protected. Non-password-protected networks or enterprise networks are not supported.

1. When you power on the reader, you'll first need to connect it to the internet. 
   1. If you are not prompted to choose a WiFi network at startup, swipe from the left edge on the home screen, and then tap on Settings. Enter the pin 07139. Then choose Network, select your WiFi network, and enter the WiFi password.
2. Before the reader can be used with your Stripe account, you'll need to register the reader in your account. 
   1. Log into your Stripe account and navigate to the Terminal section. 
   2. Under the "Locations" section, click the [+ New] button, and fill out your organization's name and address. 
   3. Once you save the Location, click on it. Under the Readers section, click [+ New].
   4. From the home screen of the reader, swipe left and tap Settings. Choose "Generate pairing code". 
   5. Enter the displayed code in the "Register reader" window that's showing on the Stripe dashboard. Also enter a descriptive name for the reader (i.e. "Box Office"). Click Save.
   6. Optional step: From the Locations page in your Stripe dashboard, choose the "Reader Settings" button in the top right corner, and upload a 720W X 1280H image to show on the home screen of the reader (i.e. your festival's logo).
3. Now that the reader is registered in your Stripe account, you can use it with the Box Office app.
   1. Ensure the device where you're running the app and the reader, are on the same network. Your WiFi network must use WPA-Personal or WPA2-Personal encryption and be password protected.
   2. While you are on the login screen for the Box Office app, tap the gear in the bottom right corner, and enter the settings pin 2112.
   3. Ensure that your API_ROOT and API_DEVICE_NAME, and API_KEY are correctly entered and pointing at your current festival site. If those settings are not entered, you can copy and paste them from the page in your dashboard located at Sales > Box Office.
   4. Save the settings with only API_ROOT and API_DEVICE_NAME entered. Ensure you can log into the app with your personal pin number. If you can, tap on the menu at the top right corner and go to Settings.
   5. Scroll down to PAYMENT_GATEWAY and choose Stripe. Save the settings.
   6. Dismiss any error related to the Stripe reader. Tap the gear again and log in with pin 2112
   7. Tap the Select Reader button and choose the reader label you set up earlier in your Stripe account. That's it!

Issuing tickets

1. Launch the Box Office and log in with your Box Office Pin.
2. In the top left corner of the app, tap on the date, and choose the date for the showtime to which you want to issue a ticket.
3. Tap on the show.
4. Tap on the showtime.
5. Optionally increase the quantity, and tap on the ticket type.
6. Optionally apply a discount code.
7. Tap Cash and then Done.
8. Tap Email and enter the recipient's email address. They will receive a new order confirmation email with their tickets.