Gateway Screen for Payments and Surveys
Sparkbooth's Gateway Screen feature can be used to take payments, conduct surveys, or require other input from your guests before starting a session or printing a photo layout. You will need to have a web server to display an HTML page in the screen to take the payment or perform other actions.
Configuration Options:
- Enable Gateway Screen: Check this to display the Gateway Screen.
- Before Starting: Displays the screen at the beginning of the session. If the payment or other action is successful, the guest will proceed to the session, and Sparkbooth will start taking photos. If the payment or action fails or is canceled, it will return to the starting screen.
- For Printing: Displays the screen before printing the photo layout. If the payment or action is successful, the photo layout will be printed. If the payment or action fails or is canceled, Sparkbooth skips the printing.
- Gateway Title: The text displayed at the top of the screen.
- Gateway Cancel: The text used for the cancel button label.
- Start URL: The URL displayed on the screen. You can pass several variables in the URL:
- {id}: A random value to uniquely identify the session.
- {booth}: The photo booth name set under Settings > Premium > Notifications to identify the specific booth.
- {prints}: The number of prints that will be printed if using the screen to take a payment before printing.
- {buying}: Can be "session" or "printing" to indicate the reason for the payment.
- Success URL: The URL the web page changes to if the payment or action is successful. When the page changes to this URL, Sparkbooth will start the session or print the photo layout.
- Failure URL: The URL the web page changes to if the payment or action fails. When the page changes to this URL, Sparkbooth will cancel the session or skip the printing.
- Cancel URL (optional): The URL Sparkbooth pings if the cancel button is pressed. Use this to inform the server to cancel the payment.
- URL Match: Specifies how the success and failure URLs are matched:
- Entire: The URLs must match from beginning to end.
- Beginning: The URLs must match the beginning.
- Any Part: The URLs can match any part.
Example Workflows:
Successful Payment:
Failed Payment:
Cancel Button Pressed:
Example Using Jotform Online Survey:
Here is an online survey created on Jotform. Use this survey to have guests answer questions before starting the photo booth.
Gateway Screen Settings:
- Start URL: https://form.jotform.com/92104092666153
- Success URL: https://submit.jotform.us/submit/92104092666153
- Leave the Failure and Cancel URL fields blank, as there is no way to exit the survey.